Merge 28-yelp-tools.patch
[terminatorX.git] / help / C / index.docbook
1 <?xml version='1.0'?>
2 <!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd" [
3           <!ENTITY version "4.00">
4           <!ENTITY date "2016-06-17">
5 ]>
6 <article id="index" lang="en">
7
8   <articleinfo>
9         <abstract role="description"><para>terminatorX is a realtime audio synthesizer that allows you
10       to "scratch" on digitally sampled audio data (*.wav, *.au, *.ogg,
11       *.mp3, etc.) the way hiphop-DJs scratch on vinyl records.</para></abstract>
12
13     <title>terminatorX - Manual</title>
14
15     <author role="maintainer"><firstname>Alexander</firstname><surname>König</surname></author>
16
17                 <copyright>
18                         <year>1999</year>
19                         <year>2000</year>
20                         <year>2001</year>
21                         <year>2002</year>
22                         <year>2003</year>
23                         <year>2004</year>
24                         <year>2005</year>
25                         <year>2006</year>
26                         <year>2014</year>
27                         <year>2016</year>
28             <holder role="mailto:alex@lisas.de">Alexander König</holder>
29           </copyright>
30     <revhistory>
31         <revision>
32         <revnumber>terminatorX Manual &version;</revnumber>
33         <date>&date;</date>
34       </revision>
35     </revhistory>
36     <releaseinfo>Version &version;</releaseinfo>
37
38     <legalnotice id="legalnotice">
39
40       <para>Permission is granted to copy, distribute and/or modify 
41       this document under the terms of the GNU Free Documentation 
42       License (GFDL), Version 1.1 or any later version published by the 
43       Free Software Foundation with no Invariant Sections, no 
44       Front-Cover Texts, and no Back-Cover Texts. You can find a copy 
45       of the GFDL at this <ulink type="help" url="help:fdl">
46       link</ulink> or in the file COPYING-DOCS distributed with this 
47       manual.</para>
48
49       <para>Many of the names used by companies to distinguish their 
50       products and services are claimed as trademarks. Where those 
51       names appear in any ScrollKeeper documentation, and the members 
52       of the ScrollKeeper Project are made aware of those trademarks, 
53       then the names are in capital letters or initial capital 
54       letters.</para>
55
56       <para>
57
58         DOCUMENT AND MODIFIED VERSIONS OF THE DOCUMENT ARE PROVIDED 
59         UNDER THE TERMS OF THE GNU FREE DOCUMENTATION LICENSE WITH THE 
60         FURTHER UNDERSTANDING THAT:
61         <orderedlist>
62
63           <listitem>
64
65             <para>DOCUMENT IS PROVIDED ON AN "AS IS" BASIS, WITHOUT 
66             WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, 
67             INCLUDING, WITHOUT LIMITATION, WARRANTIES THAT THE DOCUMENT 
68             OR MODIFIED VERSION OF THE DOCUMENT IS FREE OF DEFECTS 
69             MERCHANTABLE, FIT FOR A PARTICULAR PURPOSE OR 
70             NON-INFRINGING. THE ENTIRE RISK AS TO THE QUALITY, 
71             ACCURACY, AND PERFORMANCE OF THE DOCUMENT OR MODIFIED 
72             VERSION OF THE DOCUMENT IS WITH YOU. SHOULD ANY DOCUMENT OR 
73             MODIFIED VERSION PROVE DEFECTIVE IN ANY RESPECT, YOU (NOT 
74             THE INITIAL WRITER, AUTHOR OR ANY CONTRIBUTOR) ASSUME THE 
75             COST OF ANY NECESSARY SERVICING, REPAIR OR CORRECTION. THIS 
76             DISCLAIMER OF WARRANTY CONSTITUTES AN ESSENTIAL PART OF 
77             THIS LICENSE. NO USE OF ANY DOCUMENT OR MODIFIED VERSION OF 
78             THE DOCUMENT IS AUTHORIZED HEREUNDER EXCEPT UNDER THIS 
79             DISCLAIMER; AND</para>
80
81           </listitem>
82
83           <listitem>
84
85             <para>UNDER NO CIRCUMSTANCES AND UNDER NO LEGAL THEORY, 
86             WHETHER IN TORT (INCLUDING NEGLIGENCE), CONTRACT, OR 
87             OTHERWISE, SHALL THE AUTHOR, INITIAL WRITER, ANY 
88             CONTRIBUTOR, OR ANY DISTRIBUTOR OF THE DOCUMENT OR MODIFIED 
89             VERSION OF THE DOCUMENT, OR ANY SUPPLIER OF ANY OF SUCH 
90             PARTIES, BE LIABLE TO ANY PERSON FOR ANY DIRECT, INDIRECT, 
91             SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES OF ANY 
92             CHARACTER INCLUDING, WITHOUT LIMITATION, DAMAGES FOR LOSS 
93             OF GOODWILL, WORK STOPPAGE, COMPUTER FAILURE OR 
94             MALFUNCTION, OR ANY AND ALL OTHER DAMAGES OR LOSSES ARISING 
95             OUT OF OR RELATING TO USE OF THE DOCUMENT AND MODIFIED 
96             VERSIONS OF THE DOCUMENT, EVEN IF SUCH PARTY SHALL HAVE 
97             BEEN INFORMED OF THE POSSIBILITY OF SUCH DAMAGES.</para>
98
99           </listitem>
100
101         </orderedlist>
102
103       </para>
104
105     </legalnotice>
106
107   </articleinfo>
108
109   <sect1 id="INTRODUCTION">
110
111     <title>Introduction</title>
112
113     <sect2 id="WHATITIS">
114
115       <title>What it is</title>
116
117       <para>terminatorX is a realtime audio synthesizer that allows you 
118       to "scratch" on digitally sampled audio data (*.wav, *.au, *.ogg, 
119       *.mp3, etc.) the way hiphop-DJs scratch on vinyl records. It 
120       features multiple turntables, realtime effects (buit-in as well 
121       as <ulink url="http://www.ladspa.org">LADSPA</ulink> plugin 
122       effects), a sequencer and MIDI interface - all accessible through 
123       an easy-to-use gtk+ GUI.</para>
124
125       <para>This is software may have 
126       <ulink url="http://terminatorX.org/bugs.html">bugs</ulink> please 
127       help fixing them. See <xref linkend="CONTACT"/>. Please read this 
128       manual and visit the <ulink url="http://terminatorX.org">
129       homepage</ulink>.</para>
130
131     </sect2>
132
133     <sect2 id="QUICKSTART">
134
135       <title>Quickstart</title>
136
137       <para>Try the following steps:</para>
138
139       <orderedlist>
140
141         <listitem>
142
143           <para>If you don't have <application>LADSPA</application> 
144           (Linux Audio Developer's Simple Plugin API) installed, go and 
145           get it from the <ulink url="http://www.ladspa.org">
146           LADSPA-homepage</ulink> and install the SDK. terminatorX 
147           requires <filename>ladspa.h</filename>.</para>
148
149         </listitem>
150
151         <listitem>
152
153           <para>Install terminatorX (see <filename>INSTALL</filename> 
154           file)</para>
155
156         </listitem>
157
158         <listitem>
159
160           <para>If you want to use the 
161           <ulink url="http://jackit.sourceforge.net">JACK</ulink> 
162           backend run jackd before starting terminatorX.</para>
163
164         </listitem>
165
166         <listitem>
167
168           <para>Run terminatorX</para>
169
170         </listitem>
171
172         <listitem>
173
174           <para>Setup Audio Output via 
175           <emphasis>Options/Preferences</emphasis>.</para>
176
177         </listitem>
178
179         <listitem>
180
181           <para>Load an audiofile into the available turntable (you can 
182           add more turntables if you want) (Hint: Click on the button 
183           that holds "NONE" to load an audiofile, or drop one over the 
184           audiofile display from your GNOME filemanager.</para>
185
186         </listitem>
187
188         <listitem>
189
190           <para>Load a LADSPA plugin of your choice by clicking the 
191           turntable's <emphasis>FX</emphasis> button and enable 
192           it.</para>
193
194         </listitem>
195
196         <listitem>
197
198           <para>Click on the "Audio Engine"-button to start 
199           playback.</para>
200
201         </listitem>
202
203         <listitem>
204
205           <para>Click on the "Mouse-Grab"-button to enter grab mode. 
206           The turntable with the red border has the input focus.</para>
207
208         </listitem>
209
210         <listitem>
211
212           <para>Press <keycap>SPACE</keycap> or left mouse button to 
213           scratch.</para>
214
215         </listitem>
216
217         <listitem>
218
219           <para>Release <keycap>SPACE</keycap> or left mouse button to 
220           let the scratch-file run at the turntable's default 
221           speed.</para>
222
223         </listitem>
224
225         <listitem>
226
227           <para>Press <keycap>ESCAPE</keycap> to quit grab mode.</para>
228
229         </listitem>
230
231       </orderedlist>
232
233     </sect2>
234
235     <sect2 id="FEATURES">
236
237       <title>Features</title>
238
239       <para>The following list summarizes terminatorX' main 
240       features:</para>
241
242       <itemizedlist>
243
244         <listitem>
245
246           <para>Scratching</para>
247
248         </listitem>
249
250         <listitem>
251
252           <para>Multiple turntables</para>
253
254         </listitem>
255
256         <listitem>
257
258           <para>Built-in Sequencer</para>
259
260         </listitem>
261
262         <listitem>
263
264           <para>MIDI Interface</para>
265
266         </listitem>
267
268         <listitem>
269
270           <para>Pitch / Volume settings for each turntable</para>
271
272         </listitem>
273
274         <listitem>
275
276           <para>Effects (Lowpass/Echo) configurable for each 
277           turntable</para>
278
279         </listitem>
280
281         <listitem>
282
283           <para>Syncing tables to one master turntable</para>
284
285         </listitem>
286
287         <listitem>
288
289           <para>Broad audiofile-type support</para>
290
291         </listitem>
292
293         <listitem>
294
295           <para>Record to disk</para>
296
297         </listitem>
298
299         <listitem>
300
301           <para>Save and Load turntable sets (.tX - files)</para>
302
303         </listitem>
304
305         <listitem>
306
307           <para>Support for LADSPA plugins.</para>
308
309         </listitem>
310
311         <listitem>
312
313           <para>Support for the <emphasis>JACK Audio Connection 
314           Kit</emphasis></para>
315
316         </listitem>
317
318         <listitem>
319
320           <para>and more</para>
321
322         </listitem>
323
324       </itemizedlist>
325
326     </sect2>
327
328     <sect2 id="REQUIREMENTS">
329
330       <title>Requirements</title>
331
332       <para>To run terminatorX a system should meet the following 
333       requirements:</para>
334
335       <itemizedlist>
336
337         <listitem>
338
339           <para>Software</para>
340
341           <itemizedlist>
342
343             <listitem>
344
345               <para>required</para>
346
347               <itemizedlist>
348
349                 <listitem>
350
351                   <para>a reasonable up-to-date Linux, reported to run on FreeBSD,too</para>
352
353                 </listitem>
354
355                 <listitem>
356                   <para>glibc2 (pthreads).</para>
357                 </listitem>
358
359                 <listitem>
360                   <para>The Gimp Toolkit: gtk+ (&gt;= 3.0). If your 
361                                                                         distribution doesn't provide a current version (which is unlikely) of 
362                   gtk+ get it from the <ulink url="http://www.gtk.org">
363                   gtk+ homepage</ulink>.</para>
364
365                 </listitem>
366
367                 <listitem>
368
369                   <para>LADSPA - the Linux Audio Developer's Simple 
370                   Plugin API. Get it from the 
371                   <ulink url="http://www.ladpsa.org">LADSPA 
372                   homepage</ulink></para>
373
374                 </listitem>
375
376                 <listitem>
377
378                                                                         <para>a C/C++ compiler (gcc)</para>
379
380                 </listitem>
381
382               </itemizedlist>
383
384             </listitem>
385
386             <listitem>
387
388               <para>optional (but highly recommended)</para>
389
390               <itemizedlist>
391
392                 <listitem>
393
394                   <para>
395                   <ulink url="http://plugin.org.uk/releases/lrdf/">liblrdf</ulink> 
396                   for easier handling of LADSPA plugins</para>
397
398                 </listitem>
399
400                 <listitem>
401
402                   <para>
403                   <ulink url="http://www.mars.org/home/rob/proj/mpeg/">mad</ulink> 
404                   for loading mp3 files.</para>
405
406                 </listitem>
407
408                 <listitem>
409
410                   <para>
411                   <ulink url="http://www.xiph.org/ogg/vorbis/">libvorbis</ulink> 
412                   for loading ogg files.</para>
413
414                 </listitem>
415
416                 <listitem>
417
418                   <para>
419                   <ulink url="http://jackit.sourceforge.net">libjack</ulink> 
420                   for JACK support.</para>
421
422                 </listitem>
423
424                 <listitem>
425
426                   <para>
427                   <ulink url="http://xmlsoft.org/">libxml2</ulink> to 
428                   read terminatorX set and rc files</para>
429
430                 </listitem>
431
432                 <listitem>
433
434                   <para>
435                   <ulink url="http://www.gzip.org/zlib/">zlib</ulink> 
436                   to create compressed XML set files to save 
437                   diskspaces</para>
438
439                 </listitem>
440
441                 <listitem>
442
443                   <para>
444                   <ulink url="http://www.68k.org/~michael/audiofile/">libaudiofile</ulink> 
445                   for loading misc other audio files.</para>
446
447                 </listitem>
448
449                 <listitem>
450
451                   <para><ulink url="???">libcap</ulink> for capabilties 
452                   support.</para>
453
454                 </listitem>
455
456                 <listitem>
457
458                   <para>
459                   <ulink url="http://www-ti.informatik.uni-tuebingen.de/~hippm/mpg123.html">mpg123</ulink> 
460                   for mp3 pre-listening (and fallback loading if mad is 
461                   not installed).</para>
462
463                 </listitem>
464
465                 <listitem>
466
467                   <para>
468                   <ulink url="http://www.xiph.org/ogg/vorbis/">ogg123</ulink> 
469                   for ogg pre-listening (and fallback loading if 
470                   libvorbis is not installed).</para>
471
472                 </listitem>
473
474                 <listitem>
475
476                   <para>
477                   <ulink url="http://home.sprynet.com/~cbagwell/sox.html">sox</ulink> 
478                   for misc files pre-listening (and fallback loading of 
479                   misc files).</para>
480
481                 </listitem>
482
483               </itemizedlist>
484
485             </listitem>
486
487           </itemizedlist>
488
489         </listitem>
490
491         <listitem>
492
493           <para>Hardware</para>
494
495           <itemizedlist>
496
497             <listitem>
498
499                                                         <para>An audiodevice capable of low-latency stereo playback and compatible with either
500                                                                  <itemizedlist>
501                                                                      <listitem><para>ALSA,</para></listitem>
502                                                                      <listitem><para>OSS,</para></listitem>
503                                                                      <listitem><para>JACK or</para></listitem>
504                                                                      <listitem><para>PulseAudio</para></listitem>
505                                                                  </itemizedlist>
506                                                         </para>
507             </listitem>
508
509             <listitem>
510
511               <para>A good clean mouse and pad.</para>
512
513             </listitem>
514
515           </itemizedlist>
516
517         </listitem>
518
519       </itemizedlist>
520
521       <para>A note on performance: terminatorX is known to run 
522       satisfyingly even on low-end systems. 
523       Increasing the number of turntables or plugins will of course 
524       require may require more performant hardware.</para>
525
526     </sect2>
527
528     <sect2 id="INSTALLATION">
529
530       <title>Installation</title>
531
532       <para>For GNU-standards' sake this information is now located in 
533       the <filename>INSTALL</filename> file that came with this 
534       distribution of terminatorX.</para>
535
536     </sect2>
537
538   </sect1>
539
540   <sect1 id="OPERATION">
541
542     <title>Operation</title>
543
544     <para>TerminatorX' user interface is split up into the main 
545     controls (master, sequencer, engine controls and menu buttons) and 
546     the individual turntable's controls. Each turntable has it's own 
547     interface split up into a control and a audio panel (see 
548     <xref linkend="TURNTABLECONTROLS"/>).</para>
549
550     <sect2 id="MENU">
551
552       <title>Menu</title>
553
554       <para>To clean-up the user interface a bit further some functions 
555       have been moved into a more standard menu bar for the main window 
556       (with release 3.80). The following sub-menus are available:</para>
557
558       <sect3 id="FILEMENU">
559
560         <title><emphasis>File</emphasis> Menu</title>
561
562         <para>The <emphasis>File</emphasis> menu features these 
563         functions:</para>
564
565         <itemizedlist>
566
567           <listitem>
568
569             <para><emphasis>Load Audio File</emphasis></para>
570
571             <para>The "official" position functionality is located at 
572             the file button (that reads "NONE" on startup) for each 
573             turntable. However, a lot of people expect to find this 
574             functionality in the menu, so you can load an audio file 
575             from here, too.</para>
576
577           </listitem>
578
579           <listitem>
580
581             <para><emphasis>New Set</emphasis></para>
582
583             <para>Erases all existing turntables and sequencer events 
584             and creates a new and untouched turntable.</para>
585
586           </listitem>
587
588           <listitem>
589
590             <para><emphasis>Open Set File</emphasis></para>
591
592             <para>Allows restoring of a previously saved terminatorX 
593             set file.</para>
594
595           </listitem>
596
597           <listitem>
598
599             <para><emphasis>Save Set</emphasis></para>
600
601             <para>Saves the current turntables and events in a 
602             terminatorX set file.</para>
603
604           </listitem>
605
606           <listitem>
607
608             <para><emphasis>Save Set As</emphasis></para>
609
610             <para>Like <emphasis>Save</emphasis> but prompts for a new 
611             file name.</para>
612
613           </listitem>
614
615           <listitem>
616
617             <para><emphasis>Quit</emphasis></para>
618
619           </listitem>
620
621         </itemizedlist>
622
623       </sect3>
624
625       <sect3 id="TURNTABLESMENU">
626
627         <title><emphasis>Turntables</emphasis> Menu</title>
628
629         <para>The <emphasis>Turntables</emphasis> menu features these 
630         functions:</para>
631
632         <itemizedlist>
633
634           <listitem>
635
636             <para><emphasis>Add Turntable</emphasis></para>
637
638             <para>Adds a new turntable to the current set of 
639             turntables.</para>
640
641           </listitem>
642
643           <listitem>
644
645             <para><emphasis>Assign Default MIDI 
646             Mappnigs</emphasis></para>
647
648             <para>Will assign the Default MIDI Mappings (see 
649             <xref linkend="MIDI"/>) to all standard parameters. 
650             Existing mappings will not be overridden.</para>
651
652           </listitem>
653
654           <listitem>
655
656             <para><emphasis>Auto Assign Default MIDI 
657             Mappings</emphasis></para>
658
659             <para>When this option is enabled will always re-apply the 
660             Default MIDI Mappings (see <xref linkend="MIDI"/>) whenever 
661             you load a set, add a new turntable or create a new set. 
662             Existing mappings will not be overridden.</para>
663
664           </listitem>
665
666           <listitem>
667
668             <para><emphasis>Clear MIDI Mappings</emphasis></para>
669
670             <para>Removes all currently assigned MIDI mappings.</para>
671
672           </listitem>
673
674           <listitem>
675
676             <para><emphasis>Record Audio to Disk</emphasis></para>
677
678             <para>On activation of this option, terminatorX will prompt 
679             for a file name for the RIFF/Wave file to create. Once 
680             activated terminatorX will start recording audio to disk 
681             the next time the audio engine is started - either by 
682             pressing the Power or the Play button. Recording will stop 
683             when the audio engine is stopped again. The created 
684             RIFF/Wave file will be a 16Bit/Stereo wave-file with the 
685             sampling rate selected for the current audio backend.</para>
686
687           </listitem>
688
689         </itemizedlist>
690
691       </sect3>
692
693       <sect3 id="SEQUENCERMENU">
694
695         <title><emphasis>Sequencer</emphasis> Menu</title>
696
697         <para>The <emphasis>Sequencer</emphasis> (see 
698         <xref linkend="SEQUENCER"/> for general information on the 
699         sequencer) menu features these functions:</para>
700
701         <itemizedlist>
702
703           <listitem>
704
705             <para><emphasis>Delete All</emphasis> submenus</para>
706
707             <para>These submenus allow you to delete sequencer events 
708             of a specific parameter or all events for a complete 
709             turntable. After selecting the the parameter/turntable of 
710             your choice a dialog will pop-up that allows you to delete 
711             all events from either:</para>
712
713             <itemizedlist>
714
715               <listitem>
716
717                 <para>the beginning of the song upto the current song 
718                 position</para>
719
720               </listitem>
721
722               <listitem>
723
724                 <para>the current song position upto the end of the 
725                 song</para>
726
727               </listitem>
728
729               <listitem>
730
731                 <para>the beginning to the end of the song (all 
732                 events)</para>
733
734               </listitem>
735
736             </itemizedlist>
737
738           </listitem>
739
740           <listitem>
741
742             <para><emphasis>Delete All Events</emphasis></para>
743
744             <para>Works the same as the <emphasis>Delete All</emphasis> 
745             submenus but selects <emphasis>all</emphasis> events for 
746             <emphasis>all</emphasis> turntables.</para>
747
748           </listitem>
749
750           <listitem>
751
752             <para><emphasis>Confirm Recorded Events</emphasis></para>
753
754             <para>Usually terminatorX will add all recorded events of a 
755             take to the song event list as soon as you hit the 
756             <emphasis>Stop</emphasis> button for the sequencer. If you 
757             enable <emphasis>Confirm Recorded Events</emphasis> 
758             terminatorX will ask you whether the recorded events should 
759             really be fed into the song list. This makes it much easier 
760             to record a certain part over and over again until you get 
761             it right.</para>
762
763           </listitem>
764
765         </itemizedlist>
766
767       </sect3>
768
769       <sect3 id="OPTIONSMENU">
770
771         <title><emphasis>Options</emphasis> Menu</title>
772
773         <para>The <emphasis>Options</emphasis> menu features these 
774         functions:</para>
775
776         <itemizedlist>
777
778           <listitem>
779
780             <para><emphasis>Fullscreen</emphasis></para>
781
782             <para>Maximizes the terminatorX main windows to use the 
783             complete screen. Note that this requires a NETWM compliant 
784             window manager to work. By toggling this option again 
785             terminatorX' window can be resized back to the previous 
786             state again. The setting will be stored in the <filename>
787             ~/.terminatorXrc</filename> file.</para>
788
789           </listitem>
790
791           <listitem>
792
793             <para><emphasis>Preferences</emphasis></para>
794
795             <para>Will pop up the Preferences dialog. For more details 
796             on configuration itself see <xref linkend="CONFIGURATION"/> 
797             .</para>
798
799           </listitem>
800
801         </itemizedlist>
802
803       </sect3>
804
805       <sect3 id="HELPMENU">
806
807         <title><emphasis>Help</emphasis> Menu</title>
808
809         <para>The <emphasis>Help</emphasis> menu features these 
810         functions:</para>
811
812         <itemizedlist>
813
814           <listitem>
815
816             <para><emphasis>Contents</emphasis></para>
817
818             <para>Starts a <emphasis>gnome-help</emphasis> (aka 
819             <emphasis>yelp</emphasis>) process to display the very 
820             manual you are reading right now.</para>
821
822           </listitem>
823
824           <listitem>
825
826             <para><emphasis>About</emphasis></para>
827
828             <para>Selecting this menu item will cause a small dialog to 
829             pop up that contains some information on the compile time 
830             settings for the terminatorX binary as well as the 
831             license.</para>
832
833           </listitem>
834
835           <listitem>
836
837             <para><emphasis>Visit terminatorX.org</emphasis></para>
838
839             <para>Will try to spawn a browser process to load the URL 
840             <ulink url="http://terminatorX.org">
841             http://terminatorX.org</ulink> - for easy update checking or 
842             just unecessary bloat.</para>
843
844           </listitem>
845
846         </itemizedlist>
847
848       </sect3>
849
850     </sect2>
851
852     <sect2 id="MAINCONTROLS">
853
854       <title>Main Controls</title>
855
856       <para>The controls of the master GUI are located in the top and 
857       the right bar of the terminatorX main window.</para>
858
859       <itemizedlist>
860
861         <listitem>
862
863           <para><emphasis>Audio Engine Power / Mouse 
864           Grab</emphasis></para>
865
866           <para>With the Audio Engine Button you can en- and disable 
867           the audio playback engine without activating the sequencer. 
868           Unlike earlier versions you will not automatically enter 
869           mouse-grab mode so you can modify volume/pitch/echo settings 
870           etc. while you actually hear what you do.</para>
871
872           <para>Some functions are not available when the audio engine 
873           is on, their controls will be marked insensitive when you 
874           enable the engine. To actually enter grab mode you'll have to 
875           click on the "Mouse Grab" button. See 
876           <xref linkend="GRABMODE"/> to find out how to control the 
877           software then.</para>
878
879         </listitem>
880
881         <listitem>
882
883           <para><emphasis>Sequencer Play / Record / 
884           Stop</emphasis></para>
885
886           <para>Please read <xref linkend="SEQUENCER"/> to find out 
887           more about the sequencer.</para>
888
889         </listitem>
890
891         <listitem>
892
893           <para><emphasis>Master Volume / Pitch</emphasis></para>
894
895           <para>The volume and pitch settings of the individual 
896           turntables are relative to these master settings. This 
897           information will be stored within the .tX set files.</para>
898
899         </listitem>
900
901       </itemizedlist>
902
903     </sect2>
904
905     <sect2 id="TURNTABLECONTROLS">
906
907       <title>Turntable Controls</title>
908
909       <para>The turntable GUI contains multiple controls and the real 
910       time displays for each turntable. To save some space on your 
911       desktop and to give terminatorX the traditional audio-application 
912       look, terminatorX features "knob"-widgets. These widgets work 
913       pretty straight-forward: click somewhere within the widget and 
914       keep the left mouse-button pressed. Now move the mouse up and 
915       down or left and right to increase/decrease the control's value. 
916       All those widget are coupled with a text entry field since 3.70, 
917       which allows you to enter values directly.</para>
918
919       <para>A turntable is visualized by two panels: the control and 
920       the audio panel. These are no longer combined for better layout 
921       management.</para>
922
923       <para>Sometimes you might find a certain audio or control panel 
924       unnecessary - simply eating up space. Since release 3.73 it is 
925       possible to minimize audio and control panels to the 
926       <emphasis>panel bar</emphasis> with the tiny button with a blue 
927       bar icon in the upper right edge of each panel. This bar works 
928       just like GNOME's window list or KDE's kicker: When a panel is 
929       minimized a button in the bar will appear, representing the 
930       minimized window. On clicking this button the button will be 
931       removed and the minimized panel is displayed again. When no 
932       panels are minimized the panel bar automatically disappears to 
933       save display space.</para>
934
935       <sect3>
936
937         <title>Turntable Audio Panel</title>
938
939         <para>The complete audio-file loaded into a turntable is 
940         displayed in the green-on-black audio-widget. When playing 
941         terminatorX will indicate the current position within the 
942         sample with a red cursor (a blue/green cursor indicates the 
943         turntable is muted).</para>
944
945         <para>Additionally there are some controls above the 
946         audio-display:</para>
947
948         <itemizedlist>
949
950           <listitem>
951
952             <para><emphasis>Turntable Label</emphasis></para>
953
954             <para>This label indicates the turntables name. The name 
955             can be set via the control panel</para>
956
957           </listitem>
958
959           <listitem>
960
961             <para><emphasis>File Button</emphasis></para>
962
963             <para>This button holds the name of the audio-file 
964             currently loaded. When there's no sample loaded the button 
965             will read "NONE" to indicate the current status. Click on 
966             this button to get a menu from which you can load/reload a 
967             sound file or run an external soundfile editor. 
968             Alternatively you can drag'n'drop files over the 
969             audio-display to load them.</para>
970
971             <itemizedlist>
972
973               <title>The File Button Menu</title>
974
975               <listitem>
976
977                 <para><emphasis>Load File</emphasis></para>
978
979                 <para>Choose this menu entry to select a soundfile from 
980                 the file-selection dialog that will pop-up.</para>
981
982               </listitem>
983
984               <listitem>
985
986                 <para><emphasis>Reload File</emphasis></para>
987
988                 <para>Choose this menu entry to re-read the 
989                 audio-file.</para>
990
991               </listitem>
992
993               <listitem>
994
995                 <para><emphasis>Edit File</emphasis></para>
996
997                 <para>This menu entry will run the external 
998                 audiofile-editor (that can be specified via the 
999                 options-dialog) with the current audio-file as a 
1000                 parameter. Choose reload after editing and saving the 
1001                 file.</para>
1002
1003               </listitem>
1004
1005             </itemizedlist>
1006
1007           </listitem>
1008
1009           <listitem>
1010
1011             <para><emphasis>Mouse Mapping</emphasis></para>
1012
1013             <para>terminatorX allows mapping misc parameters to the 
1014             mouse axis of your choice. These mappings will be activated 
1015             in grab mode, so if you move your mouse in X or Y direction 
1016             in grab mode the parameters you selected from this menu 
1017             will be affected (for this turntable). Since Version 3.70 
1018             this mappings are no longer hardcoded to built-in controls 
1019             but available for all parameters that qualify as 
1020             "mappable". Note that this includes plugins' controls as 
1021             well.</para>
1022
1023           </listitem>
1024
1025           <listitem>
1026
1027             <para><emphasis>MIDI Mapping</emphasis></para>
1028
1029             <para>This button is available only if terminatorX was 
1030             built with ALSA MIDI support and the sequencer input port 
1031             was created successfully on startup. For more information 
1032             on terminatorX' MIDI interface see <xref linkend="MIDI"/> 
1033             .</para>
1034
1035           </listitem>
1036
1037         </itemizedlist>
1038
1039       </sect3>
1040
1041       <sect3>
1042
1043         <title>Turntable Controls</title>
1044
1045         <para>These controls are now grouped within functional panels. 
1046         The number of panels depends on the number of plugins loaded. 
1047         terminatorX allows hiding the controls not required via the 
1048         yellow triangle button. To un-hide just click the button again. 
1049         The first panels are the standard controls for a turntable, 
1050         then follows the dynamic FX-section and below that follow the 
1051         pitch and volume controls.</para>
1052
1053         <sect4>
1054
1055           <title>Main Panel</title>
1056
1057           <itemizedlist>
1058
1059             <listitem>
1060
1061               <para><emphasis>Name Field</emphasis></para>
1062
1063               <para>The main panel features a text entry field that 
1064               allows setting a name for the related turntable. The 
1065               Labels for the controls and the audio-display will update 
1066               accordingly.</para>
1067
1068             </listitem>
1069
1070             <listitem>
1071
1072               <para><emphasis>Delete Button</emphasis></para>
1073
1074               <para>Pressing this button remove the turntable from the 
1075               current setup. Note that all sequencer events recorded 
1076               for this turntable will be erased, too.</para>
1077
1078             </listitem>
1079
1080             <listitem>
1081
1082               <para><emphasis>Pitch Adj. Button</emphasis></para>
1083
1084               <para>Using two (or more) loops and terminatorX' 
1085               synchronization facility usually requires adjusting the 
1086               pitch of the loops so that the turntables play in sync. 
1087               For precisely cut loops this usually means making them 
1088               run equally fast or one running twice as fast as the 
1089               other etc. Manually finding the necessary pitch values 
1090               usually consumes a significant amount of time so the 
1091               feature <emphasis>Pitch Adjust</emphasis> helps speeding 
1092               up this process.</para>
1093
1094               <para>Clicking this button will cause the 
1095               <emphasis>Compute Pitch</emphasis> dialog to pop up. With 
1096               this dialog it is possible to specify how many loops of 
1097               this turntable should be played as fast as a certain 
1098               amount of loops of the master turntable. After pressing 
1099               the <emphasis>Ok</emphasis> button terminatorX will 
1100               adjust the turntable's ptich accordingly in order to 
1101               match the given playback speed requirements.</para>
1102
1103               <para>Note that this feature is proabably useless when 
1104               loading complete songs into terminatorX - it's intended 
1105               for use with precisely cut loops.</para>
1106
1107             </listitem>
1108
1109           </itemizedlist>
1110
1111         </sect4>
1112
1113         <sect4>
1114
1115           <title>Playback Panel</title>
1116
1117           <para>The playback panel holds all controls related to 
1118           triggering the turntable. For more details on synchronization 
1119           see <xref linkend="SYNCHRONIZATION"/>.</para>
1120
1121           <itemizedlist>
1122
1123             <listitem>
1124
1125               <para><emphasis>Trigger! Button</emphasis></para>
1126
1127               <para>Pressing this button triggers the turntable now. 
1128               With the audio engine enabled this will cause the 
1129               turntable to start playing back audio from the beginning 
1130               of the sample.</para>
1131
1132             </listitem>
1133
1134             <listitem>
1135
1136               <para><emphasis>Stop Button</emphasis></para>
1137
1138               <para>Guess what, this stops this turntable's 
1139               audio-playback.</para>
1140
1141             </listitem>
1142
1143             <listitem>
1144
1145               <para><emphasis>Master Button</emphasis></para>
1146
1147               <para>Enabling this button makes this turntable the 
1148               <emphasis>sync-master</emphasis>. Note that only 
1149               <emphasis>one</emphasis> turntable at a time can be the 
1150               sync-master.</para>
1151
1152             </listitem>
1153
1154             <listitem>
1155
1156               <para><emphasis>Client Button</emphasis></para>
1157
1158               <para>This button marks the turntable as 
1159               <emphasis>sync-client</emphasis>, so it will be triggered 
1160               with the master automatically.</para>
1161
1162             </listitem>
1163
1164             <listitem>
1165
1166               <para><emphasis>Sync-Cycles Selection</emphasis></para>
1167
1168               <para>The sync cycles determine how often a sync-client 
1169               should be triggered. With a setting of zero the 
1170               sync-client will be (re-)triggered with 
1171               <emphasis>every</emphasis> trigger of the sync-master. A 
1172               setting of 1 will (re-)trigger the client every 
1173               <emphasis>second</emphasis> master-trigger and so 
1174               on.</para>
1175
1176             </listitem>
1177
1178           </itemizedlist>
1179
1180           <para>
1181
1182             Below the effect queue a turntable shows some more controls:
1183             <itemizedlist>
1184
1185               <listitem>
1186
1187                 <para><emphasis>Pitch Control</emphasis></para>
1188
1189                 <para>The pitch control allows setting the default 
1190                 playback speed for that turntable (the "motor" speed). 
1191                 Negative values will result in the sample being played 
1192                 backwards.</para>
1193
1194               </listitem>
1195
1196               <listitem>
1197
1198                 <para><emphasis>PAN Control</emphasis></para>
1199
1200                 <para>This parameter allows setting the position of the 
1201                 turntable's main signal within the stereo 
1202                 panorama.</para>
1203
1204               </listitem>
1205
1206               <listitem>
1207
1208                 <para><emphasis>VU Meter</emphasis></para>
1209
1210                 <para>The displayed signal shows the turntable's 
1211                 current signal not including the echo-signal which is 
1212                 mixed separately.</para>
1213
1214               </listitem>
1215
1216             </itemizedlist>
1217
1218           </para>
1219
1220         </sect4>
1221
1222       </sect3>
1223
1224       <sect3 id="PARAMETERMENU">
1225
1226         <title>Parameter Menu</title>
1227
1228         <para>
1229
1230           TerminatorX can record events for nearly all parameters of a 
1231           turntable. All of these so-called "sequencable" parameters 
1232           have an extra pop-up menu since Version 3.81. Simply 
1233           right-click on the knob, button, slider of the parameter you 
1234           want to setup, and a menu with the following options will 
1235           appear:
1236           <itemizedlist>
1237
1238             <listitem>
1239
1240               <para><emphasis>MIDI Learn</emphasis></para>
1241
1242               <para>This options provides an easy method to select the 
1243               MIDI control to modify the parameter you select. If you 
1244               choose this menu entry, a tiny dialog box will pop up 
1245               that reads <emphasis>"Waiting for MIDI 
1246               Event..."</emphasis>. The first MIDI event terminatorX 
1247               receives will now be mapped to control this 
1248               parameter.</para>
1249
1250             </listitem>
1251
1252             <listitem>
1253
1254               <para><emphasis>Remove MIDI Binding</emphasis></para>
1255
1256               <para>If a MIDI event has been bound to a parameter it 
1257               can be removed by selecting this menu entry.</para>
1258
1259             </listitem>
1260
1261             <listitem>
1262
1263               <para><emphasis>Map MIDI Reverse</emphasis></para>
1264
1265               <para>This option can be turned either on or off: when 
1266               enabled the maximum value of the MIDI controller will be 
1267               mapped to the minimum value of the controlled parameter 
1268               and the other way round.</para>
1269
1270               <para>Note that this allows mapping a MIDI controller as 
1271               a crossfader: simply map the same MIDI controller to two 
1272               different turntables's volume controls (or optionally 
1273               extra amplifier plugins) and reverse one of these MIDI 
1274               mappings.</para>
1275
1276             </listitem>
1277
1278             <listitem>
1279
1280               <para><emphasis>Set Upper MIDI Bound</emphasis></para>
1281
1282               <para>Sometimes it is preferable to modify a certain 
1283               parameter only within a specific value range - this can 
1284               be achieved with this option - by setting an upper and a 
1285               lower bound for the MIDI control of this parameter. When 
1286               you select this menu entry, the current setting of this 
1287               parameter will be used as the upper bound for the 
1288               parameter's MIDI mapping.</para>
1289
1290             </listitem>
1291
1292             <listitem>
1293
1294               <para><emphasis>Reset Upper MIDI Bound</emphasis></para>
1295
1296               <para>If an upper MIDI bound was set for this parameter 
1297               it can be removed by selecting this menu entry.</para>
1298
1299             </listitem>
1300
1301             <listitem>
1302
1303               <para><emphasis>Set Lower MIDI Bound</emphasis></para>
1304
1305               <para>Works just like setting the uper MIDI bound: when 
1306               you select this menu entry, the current setting of this 
1307               parameter will be used as the lower bound for the 
1308               parameter's MIDI mapping.</para>
1309
1310             </listitem>
1311
1312             <listitem>
1313
1314               <para><emphasis>Reset Lower MIDI Bound</emphasis></para>
1315
1316               <para>If a lower MIDI bound was set for this parameter it 
1317               can be removed by selecting this menu entry.</para>
1318
1319             </listitem>
1320
1321             <listitem>
1322
1323               <para><emphasis>Delete Sequencer Events</emphasis></para>
1324
1325               <para>Just like the Sequencer menu (see 
1326               <xref linkend="SEQUENCERMENU"/>) this entry allows you to 
1327               delete events recorded for this specific parameter.</para>
1328
1329             </listitem>
1330
1331           </itemizedlist>
1332
1333         </para>
1334
1335       </sect3>
1336
1337       <sect3>
1338
1339         <title>The Effect Queue</title>
1340
1341         <para>With release 3.70 the effects are no longer hardcoded 
1342         into the turntable. The effects are now arranged within an 
1343         per-turntable effect-queue. Additionally Version 3.82 
1344         introduces a second effect-queue that follows the first: the 
1345         queue for stereo LADSPA plugin effects. The effect sequence is 
1346         configurable by the user. To move an effect to higher position 
1347         within the queue, press the <emphasis>blue upward arrow 
1348         button</emphasis>. This will cause the effect to be rendered 
1349         <emphasis>before</emphasis> the following effects. The 
1350         <emphasis>blue downward arrow button</emphasis> will move the 
1351         effect down by one position. It will then be rendered 
1352         <emphasis>after</emphasis> the preceding effects.</para>
1353
1354         <para>There are two types of effects: the traditional built-in 
1355         effects (Lowpass and Echo) and LADSPA plugins. The built-in 
1356         effects are always available and cannot be removed (but 
1357         disabled). There can be only one instance of a built-in effect. 
1358         The LADSPA plugins on the other hand may be instantiated 
1359         multiple times and can be removed from the effect queue. Press 
1360         the <emphasis>blue cross button</emphasis> to achieve 
1361         this.</para>
1362
1363         <figure>
1364
1365           <title>An example for a terminatorX effect queue</title>
1366
1367           <graphic fileref="figures/signalflow.png" format="PNG"/>
1368         </figure>
1369
1370         <para>Now since release 3.71 the built-in echo effect is 
1371         treated differently from other effects. Where all other effects 
1372         feed their signal back into the effect queue the echo effect 
1373         doesn't touch the input signal. It's echo-signal is mixed 
1374         separately from the turntable's main signal to allow a 
1375         different panning value for the echo-signal. This mode of 
1376         operation does have some side-effects: imagine a lowpass filter 
1377         with a position after the echo effect in the effect queue. This 
1378         will result in the turntable's main signal being 
1379         lowpass-filtered but it will leave the echo-signal 
1380         lowpass-unfiltered.</para>
1381
1382         <para>Some may call this behaviour a bug - whereas I would 
1383         consider it a feature ;). Anyway if the above description 
1384         didn't clear things up maybe the displayed figure does. It 
1385         shows a schematic effect queue with the built-in effects and 
1386         two LADSPA effects enabled. Now with this setup you will not 
1387         hear anything from the second LADSPA effect in the 
1388         echo-signal.</para>
1389
1390         <para>Release 3.82 introduces a menu for each LADSPA plugin. 
1391         Simply click on the Plugin's label to operate the menu. Aside 
1392         of displaying detailed information about a plugin, the menu 
1393         also contains some new functionality: <emphasis>Add Dry/Wet 
1394         Control</emphasis>. When activated the effect receives an extra 
1395         Dry/Wet control that allows you to modify to what extent the 
1396         effect will actually effect the turntable's signal. The extra 
1397         control doesn't differ from the other controls: you can record 
1398         events for it, etc. The additional control can be removed via 
1399         the very same menu item that adds the control.</para>
1400
1401         <itemizedlist>
1402
1403           <listitem>
1404
1405             <para><emphasis>FX</emphasis> and <emphasis>Stereo FX 
1406             Buttons</emphasis></para>
1407
1408             <para>Press this button to load a LADSPA plugin into the 
1409             effect queue of the turntable. A menu holding the available 
1410             (terminatorX-"compatible") LADSPA-plugins will pop up - 
1411             mono plugins are available from the <emphasis>FX</emphasis> 
1412             menu, stereo plugins from the <emphasis>Stereo 
1413             FX</emphasis> menu. The plugins are grouped within submenus 
1414             according to the modules the plugins are contained in. 
1415             Simply select the plugin you want to load from this menu 
1416             and a panel for it will pop up at the end of the effect 
1417             queue.</para>
1418
1419             <para>Note that due to the wide parameter ranges some 
1420             LADSPA plugins have they sometimes might be hard to control 
1421             with the knob widget. In these cases you might want to use 
1422             the text field to enter values. For more details on plugins 
1423             see <xref linkend="LADSPAPLUGINS"/>.</para>
1424
1425           </listitem>
1426
1427         </itemizedlist>
1428
1429       </sect3>
1430
1431       <sect3>
1432
1433         <title>Lowpass Panel</title>
1434
1435         <para>terminatorX features a built-in resonating lowpass filter 
1436         that can be configured with this panel.</para>
1437
1438         <itemizedlist>
1439
1440           <listitem>
1441
1442             <para><emphasis>Enable Button</emphasis></para>
1443
1444             <para>Activating this button will enable the lowpass filter 
1445             for this turntable.</para>
1446
1447           </listitem>
1448
1449           <listitem>
1450
1451             <para><emphasis>Input Gain Control</emphasis></para>
1452
1453             <para>With this parameter you can amplify the signal that 
1454             goes into the lowpass filter if required.</para>
1455
1456           </listitem>
1457
1458           <listitem>
1459
1460             <para><emphasis>Frequency Control</emphasis></para>
1461
1462             <para>Use this parameter to set the cutoff frequency for 
1463             the lowpass filter. Minimum: 0=0Hz, Maximum: 1=22KHz.</para>
1464
1465           </listitem>
1466
1467           <listitem>
1468
1469             <para><emphasis>Resonance</emphasis></para>
1470
1471             <para>Use this parameter to set the resonance-value. 
1472             Minimum: 0=no resonance, Maximum: 1=max resonance.</para>
1473
1474           </listitem>
1475
1476         </itemizedlist>
1477
1478       </sect3>
1479
1480       <sect3>
1481
1482         <title>Echo Panel</title>
1483
1484         <para>Additionally terminatorX features a built-in echo effect. 
1485         It can be configured with this panel.</para>
1486
1487         <itemizedlist>
1488
1489           <listitem>
1490
1491             <para><emphasis>Enable Button</emphasis></para>
1492
1493             <para>Activating this button will enable the echo effect 
1494             for this turntable.</para>
1495
1496           </listitem>
1497
1498           <listitem>
1499
1500             <para><emphasis>Duration Control</emphasis></para>
1501
1502             <para>Use this parameter to set the length of the echo. The 
1503             duration parameter scales to the actual sample length: so 
1504             if you set it to 0.5 you will hear the echo when the red 
1505             playback cursor is half way through the sample. This is 
1506             true for samples that are shorter than terminatorX' maximum 
1507             echo buffer size only.</para>
1508
1509           </listitem>
1510
1511           <listitem>
1512
1513             <para><emphasis>Feedback Control</emphasis></para>
1514
1515             <para>Set the echo's feedback amount with this 
1516             parameter.</para>
1517
1518           </listitem>
1519
1520           <listitem>
1521
1522             <para><emphasis>Volume Control</emphasis></para>
1523
1524             <para>This parameter can additionally amplify the echo 
1525             signal. Unlike the feedback parameter above this parameter 
1526             has no influence on the signal fed back into the 
1527             echo-buffer, it effects merely the playback volume of the 
1528             echo signal.</para>
1529
1530           </listitem>
1531
1532           <listitem>
1533
1534             <para><emphasis>Pan Control</emphasis></para>
1535
1536             <para>The echo effect differs from other effects as it's 
1537             output signal will be mixed separately. The main goal here 
1538             is to allow positioning the echo signal at a position in 
1539             the stereo panorama that differs from the main panning 
1540             position of the turntable to achieve a somewhat spacial 
1541             effect. The easy example is: turntable's panning left, 
1542             echo's panning right. As both pan parameters are 
1543             sequenceable you can create nice motion effects from this 
1544             starting point.</para>
1545
1546           </listitem>
1547
1548         </itemizedlist>
1549
1550       </sect3>
1551
1552     </sect2>
1553
1554     <sect2 id="SYNCHRONIZATION">
1555
1556       <title>Synchronization</title>
1557
1558       <para>Let's start off with an example: Say you have two drum 
1559       loops and one bassline loaded in three turntables. Of course you 
1560       want these samples to be triggered at the same time but you don't 
1561       want to invest time to cut them to the exact length. Therefore 
1562       you decide which of the drum loops to make the sync master. 
1563       You'll have to do this before you enable the audio engine (for 
1564       now). Only one turntable can be the sync master. Now you can make 
1565       the other two sync clients which will cause them to be 
1566       (re-)triggered whenever the master is (re-)triggered. The number 
1567       you can select to the right of the <emphasis>client 
1568       button</emphasis> sets the trigger delay for the button: if it's 
1569       set to zero the turntable will be triggered with every master 
1570       trigger, if it's set to 1 it'll be triggered every 2nd master 
1571       trigger and so on.</para>
1572
1573       <para>A nice side effect of this feature is: you can now scratch 
1574       the second (sync client) drum loop and no matter whether you're 
1575       scratching is good or not the beat will be triggered correctly 
1576       again ;)</para>
1577
1578     </sect2>
1579
1580     <sect2 id="GRABMODE">
1581
1582       <title>Grab Mode Operation</title>
1583
1584       <para>After pressing the <emphasis>Mouse Grab button</emphasis> 
1585       terminatorX enters "grab mode". This mode actually blocks the 
1586       mouse (as its input is now used to control the real time 
1587       parameters) and therefore you'll have to know some mouse/keyboard 
1588       shortcuts to control the software without the GUI.</para>
1589
1590       <para>Press <keycap>ESCAPE</keycap> to quit grab mode.</para>
1591
1592       <para>Select the turntable with input focus: The first turntable 
1593       to hold the input focus will be the first turntable. You can now 
1594       use <keycap>TAB</keycap> or right mouse button to switch to the 
1595       next turntable. Alternatively you can use <keycap>F1</keycap> to 
1596       <keycap>F12</keycap> to select turntable 1 to 12.</para>
1597
1598       <para>Now the turntable that has the focus is the one you will 
1599       manipulate with your mouse and keyboard inputs: Note that you can 
1600       actually map different functions to the mouse x/y axis - so what 
1601       actually happens when you move your mouse depends on what you 
1602       select via the <emphasis>Mouse Mapping</emphasis> for each 
1603       turntable.</para>
1604
1605       <table>
1606
1607         <title>Keyboard Controls in Grab Mode</title>
1608
1609         <tgroup cols="2">
1610
1611           <thead>
1612
1613             <row><entry>Key</entry><entry>Function</entry></row>
1614
1615           </thead>
1616
1617           <tbody>
1618
1619             <row><entry><keycap>TAB</keycap></entry><entry>select next 
1620             turntable</entry></row>
1621
1622             <row><entry><keycap>F1</keycap> to <keycap>
1623             F12</keycap></entry><entry>select turntable 1 to 
1624             12</entry></row>
1625
1626             <row><entry><keycap>RETURN</keycap></entry><entry>triggers 
1627             the turntable</entry></row>
1628
1629             <row><entry><keycap>BACKSPACE</keycap></entry><entry>stops 
1630             the turntable</entry></row>
1631
1632             <row><entry><keycap>S</keycap></entry><entry>toggles "Sync 
1633             Client"</entry></row>
1634
1635             <row><entry><keycap>SPACE</keycap></entry><entry>while 
1636             pressed turntable speed is mapped to mouse speed 
1637             (scratching!)</entry></row>
1638
1639             <row><entry><keycap>ALT</keycap></entry><entry>mute 
1640             on/off</entry></row>
1641
1642             <row><entry><keycap>CTRL</keycap></entry><entry>mute on/off 
1643             (inverted)</entry></row>
1644
1645             <row><entry><keycap>F</keycap></entry><entry>("fast") warp 
1646             mode (while scratching)</entry></row>
1647
1648             <row><entry><keycap>W</keycap></entry><entry>same as above 
1649             but the audio will be muted while warping</entry></row>
1650
1651           </tbody>
1652
1653         </tgroup>
1654
1655       </table>
1656
1657       <table>
1658
1659         <title>Mouse Button Controls in Grab Mode</title>
1660
1661         <tgroup cols="2">
1662
1663           <thead>
1664
1665             <row><entry>Mouse 
1666             Button</entry><entry>Function</entry></row>
1667
1668           </thead>
1669
1670           <tbody>
1671
1672             <row><entry><emphasis>Left 
1673             button</emphasis></entry><entry>same as <keycap>
1674             SPACE</keycap>: scratching (triggers the turntable when 
1675             stopped)</entry></row>
1676
1677             <row><entry><emphasis>Right 
1678             button</emphasis></entry><entry>select next 
1679             turntable</entry></row>
1680
1681             <row><entry><emphasis>Middle 
1682             button</emphasis></entry><entry>mute on/off</entry></row>
1683
1684           </tbody>
1685
1686         </tgroup>
1687
1688       </table>
1689
1690       <para>Scratching works as before: press <keycap>SPACE</keycap> or 
1691       left mouse button to actually scratch: now your mouse controls 
1692       the turntables speed. Release it to let that turntable spin at 
1693       default speed again.</para>
1694
1695     </sect2>
1696
1697     <sect2 id="DRAGNDROP">
1698
1699       <title>Drag And Drop</title>
1700
1701       <para>Since V3.55 terminatorX provides multiple DND-Drop-Targets 
1702       for use with GNOME / gmc (gmc is the GNU Midnight Commander), 
1703       Nautilus or the Enlightenment File Manager (efm). You can load an 
1704       audiofile into an existing turntable by dragging it from a gmc 
1705       (or efm or whatever)-window and drop it over a. the 
1706       <emphasis>file button</emphasis> (audio-display) or b. (the 
1707       easier target ;) over the audio-display (the green on black 
1708       widget that displays the audiodata).</para>
1709
1710       <para>To add a file to the set (== to load the file into a *new* 
1711       turntable) simply drop the audiofile over the "New Turntable" 
1712       Button. To load a complete terminatorX-set simply drop the set 
1713       file (*.tX) over the "Load Set" button.</para>
1714
1715     </sect2>
1716
1717     <sect2 id="SEQUENCER">
1718
1719       <title>The Sequencer</title>
1720
1721       <para>Release 3.60 introduced the sequencer. It can record and 
1722       play back events for the following parameters:</para>
1723
1724       <itemizedlist>
1725
1726         <listitem>
1727
1728           <para>master volume &amp; pitch</para>
1729
1730         </listitem>
1731
1732         <listitem>
1733
1734           <para>scratching</para>
1735
1736         </listitem>
1737
1738         <listitem>
1739
1740           <para>(turntable) volume &amp; pitch</para>
1741
1742         </listitem>
1743
1744         <listitem>
1745
1746           <para>triggers</para>
1747
1748         </listitem>
1749
1750         <listitem>
1751
1752           <para>loop (on/off)</para>
1753
1754         </listitem>
1755
1756         <listitem>
1757
1758           <para>sync client settings</para>
1759
1760         </listitem>
1761
1762         <listitem>
1763
1764           <para>muting</para>
1765
1766         </listitem>
1767
1768         <listitem>
1769
1770           <para><emphasis>all</emphasis> parameters for the effects. 
1771           This includes built-in effects (lowpass and echo) as well as 
1772           LADSPA plugins.</para>
1773
1774         </listitem>
1775
1776       </itemizedlist>
1777
1778       <para>To record events simply press the 
1779       <emphasis>Record</emphasis> button of the sequencer, then press 
1780       the <emphasis>Play</emphasis> button. All actions (for 
1781       sequenceable parameters - see above) you now take will be 
1782       recorded into the song list. Press <emphasis>Stop</emphasis> and 
1783       <emphasis>Play</emphasis> again to see/hear how terminatorX plays 
1784       back the events recorded before. You can now record events again 
1785       for e.g. another turntable or record other parameters for the 
1786       same turntable - whatever you want to do. Recording events for 
1787       parameters for which events have been recorded before will result 
1788       in dubbing: if you touch a parameter while recording, events 
1789       previously recorded will be erased from the moment you touch the 
1790       parameter until you stop recording.</para>
1791
1792       <para>When recording long sequences/songs you can use the 
1793       sequencer-scale to start recording/playback from any 
1794       song-position you want. To record a single parameter value at a 
1795       certain position simply move the sequencer-scale to that 
1796       position, press <emphasis>Record,</emphasis> set the parameter 
1797       and press <emphasis>Stop</emphasis> again.</para>
1798
1799       <para>To selectively delete events from the sequencer see 
1800       <xref linkend="SEQUENCERMENU"/> and 
1801       <xref linkend="PARAMETERMENU"/>.</para>
1802
1803     </sect2>
1804
1805     <sect2 id="LADSPAPLUGINS">
1806
1807       <title>Plugins (LADSPA)</title>
1808
1809       <para>Since release 3.70 terminatorX supports LADSPA-plugins. 
1810       LADSPA is the "Linux Audio Developer's Simple Plugin API" which 
1811       was designed by developers on the 
1812       Linux-Audio-Developer-Mailinglist and is maintained by Richard 
1813       W.E. Furse. For more information on LADSPA, other LADSPA-hosts 
1814       and LADSPA-plugins checkout the 
1815       <ulink url="http://www.ladspa.org">LADSPA homepage</ulink>.</para>
1816
1817       <para>Not every plugin is supported by terminatorX though. As the 
1818       plugins are inserted into the per-turntable effect-queue, they 
1819       have to be mono or (as of Version 3.82) stereo plugins. This is 
1820       why terminatorX will load plugins with <emphasis>one</emphasis> 
1821       or <emphasis>two</emphasis> audio-in ports and 
1822       <emphasis>one</emphasis> or <emphasis>two</emphasis> audio-out 
1823       ports only.</para>
1824
1825       <para>The decision on whether a plugin is terminatorX-suitable is 
1826       made on terminatorX startup, so only plugins that fit into the 
1827       effect queue will be offered in the mono plugin-menu that pops up 
1828       when the <emphasis>FX</emphasis> button is clicked or in the 
1829       stereo plugin menu when the <emphasis>Stereo FX</emphasis> button 
1830       si clicked. Depending on whether the terminatorX binary you're 
1831       using was built with or without liblrdf ( 
1832       <xref linkend="LIBLRDF"/>) support the plugin menu will either 
1833       contain sub-menus with plugin categories (with liblrdf) or just a 
1834       single menu with the <emphasis>Unclassified</emphasis> 
1835       category.</para>
1836
1837       <para>On startup terminatorX will print some information on the 
1838       LADSPA-plugins analysis process to the standard output if you 
1839       have enabled "Verbose Plugin Loading" in the Preferences dialog. 
1840       Watch the terminal you run terminatorX from for that info if you 
1841       have problems loading a plugin.</para>
1842
1843       <para>As specified in the LADSPA-standard LADSPA-plugins can be 
1844       located in multiple directories across the filesystem. To enable 
1845       LADSPA-hosts to find those plugins you have to set the 
1846       environment variable <envar>LADSPA_PATH</envar> accordingly. 
1847       Let's say you store your plugins in <filename>
1848       /usr/lib/ladspa</filename> and <filename>
1849       /home/yourlogin/plugins</filename> then you would have to 
1850       set:</para>
1851
1852       <para><envar>LADSPA_PATH</envar>= <filename>
1853       /usr/lib/ladspa:/home/yourlogin/plugins</filename></para>
1854
1855       <para>As a fallback terminatorX will look in the standard 
1856       directories <filename>/usr/lib/ladspa</filename> and <filename>
1857       /usr/local/lib/ladspa</filename> if the environment variable is 
1858       not set. Note that this is just a convenience-function, in order 
1859       for other LADSPA-hosts to work properly, be sure to set your 
1860       <envar>LADSPA_PATH</envar> correctly. It is a good idea to do 
1861       that from somewhere in your system configuration (either in your 
1862       rc-scripts or <filename>/etc/profile</filename> or wherever you 
1863       prefer).</para>
1864
1865       <sect3 id="LIBLRDF">
1866
1867         <title>liblrdf support</title>
1868
1869         <para>Release 3.80 introduces support for Steve Harris' great 
1870         <ulink url="http://plugin.org.uk/releases/lrdf/">
1871         liblrdf</ulink> library which introduces an RDF based scheme to 
1872         categorize LADSPA plugins. This approach allows storing 
1873         additional meta-data for LADSPA plugins in separate RDF files. 
1874         In order to make use of these RDF files a terminatorX binary 
1875         (compiled with liblrdf support of course) requires the main 
1876         <filename>ladspa.rdfs</filename> file and additional RDF files 
1877         containing meta information about the LADSPA plugins installed. 
1878         Steve Harris' wonderful plugin library comes with such an 
1879         additional description file for example.</para>
1880
1881         <para>By default terminatorX will search the directories 
1882         <filename>/usr/share/ladspa/rdf</filename> and <filename>
1883         /usr/local/share/ladspa/rdf</filename> for RDF files. In case 
1884         the files were installed to other locations it is possible to 
1885         configure the LADSPA RDF path in the <emphasis>Misc</emphasis> 
1886         tab of the <emphasis>Preferences</emphasis> dialog.</para>
1887
1888         <para>If the RDF are read successfully on startup, the LADSPA 
1889         menu that pops up when clicking a turntable's 
1890         <emphasis>FX</emphasis> button will feature multiple sub-menus 
1891         with LADSPA plugin categories (eg 
1892         <emphasis>Amplitude/Amplifier</emphasis>) in which you will 
1893         find the according plugins. Plugins not categorized by the RDF 
1894         files reside in the <emphasis>Unclassified</emphasis> 
1895         menu.</para>
1896
1897       </sect3>
1898
1899     </sect2>
1900
1901     <sect2 id="MIDI">
1902
1903       <title>MIDI Interface</title>
1904
1905       <para>Aside of controlling terminatorX with a regular mouse and 
1906       keyboard it is possible to control parameters through MIDI events 
1907       (since 3.80). The MIDI interface is based upon the ALSA sequencer 
1908       API. On startup terminatorX creates a MIDI input port called 
1909       "terminatorX". You can now use for example the 
1910       <ulink url="http://pkl.net/%7Enode/alsa-patch-bay.html">
1911       alsa-patch-pay</ulink> to connect an output port of your choice 
1912       (either a hardware MIDI input device or a software generating 
1913       midi events) to the terminatorX input port. If the 
1914       "<emphasis>Restore MIDI Connections</emphasis>" option is 
1915       activated terminatorX will try to re-connect to the MIDI ports it 
1916       was connected to with the last run. However this approach is 
1917       purely address-based and might fail miserably with software 
1918       ports, in this case just disable the configuration options 
1919       re-wire manually.</para>
1920
1921       <para>
1922
1923         There are two ways to map MIDI events to a parameter:
1924         <itemizedlist>
1925
1926           <listitem>
1927
1928             <para>Via the <emphasis>Configure MIDI Bindings</emphasis> 
1929             dialog as described below</para>
1930
1931           </listitem>
1932
1933           <listitem>
1934
1935             <para>Via the the a parameter's menu (see 
1936             <xref linkend="PARAMETERMENU"/>)</para>
1937
1938           </listitem>
1939
1940         </itemizedlist>
1941
1942       </para>
1943
1944       <para>Once the connection is set up terminatorX receives MIDI 
1945       events through the input port. To configure what MIDI events will 
1946       have which effect on a terminatorX turntable you can bind MIDI 
1947       events to parameters of your choice by clicking the 
1948       <emphasis>MIDI</emphasis> button of the turntable's audio panel. 
1949       As a result the <emphasis>Configure MIDI Bindings</emphasis> 
1950       dialog will pop up which features a field labelled 
1951       <emphasis>Selected MIDI Event</emphasis> that will frequently 
1952       update to display the contents of the last MIDI event received by 
1953       terminatorX. So in order to map a MIDI controller to a specific 
1954       turntable parameter select the parameter of your choice from the 
1955       parameter list, cause your MIDI event sending device to emit the 
1956       event you want to map the parameter on and click the 
1957       <emphasis>Bind</emphasis> button.</para>
1958
1959       <para>Immediately after binding the event you should see that the 
1960       <emphasis>Event</emphasis> column entry of the selected parameter 
1961       is updated to match the selected event. From now on all events 
1962       matching the selected event will cause the turntable parameter to 
1963       be updated. The GUI for that parameter will be refreshed 
1964       accordingly. Note that it is possible to map the same event to 
1965       multiple parameters.</para>
1966
1967       <para>The MIDI mappings are stored within terminatorX set files 
1968       so you wont have to reconfigure your bindings every time you 
1969       start up terminatorX. If you are unhappy with a chosen binding 
1970       you can select the parameter and click the <emphasis>Remove 
1971       Binding</emphasis> button to get rid of the parameter's MIDI 
1972       mapping.</para>
1973
1974       <para>TeriminatorX now features a default MIDI mapping that can 
1975       be enabled via the <emphasis>Turntables Menu</emphasis> (see 
1976       <xref linkend="TURNTABLESMENU"/>). The controllers are mapped in 
1977       a one channel per turntable fashion:</para>
1978
1979       <table>
1980
1981         <title>Default MIDI Controller Mapping</title>
1982
1983         <tgroup cols="3">
1984
1985           <thead>
1986
1987             <row><entry>Turntable Parameter</entry><entry>MIDI 
1988             Controller</entry><entry>MIDI CC Name</entry></row>
1989
1990           </thead>
1991
1992           <tbody>
1993
1994             <row><entry>Volume</entry><entry>7</entry><entry><quote>Main 
1995             Volume</quote></entry></row>
1996
1997             <row><entry>Pan</entry><entry>10</entry><entry><quote>Pan</quote></entry></row>
1998
1999             <row><entry>Lowpass Cutoff 
2000             Frequency</entry><entry>12</entry><entry><quote>Effect 
2001             Control 1</quote></entry></row>
2002
2003             <row><entry>Lowpass 
2004             Resonance</entry><entry>13</entry><entry><quote>Effect 
2005             Control 2</quote></entry></row>
2006
2007             <row><entry>Lowpass 
2008             Gain</entry><entry>16</entry><entry><quote>General Purpose 
2009             Controller 1</quote></entry></row>
2010
2011             <row><entry>Speed</entry><entry>17</entry><entry><quote>General 
2012             Purpose Controller 2</quote></entry></row>
2013
2014             <row><entry>Pitch</entry><entry>18</entry><entry><quote>General 
2015             Purpose Controller 3</quote></entry></row>
2016
2017             <row><entry>Sync 
2018             Cycles</entry><entry>19</entry><entry><quote>General 
2019             Purpose Controller 4</quote></entry></row>
2020
2021             <row><entry>Echo 
2022             Length</entry><entry>75</entry><entry><quote>Sound 
2023             Controller 6</quote></entry></row>
2024
2025             <row><entry>Echo 
2026             Feedback</entry><entry>76</entry><entry><quote>Sound 
2027             Controller 7</quote></entry></row>
2028
2029             <row><entry>Echo 
2030             Volume</entry><entry>77</entry><entry><quote>Sound 
2031             Controller 8</quote></entry></row>
2032
2033             <row><entry>Echo 
2034             Pan</entry><entry>78</entry><entry><quote>Sound Controller 
2035             9</quote></entry></row>
2036
2037           </tbody>
2038
2039         </tgroup>
2040
2041       </table>
2042
2043       <para>The toggle parameters of a turntable (where things can only 
2044       be turned on or off) are mapped to MIDI NOTE events, where the 
2045       first turntable is mapped to 'C', the next to 'C#', the next to 
2046       'D' and so on. The "function" of the toggle is defined via the 
2047       selected MIDI channel:</para>
2048
2049       <table>
2050
2051         <title>Default MIDI Note On/Off Mapping</title>
2052
2053         <tgroup cols="2">
2054
2055           <thead>
2056
2057             <row><entry>Turntable Parameter</entry><entry>MIDI 
2058             Channel</entry></row>
2059
2060           </thead>
2061
2062           <tbody>
2063
2064             <row><entry>Trigger</entry><entry>0</entry></row>
2065
2066             <row><entry>Sync Client</entry><entry>1</entry></row>
2067
2068             <row><entry>Loop</entry><entry>2</entry></row>
2069
2070             <row><entry>Lowpass Enable</entry><entry>3</entry></row>
2071
2072             <row><entry>Echo Enable</entry><entry>4</entry></row>
2073
2074             <row><entry>Mute</entry><entry>5</entry></row>
2075
2076             <row><entry>Motor Spin On/Off</entry><entry>6</entry></row>
2077
2078           </tbody>
2079
2080         </tgroup>
2081
2082       </table>
2083
2084       <para>If you want to use your joystick to control terminatorX - I 
2085       wrote a tiny tool to create MIDI events from joystick motion 
2086       called <emphasis>aseqjoy</emphasis>. It's available from the 
2087       <ulink url="http://terminatorX.org/aseqjoy.html">terminatorX 
2088       website</ulink>, too.</para>
2089
2090     </sect2>
2091
2092     <sect2 id="JACKSUPPORT">
2093
2094       <title>JACK Support</title>
2095
2096       <para>TerminatorX Version 3.81 brings support for the 
2097       <emphasis>JACK Audio Connection Kit</emphasis>. Instead of 
2098       writing audio data directly to some audio device terminatorX can 
2099       send data to the JACK Daemon for further processing.</para>
2100
2101       <para>To use the JACK backend you have to ensure that the JACK 
2102       Daemon is up and running before you start terminatorX. The JACK 
2103       backend is only available if terminatorX was capable of 
2104       connecting to the JACK Daemon on startup. By default the two 
2105       output ports of terminatorX will be connected to physical ports 
2106       if available. You can then re-wire the ports whatever way you 
2107       want. They will not be deactivated - when terminatorX' audio 
2108       engine is turned off, the audio backend emits continuous 
2109       silence.</para>
2110
2111     </sect2>
2112
2113   </sect1>
2114
2115   <sect1 id="CONFIGURATION">
2116
2117     <title>Configuration</title>
2118
2119     <para>The main terminatorX configuration parameters can be set up 
2120     via the <emphasis>Preferences</emphasis> dialog, which can be 
2121     activated from the terminatorX menu. The new 
2122     <emphasis>Preferences</emphasis> dialog features multiple tabs for 
2123     several aspects of configuration.</para>
2124
2125     <para>A word on the settings in general: your settings are stored 
2126     in an XML file ( <filename>~/.terminatorXrc</filename>). So if you 
2127     think you completely messed up your settings you will have to exit 
2128     terminatorX - delete this file - and then re-run terminatorX with 
2129     the default settings. Note: is this file is now an XML file you can 
2130     edit with an editor of your choice.</para>
2131
2132     <sect2 id="AUDIOTAB">
2133
2134       <title><emphasis>Audio</emphasis> Tab</title>
2135
2136       <para>This tab allows to select which audio backend terminatorX 
2137                                 should use and to set the parameters foor the different backebds. 
2138                                 Currently there are fouroptions: the OSS (Open 
2139       Sound System) backend, the ALSA (Advanced Linux Sound 
2140       Architecture) backend, the JACK (JACK Audio Connection Kit) 
2141                         backend and the PulseAudio backend. Some of these options might not 
2142                         be available, if your terminatorX binary wasn't compiled to support 
2143                         a certain backend.</para>
2144
2145       <para>The OSS and ALSA backends have dedicated configuration 
2146       tabs, JACK requires no further configuration - for more details 
2147       on JACK support see <xref linkend="JACKSUPPORT"/>.</para>
2148
2149     </sect2>
2150
2151     <sect2 id="OSSTAB">
2152
2153       <title><emphasis>Audio</emphasis> Tab - OSS parameters</title>
2154
2155       <para>Select the audio device you are going to use from the 
2156       available options (or simply enter one yourself). terminatorX 
2157       renders audio block-wise. In order to achieve close-to-realtime 
2158       performance it is necessary to keep this blocks as small as 
2159       possible. The main parameters that determine how 
2160       close-to-realtime terminatorX will perform are <emphasis>No. of 
2161       Buffers</emphasis> and <emphasis>Buffersize</emphasis>. The 
2162       <emphasis>No. of Buffers</emphasis> parameter determines how many 
2163       buffers the audio driver should use in most cases 
2164       <emphasis>2</emphasis> should be the best setting and in rare 
2165       cases <emphasis>3</emphasis> might give better results.</para>
2166
2167       <para>The value for the <emphasis>Buffersize</emphasis> setting 
2168       will be evaluated as 2^buffersize by OSS. So if you set the value 
2169       to <emphasis>8</emphasis> the actual buffer size will be 2^8=256 
2170       Bytes. The smaller the buffers' size the better terminatorX will 
2171       perform. The default setting of <emphasis>9</emphasis> should be 
2172       acceptable in most conditions, but if you here "clicks", or 
2173       "drops" in audio output that are not related to your 
2174       sample-material you will have to increase the buffer size. On the 
2175       other hand if you believe terminatorX does not react fast enough 
2176       you have to decrease this parameter.</para>
2177
2178       <para>Additionally you can select the sampling rate you want 
2179       terminatorX to operate on - note that recording to disk will use 
2180       the same sample rate.</para>
2181
2182     </sect2>
2183
2184     <sect2 id="ALSATAB">
2185
2186       <title><emphasis>Audio</emphasis> Tab - ALSA parameters</title>
2187
2188       <para>Using ALSA for audio output allows specifing the buffer 
2189       sizes in microseconds. ALSA uses a ring-buffer to process audio. 
2190       The <emphasis>Buffer Time</emphasis> option lets you set the size 
2191       for the complete ring buffer, while the <emphasis>Period 
2192       Time</emphasis> determines how many audio samples will be 
2193       transferred to the audio device per cycle. I'm not really sure on 
2194       what kind of settings to recommend, however I had best results 
2195       when setting the <emphasis>Period Time</emphasis> to 3rd or half 
2196       of the <emphasis>Buffer Time</emphasis>.</para>
2197
2198       <para>It's advisable to set the <emphasis>Buffer Time</emphasis> 
2199       to at least the double of the <emphasis>Period Time</emphasis>, 
2200       but for a more detailed description check out the ALSA 
2201       documentation.</para>
2202
2203     </sect2>
2204
2205                 <sect2 id="PULSEAUDIOPARAMS">
2206                         <title><emphasis>Audio</emphasis> Tab - PulseAudio parameters</title>
2207
2208                         <para>The PulseAudio backend currently provides only a single
2209                                 configuration option: <emphasis>PulseAudio Buffer</emphasis>. This 
2210                                 parameter defines the buffer size in samples that terminatorX
2211                                 requests when connecting to the PulseAudio daemon. Note that 
2212                                 PulseAudio may override this value, you can run pulseaudio manually
2213                                 (pulseaudio -v) to trace what latency PulseAudio will actually
2214                                 achieve.
2215                         </para>
2216                         <para>
2217                                 The buffer size is configured in samples (the size in bytes will
2218                                 samples * 4), for optimal latency this value should be as low
2219                                 as possible. If you experience underruns or other artifacts in
2220                                 the audio output try increasing the buffer size.
2221                         </para>
2222
2223                 </sect2>
2224
2225     <sect2 id="INPUTTAB">
2226
2227       <title><emphasis>Input</emphasis> Tab</title>
2228
2229       <para>Between rendering and outputting these blocks terminatorX 
2230       checks for mouse motion. The problem with mice is: they don't 
2231       report when they have stopped. This is why terminatorX assumes 
2232       your mouse has stopped if there is no motion reported for certain 
2233       amount of render/output-cycles. This value is configurable via 
2234       the <emphasis>Stop-sense-cycles</emphasis> option. If you 
2235       decrease your buffersize of course you shorten the cycle time as 
2236       well, therefore if you here strange stop/run behaviour of the 
2237       audio output while scratching after you decreased the buffer size 
2238       you might have to increase the stop-sense value too.</para>
2239
2240       <para>XInput Device: <emphasis>WARNING:</emphasis> Use this 
2241       option *only* if you want to use an input device other than your 
2242       default-mouse for scratching. Selecting your default pointer will 
2243       cause terminatorX to crash. See the "Using a turntable" section 
2244       on the terminatorX homepage for details.</para>
2245
2246     </sect2>
2247
2248     <sect2 id="USERINTERFACETAB">
2249
2250       <title><emphasis>User Interface</emphasis> Tab</title>
2251
2252       <para>With <emphasis>Update Idle</emphasis> / <emphasis>Update 
2253       Delay</emphasis> you can configure GUI responsiveness: Higher 
2254       <emphasis>Update Idle</emphasis> will cause the wave display 
2255       (position display) and flash-widgets to update less often. Higher 
2256       <emphasis>Update Delay</emphasis> values will cause the parameter 
2257       widgets to update less often.</para>
2258
2259     </sect2>
2260
2261     <sect2 id="colors">
2262
2263       <title><emphasis>Audio Colors</emphasis> and <emphasis>VU 
2264       Colors</emphasis> Tab</title>
2265
2266       <para>Since Version 3.81 it is possible to configure the colors 
2267       terminatorX' audio widgets. Simply click on the color you want to 
2268       modify and select the tone you prefer.</para>
2269
2270     </sect2>
2271
2272     <sect2 id="MISCTAB">
2273
2274       <title><emphasis>Misc</emphasis> Tab</title>
2275
2276       <para>You can now enter the soundfile editor of your choice in 
2277       the "Sound file editor" field. This editor will be started when 
2278       clicking the <emphasis>Edit</emphasis>-button in the main panel 
2279       of the vtt-gui. If you enter for example "myeditor" terminatorX 
2280       will run "myeditor sample_in_vtt.wav".</para>
2281
2282       <para>The <emphasis>LADSPA RDF Path</emphasis> defines where 
2283       liblrdf will look for the RDF files for LADPSA Plugins.</para>
2284
2285       <para>If <emphasis>Compress set files</emphasis> is activated 
2286       terminatorX will use zlib to compress set files. This is very 
2287       usefull for sets that have many events recorded.</para>
2288
2289       <para>See <xref linkend="MIDI"/> for more details on 
2290       <emphasis>Restore MIDI Connections</emphasis>. If you disable the 
2291       <emphasis>Ask for "Quit" Confirmation</emphasis> option 
2292       terminatorX will no longer ask if you really want to quit.</para>
2293
2294     </sect2>
2295
2296   </sect1>
2297
2298   <sect1 id="CONTACT">
2299
2300     <title>Contact / Download</title>
2301
2302     <para>Find out more about terminatorX at it's 
2303     <ulink url="http://terminatorX.org">homepage</ulink>.</para>
2304
2305     <para>Send me comments, bug-reports, patches or scratches (see 
2306     scratches section on the terminatorX homepage) at: 
2307     <email>alex@lisas.de</email></para>
2308
2309   </sect1>
2310
2311 </article>
2312