Shamusworld >> Repos - ardour-manual/blob - include/grid-controls.html

   1
   2 <figure class="left">
   3         <img src="/images/toolbar-grid.png" alt="Editor toolbar's grid">
   4         <figcaption>
   5                 Editor toolbar's grid.
   6         </figcaption>
   7 </figure>
   8
   9 <p>
  10   Ardour's editor utilizes a <dfn>grid</dfn> to assist in the placement of regions
  11   on the timeline, or with editing functions that need to happen at a specific
  12   point in time. This <dfn>snapping</dfn> of the cursor and various objects to the
  13   grid can be toggled on or off, as does its behaviour, and grid units.
  14 </p>
  15
  16 <h2>About Snapping</h2>
  17
  18 <p>
  19   There are two ways to think about aligning material to a grid. The first and
  20   most obvious one is where an object's position is clamped to grid lines. In
  21   Ardour, this is called <dfn>absolute snap</dfn> and is commonly used when
  22   working with sampled material where audio begins exactly at the beginning of a
  23   file, note or region.
  24 </p>
  25
  26 <p>
  27   The second, <dfn>relative snap</dfn>, is used when an object's position relative
  28   to the grid lines is important. In music, this allows to move objects around
  29   without changing the "feel" (or timing) of a performance.
  30 </p>
  31
  32 <p>
  33   Absolute snap is the default method of snapping in Ardour.
  34 </p>
  35
  36 <p>
  37   While dragging objects, pressing the absolute snap modifier key(s) switches
  38   from absolute to relative snap.
  39 </p>
  40
  41 <p>
  42   The snap can also be entirely disabled by using the snap modifier (see below).
  43 </p>
  44
  45 <p>
  46   Note that in relative snap mode the reference point is taken to be the distance
  47   to the nearest grid line.
  48 </p>
  49
  50 <p>
  51   Note also that when an object lies exactly on a grid line, there will be no
  52   difference between relative and absolute snap modes.
  53 </p>
  54
  55 <p>
  56   The relative snap and snap modifiers (along with other modifier keys) may be set
  57   in <kbd class="menu">Edit &gt; Preferences &gt; User Interaction</kbd>
  58 </p>
  59
  60 <p>
  61   For common use patterns, it is recommended to assign a unique key for one
  62   snap modifier and two keys for the other in such a way that they share an
  63   otherwise unused key. For example, the snap modifier may be chosen to be the
  64   <kbd class="mod2n"></kbd> key and the relative snap modifier to be the <kbd
  65   class="mod2n"></kbd> and <kbd class="mod4n"></kbd> keys.
  66 </p>
  67
  68 <h2>Snap Modes</h2>
  69
  70 <p>
  71   Using the above modifications, Ardour supports three different modes of snapping
  72   to the grid:
  73 </p>
  74
  75 <table class="dl">
  76   <tr><th><kbd class="menu">No Grid</kbd></th>
  77     <td>disables the grid. All objects move freely in this mode.</br>
  78     In <kbd class="menu">No Grid</kbd> mode, the grid may be temporarily activated
  79     by pressing the snap modifier (for absolute snap) or switch to relative snap
  80     by pressing the relative snap modifier.</td></tr>
  81   <tr><th><kbd class="menu">Grid</kbd></th>
  82     <td>activates normal snapping. All positions of objects snap to the grid. (See
  83     <a href="#gridunits">Grid Units</a> below to change the grid).
  84     Moving an object in "Grid"-mode, does not change its position until
  85     the mouse is far enough for the object to reach the next grid line.</br>
  86     To maintain an objects' position relative to the grid line, the "snap relative"
  87     modifier can be used. When holding down this
  88     modifier during a drag, the dragged object will jump while maintaining its
  89     original distance from the line.</br>
  90     New objects will always be created at grid
  91     points.</br>
  92     Holding down the snap modifier will disable the current grid
  93     setting and allow moving the object freely.</td></tr>
  94   <tr><th><kbd class="menu">Magnetic</kbd></th>
  95     <td>is a less strict type of snapping. Objects can still be moved to any
  96     position, but positions close to the relative or absolute grid points will snap.
  97     In order to move an object very close to a snap point, it may be necessary to
  98     zoom in to prevent snapping to that point, or to use the snap modifier to
  99     disable snap completely.</br> As with Grid mode, the snap modifier will disable
 100     snap completely while the absolute snap modifier will move the "notch" of
 101     Magnetic snap to the grid lines.</td></tr>
 102 </table>
 103
 104 <h2>Syncing Regions to the Grid</h2>
 105
 106 <p>
 107   By default, a region's beginning will be used as the reference for both types of
 108   snapping, this behaviour can be changed by setting a <dfn>sync point</dfn>
 109   in the region, by selecting the region(s) and pressing <kbd>V</kbd>. This will set the
 110   sync point to the current <a href="@@edit-point-control">edit point</a>.
 111 </p>
 112
 113 <h2 id="gridunits">Grid Units</h2>
 114
 115 <p>
 116   The selector next to the grid mode selector defines the size of the grid
 117   elements. The grid can be set to several different units:
 118 </p>
 119
 120 <table class="dl">
 121   <tr><th><kbd class="menu">CD Frames</kbd></th>
 122   <td>A CD Frame is 1/75th of a second. Snapping to CD Frames (using absolute snap) can be used to avoid issues with CD track lengths.</td></tr>
 123   <tr><th><kbd class="menu">Timecode Frames/Seconds/Minutes</kbd></th>
 124   <td>The duration of a frame depends on the timecode settings for the session.</td></tr>
 125   <tr><th><kbd class="menu">Seconds/Minutes</kbd></th>
 126   <td>These are absolute time units, unaffected by sample rate or timecode settings</td></tr>
 127   <tr><th><kbd class="menu">Beats/N</kbd></th>
 128   <td>Set the grid to units of 1/N beats, where N can be 128, 64, 32, 16, 8, 7, 6, 5, 4, 3, 2. The duration of a grid unit will depend on the tempo and meter in effect at that point in the timeline.</td></tr>
 129   <tr><th><kbd class="menu">Beats</kbd></th>
 130   <td>Set the grid to whole beats. The duration of a grid unit will depend on the tempo and meter in effect at that point in the timeline.</td></tr>
 131   <tr><th><kbd class="menu">Bars</kbd></th>
 132   <td>Set the grid to whole bars. The duration of a grid unit will depend on the tempo and meter in effect at that point in the timeline.</td></tr>
 133   <tr><th><kbd class="menu">Markers</kbd></th>
 134   <td>The grid lines are the markers.</td></tr>
 135   <tr><th><kbd class="menu">Region Starts</kbd></th>
 136   <td>The grid lines are constructed from region start points (see below).</td></tr>
 137   <tr><th><kbd class="menu">Region Ends</kbd></th>
 138   <td>The grid lines are constructed from region end points (see below).</td></tr>
 139   <tr><th><kbd class="menu">Region Syncs</kbd></th>
 140   <td>The grid lines are constructed from region sync points.</td></tr>
 141   <tr><th><kbd class="menu">Region Bounds</kbd></th>
 142   <td>The grid lines are constructed from region start or end points.</td></tr>
 143 </table>
 144
 145 <p>
 146   To use Region starts/ends/syncs/bounds as snap choices, it is necessary to have either:
 147 </p>
 148
 149 <ul>
 150   <li><em>No</em> tracks selected, which means that Ardour snaps to regions on any
 151     track, or </li>
 152   <li>Several tracks selected, which means that Ardour only snaps to regions on
 153     those selected tracks.</li>
 154 </ul>
 155
 156 <p>
 157   If items are moved on a track, and only the current track is selected, then
 158   snapping will only happen with other regions on the same track. This means
 159   that enabling <kbd class="menu">Edit &gt; Preferences &gt; Editor &gt; Link
 160   Selections of Regions and Tracks</kbd> will make the "Region" grid unit
 161   unusable. This option should not be used in conjunction with the use any of the
 162   Region grid units.
 163 </p>
 164