manual/include/cue-markers.html

<p>
  <dfn>Cue markers</dfn> allow bridging linear and non-linear approaches to
  composing music. The idea is that a user can set up entire cues, then place a
  cue marker on the timeline to launch a cue of choice at a particular point in
  time. The workflow is explained in more details in the
  <a href="@@mixing-linear-nonlinear-workflows">Mixing Linear and Non-Linear Workflows</a> section.
</p>

<figure>
  <img class="hdimage" src="/images/cue-markers-ruler-example.png" alt="Cue Markers Ruler">
  <figcaption>Cue Markers Ruler</figcaption>
</figure>

<h2>Adding Cue Markers</h2>

<p>
  There are several ways to add a cue marker:
</p>

<ul>
  <li><kbd class="mod1n"></kbd>-click on the ruler creates a marker that
  launches the A cue.</li>
  <li><kbd class="mod1n"></kbd>-doubleclick on the rules creates a marker that
  launches the A cue, then opens the dialog to edit its name</li>
  <li>Right-click on the ruler opens a menu where A to P markers are listed</li>
</ul>

<figure>
  <img class="hdimage" src="/images/cue-marker-ruler-right-click-menu.png" alt="Right-click menu for the Cue Markers ruler">
  <figcaption>Right-click menu for the Cue Markers ruler</figcaption>
</figure>

<h2>Moving Cue Markers</h2>

<p>
  <kbd class="mouse">Left</kbd>-clicking and dragging moves a single marker to a
  new location on the timeline.
</p>

<p>
  It is possible to move multiple markers by the same distance. <kbd
  class="mouse mod1">Left</kbd>-clicking each marker creates a selection of
  markers that can be dragged left or right together.
</p>

<h2>Single marker</h2>
<p>
  <kbd class="mouse">Left</kbd>-clicking and dragging moves a single marker to a
  new location on the timeline.
</p>

<h2>Multiple markers</h2>
<p>
  It is possible to move multiple markers by the same distance. <kbd
  class="mouse mod1">Left</kbd>-clicking each discrete marker, or <kbd
  class="mouse mod3">Left</kbd>-clicking the first and last markers of a range
  of markers selects them, then dragging one to a new location will move all
  selected markers together.
</p>

<h2>Stopping All Cues</h2>

<p>
  Ardour has a special kind of a marker that immediately stops all playing cues.
  This marker (<kbd class="menu">Stop All Cues</kbd>) can be added via the
  right-click menu on the Cue Markers ruler.
</p>

<h2>Removing Cue Markers</h2>

<p>
  Right-clicking on an existing cue marker opens the context menu with a number
  of options. Choosing <kbd class="menu">Remove</kbd> will delete the cue marker
  of choice.
</p>

<p>
  When all existing cue markers have to be removed, the best option is to
  right-click on the Cue Markers ruler (any place except an existing marker) and
  choose <kbd class="menu">Clear All Cues</kbd>. This will delete all cue
  markers in the session.
</p>

<h2>More Options</h2>

<p>
  The context menu for existing markers provides several more options:
</p>

<table class="dl">
  <tr>
  	<th>Set Cue:</th>
  	<td>Picking a cue from the list here will replace the selected marker with
  	a marker for a different cue.</td>
  </tr>
  <tr>
  	<th>Locate to Here</th>
  	<td>This will move the playhead to the cue marker's position.</td>
  </tr>
  <tr>
  	<th>Play from Here</th>
  	<td>This will move the playhead to the cue marker's position and start
  	playback.</td>
  </tr>
  <tr>
  	<th>Move Mark to Playhead</th>
  	<td>This will move the selected cue marker to the current position of the
  	Playhead.</td>
  </tr>
  <tr>
  	<th>Glue to Bars and Beats</th>
  	<td>If this option is enabled, the cue marker will maintain its position in
  	bars and beats even if there are changes in tempo and time signature.
  	</td>
  </tr>
</table>