Shamusworld >> Repos - ardour-manual/blob - include/toolbox.html

   1
   2 <img src="/images/toolbar-tools.png" alt="Editor toolbar's tools, aka toolbox">
   3
   4 <h2>Global Edit mode</h2>
   5
   6 <p>
   7   Ardour has a global <dfn>edit mode</dfn> selector at the left of the
   8   Editing toolbar, which affect how regions are moved or copied:
   9 </p>
  10
  11 <dl>
  12   <dt><kbd class="menu">Slide</kbd></dt>
  13   <dd>Regions move freely. Ardour creates overlaps when necessary.</dd>
  14   <dt><kbd class="menu">Ripple</kbd></dt>
  15   <dd>Editing affects the regions to the "right" of the edit (see below).</dd>
  16   <dt><kbd class="menu">Lock</kbd></dt>
  17   <dd>No region motion is permitted (except for "nudge").</dd>
  18 </dl>
  19
  20 <p>
  21   Ripple Edit mode provides the following conveniences:
  22   <ul>
  23     <li>Deleting a range will move later regions to compensate for the deleted time</li>
  24     <li>Deleting a region will move later regions to compensate for the deleted region's length</li>
  25     <li>Moving a region will move later regions to compensate for the length of the move</li>
  26     <li>Inserting a new region (via dragging or via Paste) will move later regions to the right to compensate</li>
  27   </ul>
  28 </p>
  29
  30 <p class="note">
  31   If <kbd class="menu">Snap To Grid</kbd> is enabled, then regions can
  32   only move so that they align with locations determined by the current
  33   snap settings (beats, or seconds, or other region boundaries, etc).
  34   See <a href="/ardours-interface/the-grid-controls/">Snap To the Grid</a>
  35   for details.
  36 </p>
  37
  38 <h2>The <em>Smart</em> switch
  39
  40 <p>
  41   The <dfn>Smart Mode</dfn> button to the left of the mouse mode buttons
  42   modifies the <dfn>Grab Mode</dfn>. When enabled, the mouse behaves as if it
  43   is in "Range Mode" in the upper half of a region, and in "Grab Mode" in the
  44   lower half. This allows avoiding constant switching between these two modes.
  45 </p>
  46
  47 <h2>Mouse Modes</h2>
  48
  49 <dl class="wide-table">
  50   <dt id="object">Grab Mode</dt>
  51   <dd>The <dfn>Grab Mode</dfn> is used for selecting, moving, deleting and
  52   copying objects. When in object mode, the mouse pointer appears as a hand
  53   whenever it is over the track canvas or the rulers. The mouse can now be
  54   used to select and perform operations on objects such as regions, markers etc.
  55   This is the most common mode to work in, as it allows you to select and move regions,
  56   as well as modify automation points on the automation tracks.</dd>
  57
  58   <dt>Range Mode</dt>
  59   <dd>When in <dfn>Range Mode</dfn>, the mouse pointer appears as a vertical line
  60   whenever it is over the track canvas or the rulers. The mouse will now be
  61   able to select a point or range of time. Time ranges can be selected over
  62   one or several tracks, depending on the selection of your tracks.<br>
  63   If none of your tracks are selected, the Range Tool will operate on all the
  64   session track visualized in the Editor.<br>
  65   If you want to edit only particular tracks, select them before you apply
  66   the range tool.</dd>
  67
  68   <dt>Cut Tool Mode</dt>
  69   <dd>When in <dfn>Cut Tool Mode</dfn>, the mouse pointer appears as a pair of scissors
  70   whenever it is over the track canvas or the rulers. This tools allows to cut
  71   any region into 2 regions at the mouse cursor, regardless of the Edit Point.<br>
  72   If one or more track(s) is selected, then all the regions on these tracks will
  73   be split at the mouse cursor position.<br>
  74   If no track is selected, then only the region hovered by the mouse cursor will
  75   be split.</dd>
  76
  77   <dt>Stretch Mode</dt>
  78   <dd>When in <dfn>time fx</dfn> mode, the mouse pointer appears as a
  79   distinctive expanding square symbol whenever it is over the track canvas or
  80   the rulers. This mode is used to resize regions using a timestretch
  81   algorithm. Click on an edge of a region of audio and drag it one way or the other to
  82   stretch or shrink the region.</dd>
  83
  84   <dt>Audition Tool</dt>
  85   <dd>Clicking a region using the <dfn>audition tool</dfn> will play this
  86   region to the control room outputs.<br>
  87   You can also <dfn>scrub</dfn> with this tool by clicking and dragging in
  88   the direction you wish to listen.  The amount you drag in one direction or
  89   the other will determine the playback speed.</dd>
  90
  91   <dt>Draw Tool</dt>
  92   <dd>When in <dfn>Draw Tool</dfn> mode, the mouse pointer will change to
  93   a pencil. You can then click within an audio region to change the <dfn>gain
  94   envelope</dfn> for that region. This curve is separate from fader automation
  95   for individual tracks. It will remain locked to the region's time, so if the
  96   region is moved, the region gain envelope is moved along with it.<br>
  97   The draw tool works on automation too, allowing the creation and modification
  98   of control points on the automation curves.<br>
  99   Last, it is used on a MIDI region to edit the notes.</dd>
 100
 101   <dt>Internal/Region Edit Mode</dt>
 102   <dd>When in <dfn>Internal Edit</dfn> mode, the mouse pointer will change to
 103   cross-hairs. This tool acts on gegion gain and automation as the Draw tool.<br>
 104   On a MIDI region, it allows to lasso-select multiple notes at a time.</dd>
 105 </dl>
 106