--- /dev/null
+
+<img src="/images/toolbar-tools.png" alt="Editor toolbar's tools, aka toolbox">
+
+<h2>Global Edit mode</h2>
+
+<p>
+ Ardour has a global <dfn>edit mode</dfn> selector at the left of the
+ Editing toolbar, which affect how regions are moved or copied:
+</p>
+
+<dl>
+ <dt><kbd class="menu">Slide</kbd></dt>
+ <dd>Regions move freely. Ardour creates overlaps when necessary.</dd>
+ <dt><kbd class="menu">Ripple</kbd></dt>
+ <dd>Editing affects the regions to the "right" of the edit (see below).</dd>
+ <dt><kbd class="menu">Lock</kbd></dt>
+ <dd>No region motion is permitted (except for "nudge").</dd>
+</dl>
+
+<p>
+ Ripple Edit mode provides the following conveniences:
+ <ul>
+ <li>Deleting a range will move later regions to compensate for the deleted time</li>
+ <li>Deleting a region will move later regions to compensate for the deleted region's length</li>
+ <li>Moving a region will move later regions to compensate for the length of the move</li>
+ <li>Inserting a new region (via dragging or via Paste) will move later regions to the right to compensate</li>
+ </ul>
+</p>
+
+<p class="note">
+ If <kbd class="menu">Snap To Grid</kbd> is enabled, then regions can
+ only move so that they align with locations determined by the current
+ snap settings (beats, or seconds, or other region boundaries, etc).
+ See <a href="/ardours-interface/the-grid-controls/">Snap To the Grid</a>
+ for details.
+</p>
+
+<h2>The <em>Smart</em> switch
+
+<p>
+ The <dfn>Smart Mode</dfn> button to the left of the mouse mode buttons
+ modifies the <dfn>Grab Mode</dfn>. When enabled, the mouse behaves as if it
+ is in "Range Mode" in the upper half of a region, and in "Grab Mode" in the
+ lower half. This allows avoiding constant switching between these two modes.
+</p>
+
+<h2>Mouse Modes</h2>
+
+<dl class="wide-table">
+ <dt id="object">Grab Mode</dt>
+ <dd>The <dfn>Grab Mode</dfn> is used for selecting, moving, deleting and
+ copying objects. When in object mode, the mouse pointer appears as a hand
+ whenever it is over the track canvas or the rulers. The mouse can now be
+ used to select and perform operations on objects such as regions, markers etc.
+ This is the most common mode to work in, as it allows you to select and move regions,
+ as well as modify automation points on the automation tracks.</dd>
+
+ <dt>Range Mode</dt>
+ <dd>When in <dfn>Range Mode</dfn>, the mouse pointer appears as a vertical line
+ whenever it is over the track canvas or the rulers. The mouse will now be
+ able to select a point or range of time. Time ranges can be selected over
+ one or several tracks, depending on the selection of your tracks.<br>
+ If none of your tracks are selected, the Range Tool will operate on all the
+ session track visualized in the Editor.<br>
+ If you want to edit only particular tracks, select them before you apply
+ the range tool.</dd>
+
+ <dt>Cut Tool Mode</dt>
+ <dd>When in <dfn>Cut Tool Mode</dfn>, the mouse pointer appears as a pair of scissors
+ whenever it is over the track canvas or the rulers. This tools allows to cut
+ any region into 2 regions at the mouse cursor, regardless of the Edit Point.<br>
+ If one or more track(s) is selected, then all the regions on these tracks will
+ be split at the mouse cursor position.<br>
+ If no track is selected, then only the region hovered by the mouse cursor will
+ be split.</dd>
+
+ <dt>Stretch Mode</dt>
+ <dd>When in <dfn>time fx</dfn> mode, the mouse pointer appears as a
+ distinctive expanding square symbol whenever it is over the track canvas or
+ the rulers. This mode is used to resize regions using a timestretch
+ algorithm. Click on an edge of a region of audio and drag it one way or the other to
+ stretch or shrink the region.</dd>
+
+ <dt>Audition Tool</dt>
+ <dd>Clicking a region using the <dfn>audition tool</dfn> will play this
+ region to the control room outputs.<br>
+ You can also <dfn>scrub</dfn> with this tool by clicking and dragging in
+ the direction you wish to listen. The amount you drag in one direction or
+ the other will determine the playback speed.</dd>
+
+ <dt>Draw Tool</dt>
+ <dd>When in <dfn>Draw Tool</dfn> mode, the mouse pointer will change to
+ a pencil. You can then click within an audio region to change the <dfn>gain
+ envelope</dfn> for that region. This curve is separate from fader automation
+ for individual tracks. It will remain locked to the region's time, so if the
+ region is moved, the region gain envelope is moved along with it.<br>
+ The draw tool works on automation too, allowing the creation and modification
+ of control points on the automation curves.<br>
+ Last, it is used on a MIDI region to edit the notes.</dd>
+
+ <dt>Internal/Region Edit Mode</dt>
+ <dd>When in <dfn>Internal Edit</dfn> mode, the mouse pointer will change to
+ cross-hairs. This tool acts on gegion gain and automation as the Draw tool.<br>
+ On a MIDI region, it allows to lasso-select multiple notes at a time.</dd>
+</dl>
+
projects / ardour-manual / blobdiff