From: Alexandre Prokoudine <alexandre.prokoudine@gmail.com>
Date: Thu, 3 Nov 2022 22:07:03 +0000 (+0300)
Subject: Add a subchapter on cue markers
X-Git-Url: http://shamusworld.gotdns.org/cgi-bin/gitweb.cgi?p=ardour-manual;a=commitdiff_plain;h=252cfd80174df0772747e8c2589014937cbed0e3

Add a subchapter on cue markers
---

diff --git a/include/cue-markers.html b/include/cue-markers.html
new file mode 100644
index 0000000..a53a972
--- /dev/null
+++ b/include/cue-markers.html
@@ -0,0 +1,95 @@
+<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 style="width:75%;" width="50%" 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 style="width:50%;" width="50%" 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>
+  Just like any other marker, a cue marker can be picked and relocated by
+  dragging it left or right.
+</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>
diff --git a/master-doc.txt b/master-doc.txt
index 4c439a3..c0bbbc7 100644
--- a/master-doc.txt
+++ b/master-doc.txt
@@ -589,6 +589,14 @@ uri: working-with-markers/punch-range
 part: subchapter
 ---
 
+---
+title: Cue Markers
+include: cue-markers.html
+link: cue-markers
+uri: working-with-markers/cue-markers
+part: subchapter
+---
+
 ---
 title: Summary
 include: summary.html
diff --git a/source/images/cue-marker-ruler-right-click-menu.png b/source/images/cue-marker-ruler-right-click-menu.png
new file mode 100644
index 0000000..177b100
Binary files /dev/null and b/source/images/cue-marker-ruler-right-click-menu.png differ