And now the html files - Alex
[terminatorX.git] / doc / turntablecontrols.html
1 <HTML
2 ><HEAD
3 ><TITLE
4 >Turntable Controls</TITLE
5 ><META
6 NAME="GENERATOR"
7 CONTENT="Modular DocBook HTML Stylesheet Version 1.59"><LINK
8 REL="HOME"
9 TITLE="terminatorX - Manual"
10 HREF="index.html"><LINK
11 REL="UP"
12 TITLE="Operation"
13 HREF="operation.html"><LINK
14 REL="PREVIOUS"
15 TITLE="Operation"
16 HREF="operation.html"><LINK
17 REL="NEXT"
18 TITLE="Synchronization"
19 HREF="synchronization.html"></HEAD
20 ><BODY
21 CLASS="SECTION"
22 BGCOLOR="#FFFFFF"
23 TEXT="#000000"
24 LINK="#0000FF"
25 VLINK="#840084"
26 ALINK="#0000FF"
27 ><DIV
28 CLASS="NAVHEADER"
29 ><TABLE
30 WIDTH="100%"
31 BORDER="0"
32 CELLPADDING="0"
33 CELLSPACING="0"
34 ><TR
35 ><TH
36 COLSPAN="3"
37 ALIGN="center"
38 >terminatorX - Manual</TH
39 ></TR
40 ><TR
41 ><TD
42 WIDTH="10%"
43 ALIGN="left"
44 VALIGN="bottom"
45 ><A
46 HREF="operation.html"
47 >Prev</A
48 ></TD
49 ><TD
50 WIDTH="80%"
51 ALIGN="center"
52 VALIGN="bottom"
53 >Chapter 2. Operation</TD
54 ><TD
55 WIDTH="10%"
56 ALIGN="right"
57 VALIGN="bottom"
58 ><A
59 HREF="synchronization.html"
60 >Next</A
61 ></TD
62 ></TR
63 ></TABLE
64 ><HR
65 ALIGN="LEFT"
66 WIDTH="100%"></DIV
67 ><DIV
68 CLASS="SECTION"
69 ><H1
70 CLASS="SECTION"
71 ><A
72 NAME="TURNTABLECONTROLS"
73 >2.2. Turntable Controls</A
74 ></H1
75 ><P
76 >The turntable GUI contains multiple controls and the realtime displays for each turntable. To save some space on your desktop and to give terminatorX the traditional audio-application look, terminatorX features &quot;knob&quot;-widgets. These widgets work pretty straight-forward: click somewhere within the widget and keep the left mouse-button pressed. Now move the mouse up and down or left and right to increase/decrease the control's value. All those widget are coupled with a text entry field since 3.70, which allows you to enter values directly.</P
77 ><P
78 >A turntable is visualized by two panels: the controls and the audio-display. These are no longer combined for better layout management.</P
79 ><DIV
80 CLASS="SECTION"
81 ><H2
82 CLASS="SECTION"
83 ><A
84 NAME="AEN184"
85 >2.2.1. Turntable Audio-Display</A
86 ></H2
87 ><P
88 >The complete audio-file loaded into a turntable is displayed in the green-on-black audio-widget. When playing terminatorX will indicate the current position within the sample with a red cursor (a blue/green cursor indicates the turntable is muted).</P
89 ><P
90 >Additionaly there are some controls above the audio-display:</P
91 ><P
92 ></P
93 ><UL
94 ><LI
95 ><P
96 ><I
97 CLASS="EMPHASIS"
98 >Turntable Label</I
99 ></P
100 ><P
101 >This label indicates the turntables name. The name can be set via the control panel</P
102 ></LI
103 ><LI
104 ><P
105 ><I
106 CLASS="EMPHASIS"
107 >File Button</I
108 ></P
109 ><P
110 >This button holds the name of the audio-file currently loaded. When there's no sample loaded the button will read &quot;NONE&quot; to indicate the current status. Click on this button to select a file to load from a file-selection-dialog. Alternatively you can drag'n'drop files over the audio-display to load them.</P
111 ></LI
112 ><LI
113 ><P
114 ><I
115 CLASS="EMPHASIS"
116 >Edit Button</I
117 ></P
118 ><P
119 >This button will run the external audiofile-editor (that can be specified via the options-dialog) with the current audio-file as a parameter. Click the reload button after editing and saving the file.</P
120 ></LI
121 ><LI
122 ><P
123 ><I
124 CLASS="EMPHASIS"
125 >Reload Button</I
126 ></P
127 ><P
128 >Click this button to re-read the audio-file.</P
129 ></LI
130 ><LI
131 ><P
132 ><I
133 CLASS="EMPHASIS"
134 >X/Y Mapping Selection</I
135 ></P
136 ><P
137 >terminatorX allows mapping misc parameters to the mouse axis of your choice. These mappings will be activated in grab mode. Since Version 3.70 this mappings are no longer hardcoded to built-in controls but available for all parameters that qualify as &quot;mappable&quot;. Note that this includes plugins' controls as well.</P
138 ></LI
139 ></UL
140 ></DIV
141 ><DIV
142 CLASS="SECTION"
143 ><H2
144 CLASS="SECTION"
145 ><A
146 NAME="AEN209"
147 >2.2.2. Turntable Controls</A
148 ></H2
149 ><P
150 >These controls are now grouped within functional panels. The number of panel depends on the number of plugins loaded. terminatorX allows hiding the controls not required via the yellow arrow button. To un-hide just click the button again. The first panels are the standard controls for a turntable, then follows the dynamic FX-section and below that follow the pitch and volume controls.</P
151 ><DIV
152 CLASS="SECTION"
153 ><H3
154 CLASS="SECTION"
155 ><A
156 NAME="AEN212"
157 >2.2.2.1. Main Panel</A
158 ></H3
159 ><P
160 ></P
161 ><UL
162 ><LI
163 ><P
164 ><I
165 CLASS="EMPHASIS"
166 >Name Field</I
167 ></P
168 ><P
169 >The main panel features a text entry field that allows setting a name for the related turntable. The Labels for the controls and the audio-display will update accordingly.</P
170 ></LI
171 ><LI
172 ><P
173 ><I
174 CLASS="EMPHASIS"
175 >Delete Button</I
176 ></P
177 ><P
178 >Pressing this button remove the tunrtable from the current setup. Note that all sequencer events recorded for this turntable will be erased, too.</P
179 ></LI
180 ></UL
181 ></DIV
182 ><DIV
183 CLASS="SECTION"
184 ><H3
185 CLASS="SECTION"
186 ><A
187 NAME="AEN223"
188 >2.2.2.2. Trigger Panel</A
189 ></H3
190 ><P
191 >The trigger panel holds all controls related to triggering the turntable. For more details on synchronization see <A
192 HREF="synchronization.html"
193 >Section 2.3</A
194 > (synchronization).</P
195 ><P
196 ></P
197 ><UL
198 ><LI
199 ><P
200 ><I
201 CLASS="EMPHASIS"
202 >Trigger! Button</I
203 ></P
204 ><P
205 >Pressing this button triggers the turntable now. With the audio engine enabled this will cause the turntable to start playing back audio from the beginning of the sample.</P
206 ></LI
207 ><LI
208 ><P
209 ><I
210 CLASS="EMPHASIS"
211 >Stop Button</I
212 ></P
213 ><P
214 >Guess what, this stops this turntable's audio-playback.</P
215 ></LI
216 ><LI
217 ><P
218 ><I
219 CLASS="EMPHASIS"
220 >Master Button</I
221 ></P
222 ><P
223 >Enabling this button makes this turntable the <I
224 CLASS="EMPHASIS"
225 >sync-master</I
226 >. Note that only <I
227 CLASS="EMPHASIS"
228 >one</I
229 > turntable at a time can be the sync-master.</P
230 ></LI
231 ><LI
232 ><P
233 ><I
234 CLASS="EMPHASIS"
235 >Client Button</I
236 ></P
237 ><P
238 >This button marks the turntable as <I
239 CLASS="EMPHASIS"
240 >sync-client</I
241 >, so it will be triggerd with the master automatically.</P
242 ></LI
243 ><LI
244 ><P
245 ><I
246 CLASS="EMPHASIS"
247 >Sync-Cycles Selection</I
248 ></P
249 ><P
250 >The sync cycles determine how often a sync-client should be triggered. With a setting of zero the sync-client will be (re-)triggered with <I
251 CLASS="EMPHASIS"
252 >every</I
253 > trigger of the sync-master. A setting of 1 will (re-)trigger the client every <I
254 CLASS="EMPHASIS"
255 >second</I
256 > master-triger and so on.</P
257 ></LI
258 ></UL
259 ></DIV
260 ></DIV
261 ><DIV
262 CLASS="SECTION"
263 ><H2
264 CLASS="SECTION"
265 ><A
266 NAME="AEN253"
267 >2.2.3. The Effect Queue</A
268 ></H2
269 ><P
270 >With release 3.70 the effects are no longer hardcoded into the turntable. The effects are now arranged within an per-turntable effect-queue. The effect sequence is configurable by the user. To move an effect to higher position within the queue, press the <I
271 CLASS="EMPHASIS"
272 >blue upward arrow button</I
273 >. This will cause the effect to be renderd <I
274 CLASS="EMPHASIS"
275 >before</I
276 > the following effects. The <I
277 CLASS="EMPHASIS"
278 >blue downward arrow button</I
279 > will move the effect down by one position. It will then be rendered <I
280 CLASS="EMPHASIS"
281 >after</I
282 > the preceding effects.</P
283 ><P
284 >There are two types of effects: the traditional built-in effects (Lowpass and Echo) and LADSPA plugins. The built-in effects are always available and cannot be removed (but disabled). There can be only one instance of a built-in effect. The LADSPA plugins on the other hand may be intanciated multiple times and can be removed from the effect queue. Press the <I
285 CLASS="EMPHASIS"
286 >blue cross button</I
287 > to achieve this.</P
288 ><P
289 >For more information on a LADSPA plugin, press it's panel's label and a small info box will pop up.</P
290 ><P
291 ></P
292 ><UL
293 ><LI
294 ><P
295 ><I
296 CLASS="EMPHASIS"
297 >FX Button</I
298 ></P
299 ><P
300 >Press this button to load a LADSPA plugin into the effect queue of the turntable. A menu holding the available (terminatorX-&quot;compatible&quot;) LADSPA-plugins will pop up. The plugins are grouped within submenus according to the modules the plugins are contained in. Simply select the plugin you want to load from this menu and a panel for it will pop up at the end of the effect queue.</P
301 ><P
302 >Note that due to the wide parameter ranges some LADSPA plugins have they sometimes might be hard to control with the knob widget. In these cases you might want to use the text field to enter values. For more details on Plugins see <A
303 HREF="ladspaplugins.html"
304 >Section 2.7</A
305 > (LASDPA).</P
306 ></LI
307 ></UL
308 ></DIV
309 ><DIV
310 CLASS="SECTION"
311 ><H2
312 CLASS="SECTION"
313 ><A
314 NAME="AEN270"
315 >2.2.4. Lowpass Panel</A
316 ></H2
317 ><P
318 >terminatorX features a buitlin resonating lowpass filter that can be configured with this panel.</P
319 ><P
320 ></P
321 ><UL
322 ><LI
323 ><P
324 ><I
325 CLASS="EMPHASIS"
326 >Enable Button</I
327 ></P
328 ><P
329 >Activating this button will enable the lowpass filter for this turntable.</P
330 ></LI
331 ><LI
332 ><P
333 ><I
334 CLASS="EMPHASIS"
335 >Input Gain Control</I
336 ></P
337 ><P
338 >With this parameter you can amplify the signal that goes into the lowpass filter if required.</P
339 ></LI
340 ><LI
341 ><P
342 ><I
343 CLASS="EMPHASIS"
344 >Frequency Control</I
345 ></P
346 ><P
347 >Use this parameter to set the cutoff frequency for the lowpass filter. Minimum: 0=0Hz, Maximum: 1=22KHz.</P
348 ></LI
349 ><LI
350 ><P
351 ><I
352 CLASS="EMPHASIS"
353 >Resonance</I
354 ></P
355 ><P
356 >Use this parameter to set the resonance-value. Minimum: 0=no resonance, Maximum: 1=max resonance.</P
357 ></LI
358 ></UL
359 ></DIV
360 ><DIV
361 CLASS="SECTION"
362 ><H2
363 CLASS="SECTION"
364 ><A
365 NAME="AEN290"
366 >2.2.5. Echo Panel</A
367 ></H2
368 ><P
369 >Additionaly terminatorX features a built-in echo effect. It can be configured with this panel.</P
370 ><P
371 ></P
372 ><UL
373 ><LI
374 ><P
375 ><I
376 CLASS="EMPHASIS"
377 >Enable Button</I
378 ></P
379 ><P
380 >Activating this button will enable the echo effect for this turntable.</P
381 ></LI
382 ><LI
383 ><P
384 ><I
385 CLASS="EMPHASIS"
386 >Duration Control</I
387 ></P
388 ><P
389 >Use this parameter to set the length of the echo. The duration parameter scales to the actual sample length: so if you set it to 0.5 you will hear the echo when the red playback cursor is half way  through the sample. This is true for samples that are shorter than terminatorX' maximum echo buffer size only.</P
390 ></LI
391 ><LI
392 ><P
393 ><I
394 CLASS="EMPHASIS"
395 >Feedback Control</I
396 ></P
397 ><P
398 >Set the echo's feedback amount with this parameter.</P
399 ></LI
400 ></UL
401 ></DIV
402 ></DIV
403 ><DIV
404 CLASS="NAVFOOTER"
405 ><HR
406 ALIGN="LEFT"
407 WIDTH="100%"><TABLE
408 WIDTH="100%"
409 BORDER="0"
410 CELLPADDING="0"
411 CELLSPACING="0"
412 ><TR
413 ><TD
414 WIDTH="33%"
415 ALIGN="left"
416 VALIGN="top"
417 ><A
418 HREF="operation.html"
419 >Prev</A
420 ></TD
421 ><TD
422 WIDTH="34%"
423 ALIGN="center"
424 VALIGN="top"
425 ><A
426 HREF="index.html"
427 >Home</A
428 ></TD
429 ><TD
430 WIDTH="33%"
431 ALIGN="right"
432 VALIGN="top"
433 ><A
434 HREF="synchronization.html"
435 >Next</A
436 ></TD
437 ></TR
438 ><TR
439 ><TD
440 WIDTH="33%"
441 ALIGN="left"
442 VALIGN="top"
443 >Operation</TD
444 ><TD
445 WIDTH="34%"
446 ALIGN="center"
447 VALIGN="top"
448 ><A
449 HREF="operation.html"
450 >Up</A
451 ></TD
452 ><TD
453 WIDTH="33%"
454 ALIGN="right"
455 VALIGN="top"
456 >Synchronization</TD
457 ></TR
458 ></TABLE
459 ></DIV
460 ></BODY
461 ></HTML
462 >