]> Shamusworld >> Repos - ardour-manual/blob - include/cue-markers.html
Ruler/Markers rewrite, part 5 of N
[ardour-manual] / include / cue-markers.html
1 <p>
2   <dfn>Cue markers</dfn> allow bridging linear and non-linear approaches to
3   composing music. The idea is that a user can set up entire cues, then place a
4   cue marker on the timeline to launch a cue of choice at a particular point in
5   time. The workflow is explained in more details in the
6   <a href="@@mixing-linear-nonlinear-workflows">Mixing Linear and Non-Linear Workflows</a> section.
7 </p>
8
9 <figure>
10   <img style="width:75%;" width="50%" src="/images/cue-markers-ruler-example.png" alt="Cue Markers Ruler">
11   <figcaption>Cue Markers Ruler</figcaption>
12 </figure>
13
14 <h2>Adding Cue Markers</h2>
15
16 <p>
17   There are several ways to add a cue marker:
18 </p>
19
20 <ul>
21   <li><kbd class="mod1n"></kbd>-click on the ruler creates a marker that
22   launches the A cue.</li>
23   <li><kbd class="mod1n"></kbd>-doubleclick on the rules creates a marker that
24   launches the A cue, then opens the dialog to edit its name</li>
25   <li>Right-click on the ruler opens a menu where A to P markers are listed</li>
26 </ul>
27
28 <figure>
29   <img style="width:50%;" width="50%" src="/images/cue-marker-ruler-right-click-menu.png" alt="Right-click menu for the Cue Markers ruler">
30   <figcaption>Right-click menu for the Cue Markers ruler</figcaption>
31 </figure>
32
33 <h2>Moving Cue Markers</h2>
34
35 <p>
36   <kbd class="mouse">Left</kbd>-clicking and dragging moves a single marker to a
37   new location on the timeline.
38 </p>
39
40 <p>
41   It is possible to move multiple markers by the same distance. <kbd
42   class="mouse mod1">Left</kbd>-clicking each marker creates a selection of
43   markers that can be dragged left or right together.
44 </p>
45
46 <h2>Single marker</h2>
47 <p>
48   <kbd class="mouse">Left</kbd>-clicking and dragging moves a single marker to a
49   new location on the timeline.
50 </p>
51
52 <h2>Multiple markers</h2>
53 <p>
54   It is possible to move multiple markers by the same distance. <kbd
55   class="mouse mod1">Left</kbd>-clicking each discreet marker, or <kbd
56   class="mouse mod3">Left</kbd>-clicking the first and last markers of a range
57   of markers selects them, then dragging one to a new location will move all
58   selected markers together.
59 </p>
60
61 <h2>Stopping All Cues</h2>
62
63 <p>
64   Ardour has a special kind of a marker that immediately stops all playing cues.
65   This marker (<kbd class="menu">Stop All Cues</kbd>) can be added via the
66   right-click menu on the Cue Markers ruler.
67 </p>
68
69 <h2>Removing Cue Markers</h2>
70
71 <p>
72   Right-clicking on an existing cue marker opens the context menu with a number
73   of options. Choosing <kbd class="menu">Remove</kbd> will delete the cue marker
74   of choice.
75 </p>
76
77 <p>
78   When all existing cue markers have to be removed, the best option is to
79   right-click on the Cue Markers ruler (any place except an existing marker) and
80   choose <kbd class="menu">Clear All Cues</kbd>. This will delete all cue
81   markers in the session.
82 </p>
83
84 <h2>More Options</h2>
85
86 <p>
87   The context menu for existing markers provides several more options:
88 </p>
89
90 <table class="dl">
91   <tr>
92         <th>Set Cue:</th>
93         <td>Picking a cue from the list here will replace the selected marker with
94         a marker for a different cue.</td>
95   </tr>
96   <tr>
97         <th>Locate to Here</th>
98         <td>This will move the playhead to the cue marker's position.</td>
99   </tr>
100   <tr>
101         <th>Play from Here</th>
102         <td>This will move the playhead to the cue marker's position and start
103         playback.</td>
104   </tr>
105   <tr>
106         <th>Move Mark to Playhead</th>
107         <td>This will move the selected cue marker to the current position of the
108         Playhead.</td>
109   </tr>
110   <tr>
111         <th>Glue to Bars and Beats</th>
112         <td>If this option is enabled, the cue marker will maintain its position in
113         bars and beats even if there are changes in tempo and time signature.
114         </td>
115   </tr>
116 </table>