Shamusworld >> Repos - ardour-manual/blob - include/creating-location-markers.html

   1
   2 <p>
   3   <dfn>Location Markers</dfn> appear in the <a href="@@ruler">Locations Markers
   4   ruler</a> at the top of the timeline. They have multiple uses, most
   5   commonly&nbsp;&mdash; for navigation in a session, e.g. where this or that
   6   instrument should start/stop playing. Custom markers can be created at
   7   any position in a session.
   8 </p>
   9
  10 <p>
  11   The <dfn style="background-color:limegreen;">start</dfn> and
  12   <dfn style="background-color:limegreen;">end</dfn> markers, that define the
  13   length of the session, appear automatically once any content has been added to
  14   the session (either recorded or imported). The end marker automatically shifts
  15   to the right once more material gets added.
  16 </p>
  17
  18 <h2>Creating Location Markers</h2>
  19
  20 <p>
  21   There are multiple ways to create custom markers at the current playhead
  22   position:
  23 </p>
  24 <ul>
  25   <li>using the keyboard shortcut (default is <kbd>Tab</kbd></li>
  26   <li>using the <kbd class="menu">Transport &gt; Markers &gt; Add
  27   Mark from Playhead</kbd> menu.</li>
  28 </ul>
  29
  30 <p>
  31   Adding a marker at an arbitrary location on the timeline (i.e. not at the
  32   playhead position) can also be done either by:
  33 </p>
  34 <ul>
  35   <li><kbd class="mouse">right</kbd> clicking in the Location Marker ruler, and
  36   selecting <kbd class="menu">New location marker</kbd></li>
  37   <li>using the <a href="@@the-ranges-and-marks-lists">Ranges &amp; Marks List</a>,
  38   clicking <kbd class="menu">New Marker</kbd> and using the <a href="@@editing-clocks">
  39   clock widget</a> to set its position.</li>
  40 </ul>
  41
  42 <h2>Moving Location Markers</h2>
  43
  44 <p>
  45   <kbd class="mouse">Left</kbd>-clicking and dragging moves a single marker to a
  46   new location on the timeline.
  47 </p>
  48
  49 <p>
  50   It is possible to move multiple markers by the same distance. <kbd
  51   class="mouse mod1">Left</kbd>-clicking each marker creates a selection of
  52   markers that can be dragged left or right together.
  53 </p>
  54
  55 <h2>Renaming Location Markers</h2>
  56
  57 <p>
  58   There are three ways to rename a location marker:
  59 </p>
  60
  61 <ol>
  62   <li>
  63     Double-click on a marker opens a dialog where a new name can be submitted.
  64   </li>
  65   <li>
  66     Right-clicking on a marker and selecting <kbd class="menu">Rename….</kbd>
  67     opens a dialog where a new name can be submitted.
  68   </li>
  69   <li>
  70     Editing and confirming the name by pressing <kbd class="button">Enter</kbd>
  71     in an entry box in the <em>Ranges&nbsp;&amp; Marks</em> sidebar.
  72   </li>
  73 </ol>
  74
  75 <h2>Removing Location Markers</h2>
  76
  77 <p>
  78   There are three ways to remove a location marker:
  79 </p>
  80
  81 <ol>
  82   <li>
  83     Hovering the marker and pressing <kbd class="button">Enter</kbd>.
  84   </li>
  85   <li>
  86     Right-clicking on a marker and selecting <kbd class="menu">Remove</kbd>.
  87   </li>
  88   <li>
  89     Clicking the <kbd class="button">x</kbd> for a marker of choice in the
  90     <em>Ranges&nbsp;&amp; Marks</em> sidebar.
  91   </li>
  92 </ol>
  93
  94 <h2>More Options</h2>
  95
  96 <p>
  97   The context (right-click) menu for location markers has more options than the
  98   ones mentioned above:
  99 </p>
 100
 101 <table class="dl">
 102   <tr>
 103     <th>Locate to Here</th>
 104     <td>
 105       Moves the playhead to the selected marker.
 106     </td>
 107   </tr>
 108   <tr>
 109     <th>Play from Here</th>
 110     <td>
 111       Moves the playhead to the selected marker and starts playback.
 112     </td>
 113   </tr>
 114   <tr>
 115     <th>Move Mark to Playhead</th>
 116     <td>
 117       This changes the position of the selected marker to that of the playhead.
 118     </td>
 119   </tr>
 120   <tr>
 121     <th>Create Range to next Marker</th>
 122     <td>
 123       This creates a pair of range markers between the selected marker and the
 124       next one to the right on the timeline.
 125     </td>
 126   </tr>
 127   <tr>
 128     <th>Promote to Time Origin</th>
 129     <td>
 130       This makes the position of the chosen range marker the origin time. This
 131       is mostly useful when the <em>Display delta to origin marker</em> clock
 132       mode is enabled to display the difference between current playhead
 133       position and the origin time. Absolute time stays unaffected.
 134     </td>
 135   </tr>
 136   <tr>
 137     <th>Hide</th>
 138     <td>
 139       This hides the selected marker from the ruler until the user chooses to
 140       unhide it.
 141     </td>
 142   </tr>
 143   <tr>
 144     <th>Rename…</th>
 145     <td>
 146       This opens a dialog to rename the marker.
 147     </td>
 148   </tr>
 149   <tr>
 150     <th>Lock</th>
 151     <td>
 152       This prevents a marker from being accidentally moved elsewhere.
 153     </td>
 154   </tr>
 155   <tr>
 156     <th>Glue to Bars and Beats</th>
 157     <td>
 158       When this option is enabled, the marker maintains its position in bars
 159       and beats even if there are changes in tempo and meter.
 160     </td>
 161   </tr>
 162 </table>