]> Shamusworld >> Repos - ardour-manual/blob - include/clip-launch-options.html
Cue: document launch style, launch quantize, and legato
[ardour-manual] / include / clip-launch-options.html
1 <h2>Velocity Sense</h2>
2
3 <p>
4   This control defines how much the velocity coming off your MIDI device
5   affects clip's volume. At 0%, which is the default, it doesn't matter how
6   hard you press a key or a pad, the volume will be what you set it to.
7   At 100%, hitting a key as hard as you can produces maximum volume, and
8   pressing the key or a pad really softly produces a barely audible sound.
9 </p>
10
11 <h2>Launch Style</h2>
12
13 <p>
14   The <dfn>Launch Style</dfn> defines how you interact with the clip's
15   playback. Ardour makes a distinction between pressing a button or a key
16   (the 'down' event for a mouse or the note-on MIDI event) and releasing
17   a button or a key (the 'up' event for a mouse or the note-off MIDI event).
18 </p>
19
20 <p>
21   You can setup a trigger slot so that you would press a silicon pad on your
22   external grid controller, and Ardour would play the clip in that slot
23   indefinitely on repeat. Or you could set it up so that it would only repeat
24   that clip as long as you are keeping the pad pressed and stop playing it
25   as soon as you stop pressing the pad.
26 </p>
27
28 <table>
29   <tr>
30     <th><kbd class="menu">Trigger</kbd></th>
31     <td width="100px"><img src="/images/launch-style-icons-trigger.png" /></td>
32     <td>Clicking will trigger the playback of a clip. Further clicks, as well
33     as mouse up and note-off events will be ignored.</td></tr>
34   <tr>
35     <th><kbd class="menu">Retrigger</kbd></th>
36     <td width="100px"><img src="/images/launch-style-icons-retrigger.png" /></td>
37     <td>Clicking will trigger the playback of a clip. Another click will restart
38     (retrigger) the playback from the beginning, quantization will be taken into
39     consideration. Mouse up and note-off events will be ignored.</td></tr>
40   <tr>
41     <th><kbd class="menu">Gate</kbd></th>
42     <td width="100px"><img src="/images/launch-style-icons-gate.png" /></td>
43     <td>The clip will be played back as long as you keep the mouse button
44     or the MIDI key/pad pressed. Quantization defines how soon playback starts
45     after pressing the button/key down and ends after releasing the button/key.
46     </td>
47   </tr>
48   <tr>
49     <th><kbd class="menu">Toggle</kbd></th>
50     <td width="100px"><img src="/images/launch-style-icons-toggle.png" /></td>
51     <td>The clip will keep playing until you click the button again or send
52     another note-on event from your MIDI device</td>
53   </tr>
54   <tr>
55     <th><kbd class="menu">Repeat</kbd></th>
56     <td width="100px"><img src="/images/launch-style-icons-repeat.png" /></td>
57     <td>The contents of the clip will be played to the extent of the quantization setting.</td>
58   </tr>
59 </table>
60
61 <h2>Launch Quantize</h2>
62
63 <p>
64   This setting defines how long Ardour will wait till beginning the playback
65   of a clip in a trigger slot. If the transport is already rolling, and
66   quantization is set to 1 bar, which is the default, Ardour will wait for the
67   next bar, then start playing the clip. Quantizing to a whole bar or several
68   bars typically guarantees that downbeats of a drums track and a bassline
69   track align.
70 </p>
71
72 <p>
73   The quantization value can be as large as 4 bars and as small as 1/64 bar.
74   When 'None' is selected, playback with a rolling transport will start
75   immediately.
76 </p>
77
78 <h2>Legato</h2>
79
80 <p>
81   The <dfn>Legato</dfn> mode helps keeping two clips of the same track in sync
82   when you switch from one to another. With Legato on, Ardour will pick up
83   the playback of the second clip at the position where the first one left off.
84   Please note that quantization applies here.
85 </p>
86
87 <h2>Cue Isolate</h2>
88
89 <p>FIXME, If selected, the slot will not respond to start/stop cue events (does it work?)</p>
90
91 <h2 id="follow-options">Follow Options</h2>
92
93 <p>
94   FIXME. These options are where you define the transition from one slot to another.
95 </p>