Add the ardour manual converted to docbook format with only a few minor
[ardour.git] / manual / xml / frontier_design_tranzport.xml
1 <?xml version="1.0" standalone="no"?>
2
3 <!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
4
5 ]>
6
7 <section id="sn-frontier-design-tranzport">
8         <title>Using a Frontier Design Tranzport</title>
9         <section id="tranzport-configuration">
10                 <title>Enabling a Tranzport</title>
11                 <para>
12                         Ardour 2.0 can currently use a single Tranzport controller. Ensure that the
13                         device is plugged into a functional USB port. On Linux you will need to
14                         <link linkend="sn-configuring-usb-device-access">take steps</link>
15                         to ensure that non-administrative users can access the device. Note that
16                         this feature is <emphasis>not</emphasis> available in Ardour 0.99.x.
17                 </para>
18
19                 <para>
20                         In the Options menu, navigate into the Control Surfaces submenu. Click on
21                         the "Tranzport" option to enable use of the control surface within Ardour.
22                         To disable it, click on this item a second time.
23                 </para>
24         </section>
25
26         <section id="tranzport-buttons-and-wheel-functions">
27                 <title>Tranzport Buttons and Datawheel functions</title>
28                 <table id="tbl-tranzport-functions">
29                         <title>Tranzport Functions</title>
30                         <tgroup cols = "3">
31                                 <colspec colnum="1" colname = "Key Binding" colwidth = "1"/>
32                                 <colspec colnum="2" colname="Action" colwidth= "2"/>
33                                 <thead>
34                                         <row>
35                                                 <entry>
36                                                         Key
37                                                 </entry>
38                                                 <entry>
39                                                         Normal Click
40                                                 </entry>
41                                                 <entry>
42                                                         Shift Click
43                                                 </entry>
44                                         </row>
45                                 </thead>
46                                 <tbody>
47                                         <row>
48                                                 <entry>
49                                                         <para>
50                                                                 REW
51                                                         </para>
52                                                 </entry>
53                                                 <entry>
54                                                         <para>
55                                                                 Rewind
56                                                         </para>
57                                                 </entry>
58                                                 <entry>
59                                                         <para>
60                                                                 Go to start
61                                                         </para>
62                                                 </entry>
63                                         </row>
64                                         <row>
65                                                 <entry>
66                                                         <para>
67                                                                 FFWD
68                                                         </para>
69                                                 </entry>
70                                                 <entry>
71                                                         <para>
72                                                                 Fast forward
73                                                         </para>
74                                                 </entry>
75                                                 <entry>
76                                                         <para>
77                                                                 Go to end
78                                                         </para>
79                                                 </entry>
80                                         </row>
81                                         <row>
82                                                 <entry>
83                                                         <para>
84                                                                 STOP
85                                                         </para>
86                                                 </entry>
87                                                 <entry>
88                                                         <para>
89                                                                 Stop
90                                                         </para>
91                                                 </entry>
92                                                 <entry>
93                                                         <para>
94                                                                 Enter *
95                                                         </para>
96                                                 </entry>
97                                         </row>
98                                         <row>
99                                                 <entry>
100                                                         <para>
101                                                                 PLAY
102                                                         </para>
103                                                 </entry>
104                                                 <entry>
105                                                         <para>
106                                                                 Play
107                                                         </para>
108                                                 </entry>
109                                                 <entry>
110                                                         <para>
111                                                                 Save
112                                                         </para>
113                                                 </entry>
114                                         </row>
115                                         <row>
116                                                 <entry>
117                                                         <para>
118                                                                 RECORD
119                                                         </para>
120                                                 </entry>
121                                                 <entry>
122                                                         <para>
123                                                                 Record
124                                                         </para>
125                                                 </entry>
126                                                 <entry>
127                                                         <para></para>
128                                                 </entry>
129                                         </row>
130                                         <row>
131                                                 <entry></entry>
132                                                 <entry></entry>
133                                                 <entry></entry>
134                                         </row>
135                                         <row>
136                                                 <entry>
137                                                         <para>
138                                                                 PREV
139                                                         </para>
140                                                 </entry>
141                                                 <entry>
142                                                         <para>
143                                                                 Go to previous marker
144                                                         </para>
145                                                 </entry>
146                                                 <entry>
147                                                         <para>
148                                                                 Zoom full
149                                                         </para>
150                                                 </entry>
151                                         </row>
152                                         <row>
153                                                 <entry>
154                                                         <para>
155                                                                 ADD
156                                                         </para>
157                                                 </entry>
158                                                 <entry>
159                                                         <para>
160                                                                 Add marker at current location
161                                                         </para>
162                                                 </entry>
163                                                 <entry>
164                                                         <para></para>
165                                                 </entry>
166                                         </row>
167                                         <row>
168                                                 <entry>
169                                                         <para>
170                                                                 NEXT
171                                                         </para>
172                                                 </entry>
173                                                 <entry>
174                                                         <para>
175                                                                 Go to next marker
176                                                         </para>
177                                                 </entry>
178                                                 <entry>
179                                                         <para>
180                                                                 Select normal, scrub or shuttle mode
181                                                         </para>
182                                                 </entry>
183                                         </row>
184                                         <row>
185                                                 <entry></entry>
186                                                 <entry></entry>
187                                                 <entry></entry>
188                                         </row>
189                                         <row>
190                                                 <entry>
191                                                         <para>
192                                                                 IN
193                                                         </para>
194                                                 </entry>
195                                                 <entry>
196                                                         <para></para>
197                                                 </entry>
198                                                 <entry>
199                                                         <para>
200                                                                 Zoom In
201                                                         </para>
202                                                 </entry>
203                                         </row>
204                                         <row>
205                                                 <entry>
206                                                         <para>
207                                                                 OUT
208                                                         </para>
209                                                 </entry>
210                                                 <entry>
211                                                         <para></para>
212                                                 </entry>
213                                                 <entry>
214                                                         <para>
215                                                                 Zoom Out
216                                                         </para>
217                                                 </entry>
218                                         </row>
219                                         <row>
220                                                 <entry>
221                                                         <para>
222                                                                 PUNCH
223                                                         </para>
224                                                 </entry>
225                                                 <entry>
226                                                         <para></para>
227                                                 </entry>
228                                                 <entry>
229                                                         <para></para>
230                                                 </entry>
231                                         </row>
232                                         <row>
233                                                 <entry>
234                                                         <para>
235                                                                 LOOP
236                                                         </para>
237                                                 </entry>
238                                                 <entry>
239                                                         <para></para>
240                                                 </entry>
241                                                 <entry>
242                                                         <para>
243                                                                 Select gain/pan/master level mode
244                                                         </para>
245                                                 </entry>
246                                         </row>
247                                         <row>
248                                                 <entry></entry>
249                                                 <entry></entry>
250                                                 <entry></entry>
251                                         </row>
252                                         <row>
253                                                 <entry>
254                                                         <para>
255                                                                 &lt; TRACK
256                                                         </para>
257                                                 </entry>
258                                                 <entry>
259                                                         <para>
260                                                                 Previous track
261                                                         </para>
262                                                 </entry>
263                                                 <entry>
264                                                         <para></para>
265                                                 </entry>
266                                         </row>
267                                         <row>
268                                                 <entry>
269                                                         <para>
270                                                                 TRACK &gt;
271                                                         </para>
272                                                 </entry>
273                                                 <entry>
274                                                         <para>
275                                                                 Next track
276                                                         </para>
277                                                 </entry>
278                                                 <entry>
279                                                         <para></para>
280                                                 </entry>
281                                         </row>
282                                         <row>
283                                                 <entry>
284                                                         <para>
285                                                                 REC
286                                                         </para>
287                                                 </entry>
288                                                 <entry>
289                                                         <para>
290                                                                 Toggle track's record enable on/off
291                                                         </para>
292                                                 </entry>
293                                                 <entry>
294                                                         <para>
295                                                                 Clear all track record arming
296                                                         </para>
297                                                 </entry>
298                                         </row>
299                                         <row>
300                                                 <entry>
301                                                         <para>
302                                                                 MUTE
303                                                         </para>
304                                                 </entry>
305                                                 <entry>
306                                                         <para>
307                                                                 Toggle track's mute status on/off
308                                                         </para>
309                                                 </entry>
310                                                 <entry>
311                                                         <para>
312                                                                 Clear all mutes
313                                                         </para>
314                                                 </entry>
315                                         </row>
316                                         <row>
317                                                 <entry>
318                                                         <para>
319                                                                 SOLO
320                                                         </para>
321                                                 </entry>
322                                                 <entry>
323                                                         <para>
324                                                                 Toggle track's solo status on/off
325                                                         </para>
326                                                 </entry>
327                                                 <entry>
328                                                         <para>
329                                                                 Clear all solos
330                                                         </para>
331                                                 </entry>
332                                         </row>
333                                         <row>
334                                                 <entry>
335                                                         <para>
336                                                                 UNDO
337                                                         </para>
338                                                 </entry>
339                                                 <entry>
340                                                         <para>
341                                                                 Undo
342                                                         </para>
343                                                 </entry>
344                                                 <entry>
345                                                         <para>
346                                                                 Redo
347                                                         </para>
348                                                 </entry>
349                                         </row>
350                                         <row>
351                                                 <entry></entry>
352                                                 <entry></entry>
353                                                 <entry></entry>
354                                         </row>
355                                         <row>
356                                                 <entry>
357                                                         <para>
358                                                                 DATA WHEEL
359                                                         </para>
360                                                 </entry>
361                                                 <entry>
362                                                         <para>
363                                                                 scroll timeline, scrub or shuttle
364                                                         </para>
365                                                 </entry>
366                                                 <entry>
367                                                         <para>
368                                                                 adjust track gain, track pan or master gain
369                                                         </para>
370                                                 </entry>
371                                         </row>
372                                         <row>
373                                                 <entry></entry>
374                                                 <entry></entry>
375                                                 <entry></entry>
376                                         </row>
377                                         <row>
378                                                 <entry>
379                                                         <para>
380                                                                 FOOTSWITCH
381                                                         </para>
382                                                 </entry>
383                                                 <entry>
384                                                         <para></para>
385                                                 </entry>
386                                                 <entry>
387                                                         <para></para>
388                                                 </entry>
389                                         </row>
390                                 </tbody>
391                         </tgroup>
392                 </table>
393         </section>
394
395         <section id="tranzport-normal-scrub-shuttle-modes">
396                 <title>Normal, Scrub and Shuttle Modes</title>
397                 <para>
398                         In Ardour, the Tranzport in has 3 different modes of operation termed
399                         "timeline", "scrub" and "shuttle".
400                 </para>
401
402                 <variablelist>
403                         <title>Tranzport Modes of Operation</title>
404                         <varlistentry>
405                                 <term>Timeline</term>
406                                 <listitem>
407                                         <para>
408                                                 the data wheel scrolls the timeline in the editor window back and forth.
409                                         </para>
410                                 </listitem>
411                         </varlistentry>
412
413                         <varlistentry>
414                                 <term>Scrub</term>
415                                 <listitem>
416                                         <para>
417                                                 the data wheel is used to scrub audio data back and forth.
418                                         </para>
419                                 </listitem>
420                         </varlistentry>
421
422                         <varlistentry>
423                                 <term>Shuttle</term>
424                                 <listitem>
425                                         <para>
426                                                 the data wheel is used to control varispeed playback. Turning the data
427                                                 wheel clockwise increases the playback speed in a forward direction.
428                                                 Counter-clockwise decreases the speed and will reverse playback. Shuttle
429                                                 mode as several important features:
430                                                 <itemizedlist>
431                                                         <listitem>
432                                                                 <para>
433                                                                         While in Shuttle mode the actual playback speed will be displayed in
434                                                                         the top right corner of the LCD as a percentage of real-time, ie.
435                                                                         +100% is normal playback speed.
436                                                                 </para>
437                                                         </listitem>
438                                                         <listitem>
439                                                                 <para>
440                                                                         Press STOP to automatically set the Shuttle speed to 0%.
441                                                                 </para>
442                                                         </listitem>
443                                                         <listitem>
444                                                                 <para>
445                                                                         Press PLAY to automatically set the Shuttle speed to +100%.
446                                                                 </para>
447                                                         </listitem>
448                                                         <listitem>
449                                                                 <para>
450                                                                         Press and hold SHIFT to momentarily toggle the TranzPort into Scrub
451                                                                         mode. Releasing the SHIFT button will return to Shuttle mode at 0%
452                                                                         speed. This combination of functions is very useful for quickly
453                                                                         moving through an audio track and accurately locating points hit
454                                                                         points.
455                                                                 </para>
456                                                         </listitem>
457                                                         <listitem>
458                                                                 <para>
459                                                                         Pressing ADD will drop a marker at the current location and exit
460                                                                         Shuttle mode
461                                                                 </para>
462                                                         </listitem>
463                                                 </itemizedlist>
464                                         </para>
465                                 </listitem>
466                         </varlistentry>
467                 </variablelist>
468         </section>
469 <!--
470         <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" 
471                 href="Some_Subsection.xml" />
472         -->
473 </section>