]> Shamusworld >> Repos - ardour-manual/blob - include/working-with-markers.html
Ruler/Markers rewrite, part 2 of N
[ardour-manual] / include / working-with-markers.html
1 <p>
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.
5 </p>
6
7 <h2>Creating New Markers</h2>
8
9 <p>
10   There are several ways to create markers in Ardour.
11 </p>
12
13 <p>
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).
19 </p>
20
21 <figure>
22     <img width="50%" src="/images/new-range-markers.gif" alt="Adding a New Range Marker">
23     <figcaption>
24       Adding a New Range Marker
25     </figcaption>
26 </figure>
27
28 <p>
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>.
32 </p>
33
34 <p>
35   Additionally, location markers and range markers can be created from the
36   <kbd class="title">Ranges&nbsp;&amp; Marks</kbd> sidebar by clicking
37   <kbd class="title">Ranges&nbsp;&amp; Marks</kbd> or
38   <kbd class="title">Ranges&nbsp;&amp; Marks</kbd> respectively.
39 </p>
40
41 <h2>Moving Markers</h2>
42
43 <p>
44   Once a single or a paired marker has been added, it can be moved around.
45 </p>
46
47 <h3>Single marker</h3>
48 <p>
49   <kbd class="mouse">Left</kbd>-clicking and dragging moves a single marker to a
50   new location on the timeline.
51 </p>
52
53 <p>
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.
56 </p>
57
58 <h3>Multiple markers</h3>
59 <p>
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.
65 </p>
66 <p class="note">
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.
69 </p>
70
71 <h3>Both ends of a range marker</h3>
72 <p>
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.
75 </p>
76
77 <h2>Renaming Markers</h2>
78
79 <p>
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
82   can be submitted.
83 </p>
84
85 <figure>
86     <img width="50%" src="/images/renaming-a-marker.gif" alt="Renaming a Marker">
87     <figcaption>
88       Renaming a Marker
89     </figcaption>
90 </figure>
91
92 <p>
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.
97 </p>
98
99 <h2>Editing Marker's Properties</h2>
100
101 <p>
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.
107 </p>
108
109 <h2>Hiding Markers</h2>
110
111 <p>
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&nbsp;&amp; Marks</kbd> sidebar: it is a simple
115   <kbd class="title">Hide</kbd> checkbox for each marker.
116 </p>
117
118 <figure>
119     <img width="50%" src="/images/regions-and-marks.png" alt="Hiding Markers">
120     <figcaption>
121       Hiding Markers
122     </figcaption>
123 </figure>
124
125 <p>
126   Clicking the respective <kbd class="title">Hide</kbd> checkbox again will
127   reveal the marker on the ruler again.
128 </p>
129
130 <h2>Removing Markers</h2>
131
132 <p>
133   There are two 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.
136 </p>
137
138 <figure>
139     <img width="50%" src="/images/remove-a-marker.png" alt="Removing a Location Marker">
140     <figcaption>
141       Removing a Location Marker
142     </figcaption>
143 </figure>
144
145 <p>
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>.
148 </p>
149
150 <h2>Additional Actions</h2>
151
152 <p>
153   Depending on the type of a marker additional actions are possible, such as
154   moving the playhead to a location marker's position or zooming to a range
155   saved with range markers. This is covered in dedicated subchapters for
156   respective ruler/marker types.
157 </p>