]> Shamusworld >> Repos - ardour-manual-diverged/commitdiff
Merge branch 'master' of http://shamusworld.gotdns.org/git/ardour-manual
authorEd Ward <edwsaintesprit@hotmail.com>
Thu, 12 Jan 2017 19:32:56 +0000 (20:32 +0100)
committerEd Ward <edwsaintesprit@hotmail.com>
Thu, 12 Jan 2017 19:32:56 +0000 (20:32 +0100)
1  2 
master-doc.txt

diff --combined master-doc.txt
index 08783489cac4a1cb9743ba0b69dda90cb54b9469,8b349f6705890251eaf0b3c67bf7fffe48702bd6..84440cacd48a04120239fdaca7b583ccbe380a65
@@@ -7074,7 -7074,7 +7074,7 @@@ part: subchapte
    The <dfn>Transport Bar</dfn> groups all the actions regarding the control of playback and recording.
  </p>
  
- <img src="/images/transport.png" alt="The transport controls" />
+ <p class="center"><img src="/images/transport.png" alt="The transport controls" /></p>
  
  <p>
    This bar is made of (from left to right):
  
  <ul>
    <li>
-     <dfn>Midi Panic</dfn>: allows to immediately stop all midi output.
+     <dfn>Midi Panic</dfn>: Immediately stops all midi output.
    </li>
    <li>
      <dfn>Enable/disable Audio Click</dfn>: Toggles (on/off) a click track (metronome) along the <a href="/tempo-meter/tempo-and-meter/">tempo</a>.
      <dfn>Go to End of the Session</dfn>: Jumps forward to the end of the session, as defined by the <a href="/working-with-markers/">end marker</a>.
    </li>
    <li>
-     <dfn>Play Loop Range</dfn>: Repeats the defined <a href="/controlling-playback/looping-the-transport/">loop</a> as defined by the <a href="/working-with-markers/loop-range/">Loop range</a>, until the "Stop playback" button is pressed. Clicking the "Play loop Range" button while already active switches to normal Play mode, which allows to exit the loop without stopping and restarting the playback.
+     <dfn>Play Loop Range</dfn>: Repeats the defined <a href="/controlling-playback/looping-the-transport/">loop</a> as defined by the <a href="/working-with-markers/loop-range/">Loop range</a>, until the "Stop playback" button is pressed. Clicking the "Play loop Range" button while already active switches to normal Play mode, which exits the loop without stopping and restarting playback.
    </li>
    <li>
      <dfn>Play Range/Selection</dfn>: If a range has been defined using the Range Mode button, plays the range, of if an audio or MIDI region is selected, plays this region. In both cases, the playback stops at the end of the range or selected region.
    </li>
    <li>
-     <dfn>Play from playhead</dfn>: Starts the playback and optionally record (more bellow).
+     <dfn>Play from playhead</dfn>: Starts the playback and optionally record (more below).
    </li>
    <li>
      <dfn>Stop</dfn>: Whatever the playing mode (loop, range, &hellip;) stops all playback. Depending on other settings, some effects (like chorus or reverb) might still be audible for a while.
    </li>
    <li>
-     <dfn>Toggle Record</dfn>: Global switch button to activate/deactivate recording. While active, the button blinks red. The button doesn't start the recording itself: if one or more tracks are marked as record-enabled, pressing the "Play from Playhead" starts the recording on this/these track(s). See <a href="/recording/">Recording</a>.
+     <dfn>Toggle Record</dfn>: Global switch button to activate/deactivate recording. While active, the button blinks red. The button doesn't start recording by itself: if one or more tracks are marked as record-enabled, pressing the "Play from Playhead" starts recording on those tracks. See <a href="/recording/">Recording</a>.
    </li>
  </ul>
  
- <p class="fixme">Language in the above paragraphs is awkward</p>
+ <p class="fixme">Add default keyboard shortcuts to the above.</p>
  
  <p class="note">
    All these actions are bound to keyboard shortcuts, which allows for speedier use and more focused work.
      <dfn>Follow Edits</dfn> is a toggle that can be used to control whether or not making a selection (range or object) will move the playhead to the start of the selection.
    </li>
    <li>
-     <dfn>Auto Return</dfn> is a toggle switch too. When active, pressing the Stop button returns the playhead to its previous position, and when inactive, pressing Stop keeps the playhead at its current location. Activating Auto Return can be useful for earing back the same part of the audio before and after having tweaked it, without having to loop on it.
+     <dfn>Auto Return</dfn> is a toggle switch too. When active, pressing the Stop button returns the playhead to its previous position, and when inactive, pressing Stop keeps the playhead at its current location. Activating Auto Return can be useful for hearing the same piece of audio before and after tweaking it, without having to set a loop range on it.
    </li>
  </ul>
  
@@@ -7461,16 -7461,15 +7461,16 @@@ part: subchapte
  </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
    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
  
    <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
    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,6 -7582,8 +7582,6 @@@ part: subchapte
  
  <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
  <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>
@@@ -7747,6 -7749,9 +7747,6 @@@ part: subchapte
    unit selector.
  </p>
  
 -<p class="fixme">Add images</p>
 -
 -
  
  ---
  title: the Nudge Controls
@@@ -7756,16 -7761,18 +7756,16 @@@ part: subchapte
  <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>
  
  
@@@ -7776,7 -7783,7 +7776,7 @@@ part: chapte
  ---
  
  <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
@@@ -7930,69 -7937,12 +7930,69 @@@ part: subchapte
  ---
  
  <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>
  
  
  
@@@ -10239,6 -10189,75 +10239,6 @@@ part: subchapte
    &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