Skip to content

Commit

Permalink
finish copy-editing of chapter 4.
Browse files Browse the repository at this point in the history
  • Loading branch information
nettings committed Feb 4, 2014
1 parent 2d0291a commit 5f92c08
Show file tree
Hide file tree
Showing 8 changed files with 357 additions and 196 deletions.
3 changes: 2 additions & 1 deletion STYLE_GUIDE
Original file line number Diff line number Diff line change
Expand Up @@ -219,7 +219,8 @@ types or presses.
The image tag must contain a 'src="/images/yourimage.png"' element and a
descriptive 'alt="A short textual description of the image content"'
element.

Images are usually placed as block-level elements, i.e. outside of a
paragraph.

5. Other conventions
====================
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -3,11 +3,4 @@
title: Introducing the Editor Window
---








{% children %}
Original file line number Diff line number Diff line change
Expand Up @@ -3,14 +3,14 @@
title: Editor Lists
---




<p>At the right of the editor is an optional area which provides one of a range of useful lists of parts of your session. It is not shown by default when you first start using Ardour. The list can be hidden or shown using the Show Editor List option from the View menu. The very right-hand side of the list gives a selection of tabs which are used to choose the list to view. The left-hand border of the list can be dragged to vary the width of the list.</p>





<p>
At the right of the editor is an optional area which provides one of a
range of useful lists of parts of your session. It is not shown by default
when you first start using Ardour. The <dfn>Editor list</dfn> can be hidden
or shown using <kbd class="menu">View &gt; Show Editor List</kbd>. The very
right-hand side of the list gives a selection of tabs which are used to
choose the list to view. The left-hand border of the list can be dragged to
vary the width of the list.
</p>

{% children %}
Original file line number Diff line number Diff line change
Expand Up @@ -3,35 +3,64 @@
title: The Editing Toolbar
---




<h3>Mouse Modes</h3>
<h2>Mouse Modes</h2>
<dl class="wide-table">
<dt id="object">Object Tool</dt>
<dd>Used for selecting, moving, deleting and copying objects. See below for a full description.</dd>
<dt>Range Mode</dt>
<dd>When in range mode, 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.
<p>If none of your track is selected, the Range Tool will operate on all the session track visualized in the Editor.</p>
<p>If you want to operate just some track, select the track you want to edit with the Range Tool.</p>
</dd>
<dt>Zoom Tool</dt>
<dd>When in zoom mode, the mouse pointer appears as a magnifying glass whenever it is over the track canvas or the rulers. This mode is used to zoom the display to any range that is determined by clicking and dragging the Button1 to specify the range. You can also utilize a single click with Button1 to zoom in by one level focused on the mouse cursor, likewise a single click on Button3 will zoom out by one level focused on the mouse.</dd>
<dt>Region Gain Tool</dt>
<dd>When in gain edit mode, the mouse pointer will change to cross-hairs. You can then click within a region to change the gain automation for that region. This automation is separate from fader automation for individual tracks, but works in conjunction with the track's fader. This automation will remain locked to the region's time, so if the region is moved, the region gain automation is moved along with it.</dd>
<dt>TimeFX Tool</dt>
<dd>When in timefx mode, the mouse pointer appears as a distinctive 'expanding' illustration whenever it is over the track canvas or the rulers. This mode is used to resize regions using a timestretch algorithm. It is utilized by clicking on an edge of a region of audio and dragging it one way or the other to either stretch or shrink the region.</dd>
<dt>Audition Tool</dt>
<dd>Clicking a region using the "audition" tool will audition the region.
<p>You can also "scrub" 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.</p>
</dd>
<dt>Draw Tool</dt>
<dd></dd>
<dt>Internal/Region Edit Mode</dt>
<dd></dd>
<dt id="object">Object Mode</dt>
<dd>The <dfn>object 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.
<p>
If none of your tracks is selected, the Range Tool will operate on all the
session track visualized in the Editor.
</p>
<p>
If you want to edit only particular tracks, select them before you apply
the range tool.
</p>
</dd>
<dt>Zoom Tool</dt>
<dd>When in <dfn>zoom mode</dfn>, the mouse pointer appears as a magnifying glass
whenever it is over the track canvas or the rulers. Select the area to
zoom to with a <kbd class="mouse">Left drag</kbd>. A single <kbd
class="mouse">Left</kbd> click zooms in by one level around the mouse cursor,
likewise a single <kbd class="mouse">Right</kbd> click will zoom out by one
level.</dd>
<dt>Region Gain Tool</dt>
<dd>When in <dfn>gain edit</dfn> mode, the mouse pointer will change to
cross-hairs. You can then click within a 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.</dd>
<dt>Time Effects Tool</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.
<p>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.</p>
</dd>
<dt>Draw Tool</dt>
<dd></dd>
<dt>Internal/Region Edit Mode</dt>
<dd></dd>
</dl>

<h3>Object Tool</h3>
<p>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 commonly utilized mode in Ardour, as it allows you to select and move regions, as well as modify automation points on the automation tracks.</p>
<dl class="wide-table">
<dt>Selecting Regions</dt>
<dd></dd>
Expand All @@ -43,5 +72,10 @@ <h3>Object Tool</h3>
<dd></dd>
</dl>
<h3 id="smartmode">Smart Mode</h3>
<p>The "Smart Mode" button to the left of the mouse mode buttons modifies "Object Tool" mode. When enabled, the mouse behaves as if it is in "Range Tool" mode in the upper half of a region, and in "Object Tool" mode in the lower half.</p>
<p>
The <dfn>Smart Mode</dfn> button to the left of the mouse mode buttons
modifies <dfn>Object mode</dfn>. When enabled, the mouse behaves as if it
is in "Range Tool" mode in the upper half of a region, and in "Object Tool"
mode in the lower half.
</p>

Loading

0 comments on commit 5f92c08

Please sign in to comment.