/[svn]/gigedit/trunk/doc/quickstart/from_scratch.sgm
ViewVC logotype

Contents of /gigedit/trunk/doc/quickstart/from_scratch.sgm

Parent Directory Parent Directory | Revision Log Revision Log


Revision 1238 - (show annotations) (download) (as text)
Sat Jun 16 14:30:29 2007 UTC (16 years, 9 months ago) by persson
File MIME type: text/x-sgml
File size: 5196 byte(s)
* minor cleanup of the quickstart document: VCO -> VCF, removed
  trademark markers, GigEdit -> Gigedit. XML validates now.
* Use http URI for the DocBook stylesheet.

1 <chapter id="start"><title>Starting From Scratch</title>
2 <section id="start_gui"><title>The Graphical User Interface</title>
3
4 <para>
5 Now you have <application>gigedit</application> running and can see
6 something like the following screenshot. On the left you see an
7 empty white field, on the right a set of tabbed dialogs and below
8 all that some piano keys. At this early stage everything is disabled,
9 except the topmost menu.
10 </para>
11
12 <figure id="shot_whole_app"><title>Screenshot of the whole application</title>
13 <screenshot><mediaobject><imageobject>
14 <imagedata fileref="shot_whole_app.png" format="PNG"/>
15 </imageobject></mediaobject></screenshot>
16 </figure>
17
18 <para>
19 In the next paragraphs you will add a few samples and stuff to create
20 a totally new GIG file. If you're interested in some technical background
21 and help on the terms used here, refere to <xref linkend="gig" />.
22 </para>
23 </section>
24
25 <section id="start_region"><title>Creating a Region</title>
26 <para>
27 To start with a new file, we need a new file. Choose
28 <menuchoice>
29 <guimenu>File</guimenu>
30 <guimenuitem>New</guimenuitem>
31 </menuchoice>
32 and the only thing changing is an entry <emphasis>Default Group</emphasis>
33 on the previously white field on the left.
34 </para>
35
36 <figure id="shot_default_group"><title>Screenshot of the new default group</title>
37 <screenshot><mediaobject><imageobject>
38 <imagedata fileref="shot_default_group.png" format="PNG"/>
39 </imageobject></mediaobject></screenshot>
40 </figure>
41
42 <para>
43 Now there's a lot more possible on the gui and lacking such a fine
44 quickstart I had to figure it out myself: Right click somewhere
45 in the gray area above the piano keys. There's a small gray band
46 and you'll get the following popup menu (Says: <emphasis>Add</emphasis>,
47 the red arrows mark the area's width where you can cause this
48 popup to pop up):
49 </para>
50
51 <figure id="shot_new_dimension"><title>Screenshot of the new dimension action</title>
52 <screenshot><mediaobject><imageobject>
53 <imagedata fileref="shot_new_dimension.png" format="PNG"/>
54 </imageobject></mediaobject></screenshot>
55 </figure>
56
57 <para>
58 If you click this action a small rectangle occurs and some of the input
59 fields and sliders on the tab <emphasis>EG1</emphasis> are enabled. By
60 moving the curser above the rectangle's left and right border you can
61 resize it and define the region's width, e.g. it's lowest and highest
62 key. Now you have a region and all you need is a sample, to play
63 when pressing the region's keys.
64 </para>
65 <tip><simpara>
66 Until the alpha version it was necessary to do it that way around
67 instead of first adding a sample and then a region. It caused some
68 additional dimensions to show up, which could not be removed.
69 </simpara></tip>
70 </section>
71
72 <section id="start_sample"><title>Adding a sample</title>
73 <para>
74 Hopefully you have some WAV samples somewhere available on
75 your computer. If not: get some from your microphone, the
76 internet or a friend who knows, what a WAV is ;-). Select
77 the entry <guimenuitem>Default Group</guimenuitem> on the left
78 and right click it (or right click it twice, so that <guimenuitem>
79 Add Sample(s)</guimenuitem> is enabled). And click
80 <guimenuitem>Add Sample(s)</guimenuitem>. Browse with the
81 file chooser through your harddisk and select a wav sample.
82 If you did so, your Default Group will look like this (maybe
83 you need to open the tree like structure by clicking the
84 triangle in front).
85 </para>
86
87 <figure id="shot_add_sample"><title>Screenshot after adding the sample</title>
88 <screenshot><mediaobject><imageobject>
89 <imagedata fileref="shot_add_sample.png" format="PNG"/>
90 </imageobject></mediaobject></screenshot>
91 </figure>
92
93 <para>
94 On the left you see the popup menu, the added sample below, on the
95 right side the enabled input elements and below all that the
96 piano key roll with a blueish rectangle from C2 to C3. The
97 input field <emphasis>Sample</emphasis> says <constant>NULL</constant>.
98 That means our region has no sample assigned. I tried to enter
99 the sample's name, but that did not work. Drag and Drop is
100 the key: Drag the added sample onto the input field
101 <emphasis>Sample</emphasis> and the cursor changes. Drop
102 it and you'll see the name inside the field.
103 </para>
104 </section>
105
106 <section id="start_where_to_go"><title>Where to go from here?</title>
107 <para>
108 Weeeee, no you can save your changes with <guimenuitem>Save As</guimenuitem>.
109 When I wrote this quickstart the <guimenuitem>Save</guimenuitem> action
110 did not show a file name dialog but an error. So save it and
111 play with it. Load it into your sampler, perferrably
112 <application>LinuxSampler</application> and hit the keys. But only
113 in the region's range you'll here some noise...your sample.
114 </para>
115 <para>
116 If it did not work: check your equipment, hard- and software, maybe
117 use some tools like <command>gigdump</command> or <command>gigextract</command>
118 to verify, that the sample(s) are inside the gig file and it's structure
119 is correct. Otherwise join the <application>LinuxSampler</application>'s
120 mailing list (<ulink url="http://www.linuxsampler.org/developers.html" />).
121 </para>
122 </section>
123 </chapter>

  ViewVC Help
Powered by ViewVC