2 Ardour supports multiple type of markers, all designed for particular tasks:
3 single markers that define a location, single markers that change a value,
4 paired markers that define a range on a timeline etc.
7 <h2>Creating New Markers</h2>
10 There are several ways to create markers in Ardour.
14 The most common way is to right-click over a ruler and select a menu item
15 called like <kbd class="menu">New Loop Range</kbd> (for the
16 <kbd class="title">Loop/Punch Ranges</kbd> ruler) or
17 <kbd class="menu">New Tempo</kbd> (for the
18 <kbd class="title">Tempo</kbd> ruler).
22 <img width="50%" src="/images/new-range-markers.gif" alt="Adding a New Range Marker">
24 Adding a New Range Marker
29 Some of the markers can be created from context menus on the canvas.
30 E.g. range markers can be created by creating a range, opening the context
31 (right-click) menu and choosing <kbd class="menu">Add Range Markers</kbd>.
35 Additionally, location markers and range markers can be created from the
36 <kbd class="title">Ranges & Marks</kbd> sidebar by clicking
37 <kbd class="title">Ranges & Marks</kbd> or
38 <kbd class="title">Ranges & Marks</kbd> respectively.
41 <h2>Moving Markers</h2>
44 Once a single or a paired marker has been added, it can be moved around.
47 <h3>Single marker</h3>
49 <kbd class="mouse">Left</kbd>-clicking and dragging moves a single marker to a
50 new location on the timeline.
54 Additionally, markers can be moved to playhead position by right-clicking and
55 choosing the <kbd class="menu">Move Mark to Playhead</kbd> menu item.
58 <h3>Multiple markers</h3>
60 It is possible to move multiple markers by the same distance. <kbd
61 class="mouse mod1">Left</kbd>-clicking each discreet marker, or <kbd
62 class="mouse mod3">Left</kbd>-clicking the first and last markers of a range
63 of markers selects them, then dragging one to a new location will move all
64 selected markers together.
67 The markers are bounded by the zero point on the timeline. In other words, the
68 first marker in the selection cannot move to the left of zero on the timeline.
71 <h3>Both ends of a range marker</h3>
73 By <kbd class="mod1 mouse">left</kbd>-dragging either end of the range marker,
74 the other end will move by the same distance.
77 <h2>Renaming Markers</h2>
80 Some markers on the ruler can have unique names: location markers, CD markers,
81 range markers. Double-clicking on them opens a dialog where a different name
86 <img width="50%" src="/images/renaming-a-marker.gif" alt="Renaming a Marker">
93 Alternatively, right-clicking on a marker will open a context menu with a menu
94 item called <kbd class="title">Rename...</kbd> or
95 <kbd class="title">Rename Range...</kbd>, depending on the type of the marker.
96 The same dialog for submitting a new name will appear.
99 <h2>Editing Marker's Properties</h2>
102 Markers on rulers such as <kbd class="title">Time Signature</kbd> or
103 <kbd class="title">Tempo</kbd> don't have unique names, however they do have
104 other properties that can be edited. The principle is the same as with
105 renaming: double-clicking on a marker or right-clicking and choosing the
106 <kbd class="title">Edit...</kbd> menu item.
109 <h2>Hiding Markers</h2>
112 Most marker types can be temporarily hidden from the ruler if the user chooses
113 to do so. The user interface for that is available in the
114 <kbd class="title">Ranges & Marks</kbd> sidebar: it is a simple
115 <kbd class="title">Hide</kbd> checkbox for each marker.
119 <img width="50%" src="/images/regions-and-marks.png" alt="Hiding Markers">
126 Clicking the respective <kbd class="title">Hide</kbd> checkbox again will
127 reveal the marker on the ruler again.
130 <h2>Removing Markers</h2>
133 There are three ways to permanently delete a marker. The first one is to
134 right-click the marker of choice, then select
135 <kbd class="menu">Remove</kbd> in the menu.
139 <img width="50%" src="/images/remove-a-marker.png" alt="Removing a Location Marker">
141 Removing a Location Marker
146 The second one is to click a marker to select it, keep hovering the mouse
147 pointer, then press <kbd class="key">Del</kbd>.
151 The third way is to click the markers' <kbd class="button">x</kbd> button in
152 the <em>Ranges & Marks</em> sidebar.
155 <h2>Additional Actions</h2>
158 Depending on the type of a marker additional actions are possible, such as
159 moving the playhead to a location marker's position or zooming to a range
160 saved with range markers. This is covered in dedicated subchapters for
161 respective ruler/marker types.