]> Shamusworld >> Repos - ardour-manual/blob - include/creating-range-markers.html
Ruler/markers rewrite part 7 of N
[ardour-manual] / include / creating-range-markers.html
1
2 <p>
3   <dfn>Range markers</dfn> are essentially two
4   <a href="@@creating-location-markers"> location markers</a> that appear in the
5   <a href="@@ruler">Range Markers</a> ruler, and are grouped together to mark
6   the beginning and end of a section on the timeline.
7 </p>
8
9 <h2>Creating a Range on the Timeline</h2>
10
11 <p>
12   There are multiple ways to create range markers:
13 </p>
14
15 <ul>
16   <li>
17     <kbd class="mouse">Right</kbd>-clicking on the Range Markers ruler at the
18     top of the timeline, then selecting <kbd class="menu">New Range</kbd>.
19   </li>
20   <li>
21     <kbd class="mouse mod1">Left</kbd>-clicking and dragging right on the Range
22     Markers ruler. This will render a red-filled area across all tracks and
23     busses to help preview the extent of the range in creation. Once the mouse
24     button is released, a paired range marker will be created.
25   </li>
26   <li>
27     Selecting a range in the Editor window, then
28     <kbd class="mouse">right</kbd>-clicking and selecting
29     <kbd class="menu">Add Range Markers</kbd>.
30   </li>
31   <li>
32     Clicking <kbd class="button">New Range</kbd> button at the bottom of the
33     <kbd class="window">Ranges&nbsp;&amp; Marks</kbd> sidebar. The markers will
34     be created around the playhead position, unless the playhead in at the time
35     origin (in which case the markers will be placed at the time origin
36     position).
37   </li>
38   <li>
39     <kbd class="mouse">Right</kbd>-clicking a location or a CD marker and
40     selecting <kbd class="menu">Create Range to Next Marker</kbd>. This will
41     create a pair of range markers that start at the selected marked and end at
42     the position of the next location or CD marker (both rulers are taken into
43     account).
44   </li>
45 </ul>
46
47 <h2>Editing a Range</h2>
48
49 <p>
50   Both markers of a range can be independently moved along the timeline by
51   clicking and dragging them to the desired location. They can also be moved
52   together by <kbd class="mod2n"></kbd>-dragging one of the markers.
53 </p>
54
55 <p>
56   Any pair or range markers, including session start/end markers, can be
57   repositioned to the extents of an existing range selection on the timeline by 
58   <kbd class="mouse">right</kbd>-clicking on either of the markers and selecting
59   <kbd class="menu">Set Range from Selection</kbd> in the menu.
60 </p>
61
62 <h3>Renaming Range Markers</h3>
63
64 <p>
65   Ardour provides several ways to rename an existing pair of range markers:
66 </p>
67
68 <ul>
69   <li>
70     Double-clicking either of the two range markers will show a dialog for
71     setting a new caption for the markers.
72   </li>
73   <li>
74     The same can be achieved by right-clicking on either of the markers and
75     selecting the <kbd class="menu">Rename Range…</kbd> menu item.
76   </li>
77   <li>
78     Additionally, the name can be edited in the
79     <kbd class="window">Ranges&nbsp;&amp; Marks</kbd> sidebar.
80   </li>
81 </ul>
82
83 <h2>Removing Range Markers</h2>
84
85 <p>
86   Range markers can be deleted in several ways:
87 </p>
88
89 <ul>
90   <li>
91     By clicking on one of the markers and pressing the <kbd>Del</kbd> key.
92   </li>
93   <li>
94     By right-clicking on one of the markers and selecting
95     <kbd class="menu">Remove Range</kbd>.
96   </li>
97   <li>
98     By clicking the markers' <kbd class="button">x</kbd> button in the
99     <em>Ranges&nbsp;&amp; Marks</em> sidebar.
100   </li>
101 </ul>
102
103 <p>
104   Additionally, all ranges can be removed at once by
105   <kbd class="mouse">right</kbd>-clicking on an empty part of the Range Markers
106   ruler and selecting the <kbd class="menu">Clear All Ranges</kbd> menu item.
107
108 <h2>More Options</h2>
109
110 <p>
111   The context (right-click) menu for range markers has more options than the
112   ones mentioned above:
113 </p>
114
115 <table class="dl">
116   <tr>
117     <th>Play Range</th>
118     <td>
119       Starts playback at the left marker in the pair and stops at the right
120       marker.</td>
121   </tr>
122   <tr>
123     <th>Locate to Marker</th>
124     <td>
125       Moves the playhead to the selected marker.
126     </td>
127   </tr>
128   <tr>
129     <th>Play from Marker</th>
130     <td>
131       Moves the playhead to the selected marker and starts playback.
132     </td>
133   </tr>
134   <tr>
135     <th>Loop Range</th>
136     <td>
137       Creates a loop range off the selected range markers pair and starts
138       playback.
139     </td>
140   </tr>
141   <tr>
142     <th>Set Marker from Playhead</th>
143     <td>
144       Changes the position of the selected marker to that of the playhead.
145     </td>
146   </tr>
147   <tr>
148     <th>Zoom to Range</th>
149     <td>
150       Changes the zoom so that the area defined by the range markers would be
151       maximized yet visible entirely within Ardour's window.
152     </td>
153   </tr>
154   <tr>
155     <th>Glue to Bars and Beats</th>
156     <td>
157       When this option is enabled, the marker maintains its position in bars
158       and beats even if there are changes in tempo and meter.
159     </td>
160   </tr>
161   <tr>
162     <th>Loudness Assistant…</th>
163     <td>
164       Launches the Loudness Assistant to analyze the selection defined by the
165       selected pair of range markers.
166     </td>
167   </tr>
168   <tr>
169     <th>Export Range…</th>
170     <td>
171       Exports the selection defined by the selected pair of range markers.
172     </td>
173   </tr>
174   <tr>
175     <th>Promote to Time Origin</th>
176     <td>
177       This makes the position of the chosen range marker the origin time. This
178       is mostly useful when the <em>Display delta to origin marker</em> clock
179       mode is enabled to display the difference between current playhead
180       position and the origin time. Absolute time stays unaffected.
181     </td>
182   </tr>
183   <tr>
184     <th>Hide Range</th>
185     <td>
186       This hides the range from the Range Markers ruler. Marker's visibility
187       can be restored in the <em>Ranges&nbsp;&amp; Marks</em> sidebar.
188     </td>
189   </tr>
190   <tr>
191     <th>Separate Regions in Range</th>
192     <td>
193       Cuts all regions crossing the positions of the range markers.
194     </td>
195   </tr>
196   <tr>
197     <th>Select All in Range</th>
198     <td>
199       Select entire regions that cross the borders of the range markers.
200     </td>
201   </tr>
202   <tr>
203     <th>Select Range</th>
204     <td>
205       Create a selection from the range markers in all selected tracks and
206       busses.
207     </td>
208   </tr>
209 </table>