]> Shamusworld >> Repos - ardour-manual-diverged/commitdiff
More work on the Editor's lists and status bar
authorEd Ward <edwsaintesprit@hotmail.com>
Thu, 12 Jan 2017 19:32:30 +0000 (20:32 +0100)
committerEd Ward <edwsaintesprit@hotmail.com>
Thu, 12 Jan 2017 19:32:30 +0000 (20:32 +0100)
master-doc.txt
source/images/status-bar.png [new file with mode: 0644]

index d3aed91842fe7c173abbe903218ba66f59f1aa9e..08783489cac4a1cb9743ba0b69dda90cb54b9469 100644 (file)
@@ -7461,15 +7461,16 @@ part: subchapter
 </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>
+  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
@@ -7479,8 +7480,7 @@ part: subchapter
   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>
+  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
@@ -7500,11 +7500,10 @@ part: subchapter
 
   <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
+  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.</p>
-  </dd>
+  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
@@ -7514,15 +7513,16 @@ part: subchapter
   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>
+  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>
+  On a MIDI region, it allows to lasso-select multiple notes at a time.</dd>
 </dl>
 
+
+
 <p class="fixme">Make sure the Internal Edit and Draw tool act as described</p>
 
 
@@ -7582,8 +7582,6 @@ part: subchapter
 
 <img class="left" src="/images/toolbar-grid.png" alt="Editor toolbar's grid">
 
-<p class="fixme">Get rid of all the &lt;br&gt;s, they look like shit</p>
-
 <p>
   Ardour's editor utilizes a <dfn>grid</dfn> to assist in the placement
   of regions on the timeline, or with editing functions that need to happen
@@ -7595,7 +7593,7 @@ part: subchapter
 <h2>About Snapping</h2>
 
 <p>There are two ways to think about aligning material to a grid.
-  The first and most obvious one is where an object\'s position is clamped
+  The first and most obvious one is where an object's position is clamped
   to grid lines. In Ardour, this is called <dfn>absolute snap</dfn>
   and is commonly used when working with sampled material where audio
   begins exactly at the beginning of a file, note or region.</br>
@@ -7749,9 +7747,6 @@ part: subchapter
   unit selector.
 </p>
 
-<p class="fixme">Add images</p>
-
-
 
 ---
 title: the Nudge Controls
@@ -7761,18 +7756,16 @@ part: subchapter
 <img class="left" src="/images/toolbar-nudge.png" alt="Editor toolbar's Nudge">
 
 <p>
-  If there are no selected objects, the <dfn>nudge controls</dfn> can be
-  used to move the playhead backward or forward by a fixed amount. The left
-  and right buttons move either backward or forward in time, and the small
+  The <dfn>nudge controls</dfn> will move the selected region(s) by a fixed amount
+  of time. The left and right buttons move either backward or forward in time, and the small
   clock to the left of these buttons sets the amount of time to nudge by.
   As with all other clocks, you can right-click on the clock to choose the
   time representation you want to use.
 </p>
 
 <p>
-  Note that this is a secondary purpose of the nudge controls&mdash;it is
-  usually used to move selected <dfn>objects</dfn> by specific distances, rather than
-  the playhead.
+  If there are no selected objects, the nudge controls can be
+  used to move the playhead backward or forward by the amount shown on the clock.
 </p>
 
 
@@ -7783,7 +7776,7 @@ part: chapter
 ---
 
 <p>
-  At the right of the editor is an optional area which provides one of a
+  At the right of the editor window 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
@@ -7937,12 +7930,69 @@ part: subchapter
 ---
 
 <p>
-  For information on this list see
-  <a href="/working-with-markers/rangesmarks-list/">Ranges
-  &amp; Marks List</a> in the "Working with Markers" section of the manual.
+  The <dfn>Ranges &amp; Marks List</dfn> is a tab in the <dfn>Editor
+  Lists</dfn> area on the right of the Editor window. If the editor
+  list area isn't visible it can be enabled by checking
+  <kbd class="option">View &gt; Show Editor List</kbd>.
+  The Ranges &amp; Marks list can be used as a single point
+  of control for all range and location markers (including the punch and
+  loop ranges), or as a supplement to other methods of working with them.
 </p>
 
+<h2>Common elements</h2>
 
+<p>
+  Each section has a set of <dfn>editable <a
+  href="/ardours-interface/using-ardour-clock-displays/">clock widgets</a></dfn>
+  which display
+  the location of a marker, or the start, end, and duration times of a range,
+  respectively.<br />
+  The <kbd class="menu">Use PH</kbd> buttons allow you to set
+  the corresponding clock to the current playhead position.
+  A <kbd class="mouse">Middle</kbd> click on any of the clocks will move
+  the playhead to that location. Both functions are also available from the
+  clock context menus.<br />
+  Right clicking on any of the clocks brings up a context menu that allows
+  changing of the display between Timecode, Bars:Beats, Minutes:Seconds,
+  and Samples.<br />
+</p>
+<p>
+ The <kbd class="menu">&mdash;</kbd> (subtract) button in front of each
+ user-defined range or marker in the list allows that particular item to
+ be removed. The name fields of custom ranges and markers can be edited.
+</p>
+<p>
+  The <kbd class="option">Hide</kbd> checkboxes make markers and ranges invisible
+  on the respective ruler to reduce visual clutter; the markers remain
+  active however, and can be used normally.<br />
+  Selecting <kbd class="option">Lock</kbd> prevents the respective marker
+  from being moved until unlocked.
+  Where applicable, <kbd class="option">Glue</kbd> fixes the marker position
+  relative to the current musical position expressed in bars and beats, rather
+  than the absolute time. This will make the respective marker follow
+  changes in the tempo map.
+</p>
+<p>
+  At the bottom of the list are buttons to add new markers or ranges.
+</p>
+ <h2>List sections</h2>
+
+<dl>
+  <dt>Loop/Punch Ranges</dt>
+  <dd>This list shows the current <dfn>loop</dfn> and <dfn>punch</dfn> range
+  settings. Since these are built-in ranges, you cannot rename or remove them.</dd>
+  <dt>Markers (Including CD Index)</dt>
+  <dd>This section lists the session's <dfn>markers</dfn>. By ticking <kbd
+  class="option">CD</kbd>, you instruct Ardour to create a <dfn>CD track
+  index</dfn> from this marker, which will be included in the TOC or CUE file when you
+  export.</dd>
+  <dt>Ranges (Including CD Track Ranges)</dt>
+  <dd>This is the list of <dfn>ranges</dfn> (including <dfn>CD track
+  ranges</dfn>). Ticking <kbd class="option">CD</kbd> will convert
+  the range to a <dfn>CD track</dfn>, which will again be included in
+  exported TOC or CUE files. This is relevant for Disk-At-Once recordings
+  that may contain audio data between tracks.</dd>
+</dl>
 
 
 
@@ -10189,75 +10239,6 @@ part: subchapter
   &amp; Marks List</kbd> in the Editor list.
 </p>
 
----
-title: Ranges &amp; Marks List
-part: subchapter
----
-
-<p>
-  The <dfn>Ranges &amp; Marks List</dfn> is a tab in the <dfn>Editor
-  Lists</dfn> area on the right of the Editor window. If the editor
-  list area isn't visible it can be enabled by checking
-  <kbd class="option">View &gt; Show Editor List</kbd>.
-  The Ranges &amp; Marks list can be used as a single point
-  of control for all range and location markers (including the punch and
-  loop ranges), or as a supplement to other methods of working with them.
-</p>
-
-<h2>Common elements</h2>
-
-<p>
-  Each section has a set of <dfn>editable <a
-  href="/ardours-interface/using-ardour-clock-displays/">clock widgets</a></dfn>
-  which display
-  the location of a marker, or the start, end, and duration times of a range,
-  respectively.<br />
-  The <kbd class="menu">Use PH</kbd> buttons allow you to set
-  the corresponding clock to the current playhead position.
-  A <kbd class="mouse">Middle</kbd> click on any of the clocks will move
-  the playhead to that location. Both functions are also available from the
-  clock context menus.<br />
-  Right clicking on any of the clocks brings up a context menu that allows
-  changing of the display between Timecode, Bars:Beats, Minutes:Seconds,
-  and Samples.<br />
-</p>
-<p>
- The <kbd class="menu">&mdash;</kbd> (subtract) button in front of each
- user-defined range or marker in the list allows that particular item to
- be removed. The name fields of custom ranges and markers can be edited.
-</p>
-<p>
-  The <kbd class="option">Hide</kbd> checkboxes make markers and ranges invisible
-  on the respective ruler to reduce visual clutter; the markers remain
-  active however, and can be used normally.<br />
-  Selecting <kbd class="option">Lock</kbd> prevents the respective marker
-  from being moved until unlocked.
-  Where applicable, <kbd class="option">Glue</kbd> fixes the marker position
-  relative to the current musical position expressed in bars and beats, rather
-  than the absolute time. This will make the respective marker follow
-  changes in the tempo map.
-</p>
-<p>
-  At the bottom of the list are buttons to add new markers or ranges.
-</p>
- <h2>List sections</h2>
-
-<dl>
-  <dt>Loop/Punch Ranges</dt>
-  <dd>This list shows the current <dfn>loop</dfn> and <dfn>punch</dfn> range
-  settings. Since these are built-in ranges, you cannot rename or remove them.</dd>
-  <dt>Markers (Including CD Index)</dt>
-  <dd>This section lists the session's <dfn>markers</dfn>. By ticking <kbd
-  class="option">CD</kbd>, you instruct Ardour to create a <dfn>CD track
-  index</dfn> from this marker, which will be included in the TOC or CUE file when you
-  export.</dd>
-  <dt>Ranges (Including CD Track Ranges)</dt>
-  <dd>This is the list of <dfn>ranges</dfn> (including <dfn>CD track
-  ranges</dfn>). Ticking <kbd class="option">CD</kbd> will convert
-  the range to a <dfn>CD track</dfn>, which will again be included in
-  exported TOC or CUE files. This is relevant for Disk-At-Once recordings
-  that may contain audio data between tracks.</dd>
-</dl>
 
 ---
 title: Moving Markers
diff --git a/source/images/status-bar.png b/source/images/status-bar.png
new file mode 100644 (file)
index 0000000..c9256de
Binary files /dev/null and b/source/images/status-bar.png differ