]> Shamusworld >> Repos - ardour-manual/commitdiff
Rephrasing
authorEd Ward <edwsaintesprit@hotmail.com>
Fri, 2 Jun 2017 10:11:11 +0000 (12:11 +0200)
committerLen Ovens <len@ovenwerks.net>
Tue, 6 Jun 2017 23:06:20 +0000 (16:06 -0700)
include/audiomidi-busses-mixer-strips.html
include/control-masters-mixer-strips.html
include/edit-point-control.html
include/editor-lists.html
include/grid-controls.html
include/master-bus-strip.html
include/the-ranges-and-marks-lists.html
include/the-tracks-and-busses-list.html
include/zoom-controls.html

index e45e521311856f49139c8be557162d6f63ab6be7..2aaff9880e56a914987be3d8e77e7a465a2128a2 100644 (file)
@@ -1,28 +1,42 @@
 
-<img class="right" src="/images/bus-mixer-strip.png" alt="A bus mixer strip">
+<figure class="right">
+    <img src="/images/bus-mixer-strip.png" alt="A bus mixer strip">
+</figure>
 
 <p>
-  An Ardour bus can be considered a virtual track, as in a track that doesn't have a playlist (so, no regions).
-  Its use is to "group" some audio signals to be treated the same way. One simple use case is to group all the audio tracks containing the different drums of a drumkit. Routing all the drums tracks outputs to a bus allows, once the different levels amongst the drums have been set, to adjust the global level of the drumkit in the mix.
+  An Ardour bus can be considered a virtual track, as in a track that doesn't
+  have a playlist (so, no regions). Its use is to "group" some audio signals to
+  be treated the same way. One simple use case is to group all the audio tracks
+  containing the different drums of a drumkit. Routing all the drums tracks
+  outputs to a bus allows, once the different levels amongst the drums have been
+  set, to adjust the global level of the drumkit in the mix.
 </p>
 <p>
-  Bus usage goes way beyond this simple example though: busses, as tracks, can receive plugins for common audio treatment, and be routed themselves as needed. This makes for a very useful tool that is very commonly used both for musical purposes and computing ones: instead of using e.g. ten discrete delay plugins on ten different tracks, busses are often used as receivers of <a href="@@aux-sends">sends</a>, and only one delay plugin is used on this bus, reducing the processing power needed.
+  Bus usage goes way beyond this simple example though: busses, as tracks, can
+  receive plugins for common audio treatment, and be routed themselves as needed.
+  This makes for a very useful tool that is very commonly used both for musical
+  purposes and computing ones: instead of using e.g. ten discrete delay plugins on
+  ten different tracks, busses are often used as receivers of <a
+  href="@@aux-sends">sends</a>, and only one delay plugin is used on this bus,
+  reducing the processing power needed.
 </p>
 
 <h2>Audio Busses vs MIDI Busses</h3>
 
 <p>
-       Ardour supports 2 types of busses: Audio and MIDI. A MIDI bus differs from an audio bus just by:
+       Ardour supports two types of busses: Audio and MIDI. A MIDI bus differs from an
+  audio bus just by:
 <p>
 <ul>
   <li>its input (which is midi, as shown by the red signal lines in the processor box) instead of <em>n</em> audio</li>
-  <li>the fact that you can put an instrument on it at creation time, whereas you can't easily add an instrument to an audio bus</li>
+  <li>the fact that an instrument can be placed on it at creation time, whereas it can't easily be done for an audio bus</li>
   <li>as for tracks, the MIDI bus doesn't have a trim knob or invert phase button(s).</li>
 </ul>
 <p>
-  MIDI busses provide a particularly efficient workflow for virtual drumkits where the arrangement uses different MIDI tracks.
-  Moreover, busses with both Audio and MIDI inputs are well suited for vocoders and similar plugins,
-  where a MIDI signal controls an audio one.
+  MIDI busses provide a particularly efficient workflow for virtual drumkits where
+  the arrangement uses different MIDI tracks. Moreover, busses with both Audio and
+  MIDI inputs are well suited for vocoders and similar plugins, where a MIDI
+  signal controls an audio one.
 </p>
 <p class="note">
   Adding any audio input to a MIDI bus transforms it into an audio bus.
 
 <h2>Description</h2>
 <p>
-  Busses look and behave exactly like tracks, so they share nearly <a href="@@audiomidi-mixer-strips">all of their controls</a>.
-  The differences are:
+  Busses look and behave exactly like tracks, so they share nearly <a href="@@audiomidi-mixer-strips">
+  all of their controls</a>. The differences are:
 </p>
 <ul>
   <li>as the busses dont have a playlist (and cannot host any media), they can't be recorded on. The recording controls are not present</li>
   <li>an <kbd class="menu">Aux</kbd> button replaces these controls.</li>
 </ul>
 <p>
-  Clicking the <kbd class="menu">Aux</kbd> button makes every track that sends a signal to this bus through <a href="@@aux-sends">Aux sends</a> blink in turquoise.
-  Right clicking this button brings up a menu:
+  Clicking the <kbd class="menu">Aux</kbd> button makes every track that sends a
+  signal to this bus through <a href="@@aux-sends">Aux sends</a> blink in
+  turquoise. Right clicking this button brings up a menu:
 </p>
 <table class="dl">
   <tr><th>Assign all tracks (prefader)</th><td>Creates an Aux Send in every track, to this bus. The send is placed just before the fader</td></tr>
 
 <h2>Connecting a track to a bus</h2>
 <p>
-  Depending on the user's workflow and the way busses are used, 2 possibilities exists:
+  Depending on the user's workflow and the way busses are used, two possibilities exists:
 </p>
 
 <h3>Connecting a track to a bus via its outputs</h3>
 
 <img class="left" src="/images/connecting_bus_output.png" alt="Connecting a bus through a track's outputs">
 <p>
-       Connecting the output(s) of a track to the input(s) of the bus sends <em>all</em> the audio/MIDI to the bus. In the mixer strip, select (at the bottom) the OUTPUT button (often, by default, "Master"), and in the list, choose the input of a bus. Note that only the bus able to receive this output will show up, e.g. a mono bus wont be able to be connected to the output of a stereo track).
+       Connecting the output(s) of a track to the input(s) of the bus sends
+       <em>all</em> the audio/MIDI to the bus. In the mixer strip, select (at the
+       bottom) the OUTPUT button (often, by default, "Master"), and in the list,
+       choose the input of a bus. Note that only the bus able to receive this output
+       will show up, e.g. a mono bus wont be able to be connected to the output of a
+       stereo track).
 </p>
 <p>
-       Obviously, doing so will (by default) disconnect the output from the Master's input, which means all the audio/MIDI will be routed to the bus. For more complex routing, the OUTPUT button allows to show the <kbd class="menu">Routing Grid</kbd> that allows to plug the output of the track to multiple outputs at once, be it busses, tracks, Master&hellip; The button will then reflect these multiple connections by showing a <em>*number*</em>, number being the number of connections made in the routing grid.
+       Obviously, doing so will (by default) disconnect the output from the Master's
+  input, which means all the audio/MIDI will be routed to the bus. For more
+  complex routing, the OUTPUT button allows to show the <kbd class="menu">Routing
+  Grid</kbd> that allows to plug the output of the track to multiple outputs at
+  once, be it busses, tracks, Master&hellip; The button will then reflect these
+  multiple connections by showing a <em>*number*</em>, number being the number of
+  connections made in the routing grid.
 </p>
 
 <h3>Connecting a track to a bus via Sends</h3>
 
 <img class="left" src="/images/connecting_bus_send.png" alt="Connecting a bus through a send">
 <p>
-       This allows not to interrupt the natural flow of the signal, i.e. the track will still output to what its connected to (e.g. Master). The signal is "tapped" at the point of insertion of the send, to be sent to the bus. Right click where in the signal flow you want the send to happen, and select <kdb class="menu">New Aux Send&hellip; &gt; name_of_the_bus</kbd>.
+       This allows not to interrupt the natural flow of the signal, i.e. the track will
+  still output to what its connected to (e.g. Master). The signal is "tapped" at
+  the point of insertion of the send, to be sent to the bus, by <kbd class="mouse">right</kbd>
+  clicking where in the signal flow the signal should be tapped, and selecting <kdb class="menu">
+  New Aux Send&hellip; &gt; name_of_the_bus</kbd>.
 </p>
 <p>
-  By <kbd class="mouse">left-clicking</kbd> the send meter, it is possible to adjust the amount of signal sent to the bus. This is often the way tracks are connected to an effect bus, like a Delay bus.
+  By <kbd class="mouse">left-clicking</kbd> the send meter, it is possible to
+  adjust the amount of signal sent to the bus. This is often the way tracks are
+  connected to an effect bus, like a Delay bus.
 </p>
 
 <p class="note">
-  Busses can be plugged to other busses, through outputs or sends. Both example workflows discussed previously, i.e. busses for grouping tracks and busses for effects, can both coexist, as e.g. a "grouping" drum bus can have a send to a reverb bus, and be connected to a compressor bus.
+  Busses can be plugged to other busses, through outputs or sends. Both example
+  workflows discussed previously, i.e. busses for grouping tracks and busses for
+  effects, can both coexist, as e.g. a "grouping" drum bus can have a send to a
+  reverb bus, and be connected to a compressor bus.
 </p>
-
index f5b7f32afa3769869b3ecb291848012c82d6a1f2..70c7dbbc779fec82a30b74fa27f8db542498124d 100644 (file)
@@ -10,7 +10,7 @@
    Although track/bus <a href="@@the-track-and-bus-group-list">groups</a> offer a certain
    kind of grouped-control over gain, solo, mute and more, traditional mixing consoles have long had
    group master channels ("<abbr title="Voltage-Controlled Amplifier">VCA</abbr>s") which allows to combine
-   both a single fader to control the group level while also allowing you to easily adjust the relative
+   both a single fader to control the group level while also allowing to easily adjust the relative
    levels inside the group. For large projects, this can make mixing much easier to control.
 </p>
 <p>
@@ -63,4 +63,3 @@ A VCA strip is made of (from top to bottom in the screenshot):
   multiple buttons. Disconnecting a VCA from a track is done by unchecking this VCA in
   the list that pops up, or clicking <kbd class="menu">Unassign All</kbd> to disconnect from all VCAs at once.
 </p>
-
index 23fa4d3e4386c1536d56ebc2a6dc3f995873a8a1..3248d8ef2ea5c1133c3fb108fe4546ea31710006 100644 (file)
@@ -1,12 +1,19 @@
 
-<img class="left" src="/images/toolbar-editpoint.png" alt="Editor toolbar's Edit Point">
+<figure class="left">
+  <img src="/images/toolbar-editpoint.png" alt="Editor toolbar's Edit Point">
+</figure>
 
 <p>
-  Editing operations in a Digital Audio Workstation like Ardour can be broken down according to how many points on the timeline are required to carry the operation out. Splitting a region for example, requires just one position on the timeline (the one where the split will happen). Cutting out a time range requires two positions, one for the start of the cut and one for the end.
+  Editing operations in a Digital Audio Workstation like Ardour can be broken
+  down according to how many points on the timeline are required to carry the
+  operation out. Splitting a region for example, requires just one position on
+  the timeline (the one where the split will happen). Cutting out a time range
+  requires two positions, one for the start of the cut and one for the end.
 </p>
 
 <p>
-  In Ardour the <dfn>edit point</dfn> is the location where most single-point editing operations take place. It can be set to either of the following:
+  In Ardour the <dfn>edit point</dfn> is the location where most single-point
+editing operations take place. It can be set to either of the following:
 </p>
 
 <ul>
 </p>
 
 <p>
-  There are 2 keybindings available to cycle through the edit point options. The most common workflow tends to involve switching back and forth between the playhead and mouse as the edit point. Press the grave accent key <kbd>`</kbd> to switch between these two. Use <kbd class="mod1">`</kbd> to cycle through all three choices (including the selected marker). You can also switch the edit point using a combo-selector just right of the snap/grid unit selector.
+  There are two keybindings available to cycle through the edit point options.
+  The most common workflow tends to involve switching back and forth between the
+  playhead and mouse as the edit point. Pressing the grave accent key <kbd>`</kbd>
+  switches between these two. Using <kbd class="mod1">`</kbd> cycles through
+  all three choices (including the selected marker). The edit point can also be
+  switched using the combo-selector just right of the snap/grid unit selector.
 </p>
-
index 1e18673962701b421c58324df8142fbc641c1462..2f91a9525784c37758c9d400a79accca78108dd9 100644 (file)
@@ -1,11 +1,10 @@
 
 <p>
   At the right hand side 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
+  range of useful lists of parts of the session. It is not shown by default
+  when first starting 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>
-
index 98f30d73d5f0db39ab7a659171475b2bf0fc8f2e..e985dd9806d786210bf740bac42e8c2184203d5e 100644 (file)
@@ -85,7 +85,7 @@
     New objects will always be created at grid
     points.</br>
     Holding down the snap modifier will disable the current grid
-    setting and allow you to move the object freely.</td></tr>
+    setting and allow moving the object freely.</td></tr>
   <tr><th><kbd class="menu">Magnetic</kbd></th>
     <td>is a less strict type of snapping. Objects can still be moved to any
     position, but positions close to the relative or absolute grid points will snap.
index 133b793560d53e9af5593fd172a7f1110621fb9b..cce876f997d3489ba82bd5d7fe04d336be7136ae 100644 (file)
@@ -1,5 +1,6 @@
-
-<img class="right" src="/images/master-strip.png" alt="The Master strip in the mixer">
+<figure class="right">
+  <img src="/images/master-strip.png" alt="The Master strip in the mixer">
+</figure>
 
 <p>
   The <dfn>Master strip</dfn> in Ardour is very similar to the other busses mixer strips.
@@ -14,6 +15,5 @@
 </ul>
 
 <p class="note">
-  The Master bus strip is <em>allways</em> fixed, at the right end of the mixer, regardless of the scrolling position.
+  The Master bus strip is <em>always</em> fixed, at the right end of the mixer, regardless of the scrolling position.
 </p>
-
index 9d13ab7fbfa34a8f97fa8b48aff079dce70fb14a..9549b577e7633033c855c9e4997d9561b904ce8d 100644 (file)
@@ -18,7 +18,7 @@
   respectively.
 </p>
 <p>
-  The <kbd class="menu">Use PH</kbd> buttons allow you to set
+  The <kbd class="menu">Use PH</kbd> buttons allows 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
 <table class="dl">
   <tr><th>Loop/Punch Ranges</th>
   <td>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.</td></tr>
+  settings. Since these are built-in ranges, they cannot be renamed or removed.</td></tr>
   <tr><th>Markers (Including CD Index)</th>
   <td>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.</td></tr>
+  class="option">CD</kbd>, Ardour is instructed to create a <dfn>CD track
+  index</dfn> from this marker, which will be included in the TOC or CUE file when
+  exporting.</td></tr>
   <tr><th>Ranges (Including CD Track Ranges)</th>
   <td>This is the list of <dfn>ranges</dfn> (including <dfn>CD track
   ranges</dfn>). Ticking <kbd class="option">CD</kbd> will convert
index f9411bb8569bd46403ab2ec76811172e90928b18..1e20c1bf1e68faf944a5ec05f1d527dc6b29f611 100644 (file)
@@ -1,19 +1,25 @@
 
 <p>
-  This lists the tracks and busses that are present in the session. The list order reflects the order in the editor, and you can drag-and-drop track or bus names in the editor list to re-order them in the editor. The columns in the list represent the following:
+  This lists the tracks and busses that are present in the session. The list order
+  reflects the order in the editor, and track or bus names can be dragged-and-dropped
+  in the editor list to re-order them in the editor. The columns in the list
+  represent the following:
 </p>
 
 <table class="dl">
   <tr><th id="visible">V</th>
-  <td>whether the track or bus is visible; they can be hidden, in which case they will still play, but just not be visible in the editor; this can be useful for keeping the display uncluttered.</td></tr>
+  <td>whether the track or bus is visible; they can be hidden, in which case they
+    will still play, but just not be visible in the editor; this can be useful for
+    keeping the display uncluttered.</td></tr>
   <tr><th id="active">A</th>
-  <td>whether the track or bus is active; unactive tracks will not play, and will not consume any CPU.</td></tr>
-  <tr><th id="input">I</th>
-  <td>for MIDI tracks, whether the MIDI input is enabled; this dictates whether MIDI data from the track's inputs ports will be passed through the track.</td></tr>
-  <tr><th id="record">R</th>
-  <td>whether the track is record-enabled.</td></tr>
-  <tr><th id="record-safe">RS</th>
-  <td>whether the track is record safe; a record safe track cannot be armed for recording, to protect against a mistake.</td></tr>
+  <td>whether the track or bus is active; unactive tracks will not play, and will
+    not consume any CPU.</td></tr>
+  <tr><th id="input">I</th> <td>for MIDI tracks,
+    whether the MIDI input is enabled; this dictates whether MIDI data from the
+    track's inputs ports will be passed through the track.</td></tr>
+  <tr><th id="record">R</th> <td>whether the track is record-enabled.</td></tr>
+  <tr><th id="record-safe">RS</th> <td>whether the track is record safe; a record safe
+    track cannot be armed for recording, to protect against a mistake.</td></tr>
   <tr><th id="mute">M</th>
   <td>whether the track is muted.</td></tr>
   <tr><th id="solo">S</th>
 </table>
 
 <p class="note">
-  Each icon in these columns can be clicked to toggle the track/bus state, which is a very fast way to set multiple tracks/busses state at once.
+  Each icon in these columns can be clicked to toggle the track/bus state, which
+  is a very fast way to set multiple tracks/busses state at once.
 </p>
 
 <p>
-  As with the region list, hovering the mouse pointer over a column heading shows a tool-tip which can be handy to remember what the columns are for.
+  As with the region list, hovering the mouse pointer over a column heading shows
+  a tool-tip which can be handy to remember what the columns are for.
 </p>
-
index 7ed56117bb87d8e7e8c5c78e7166d71cb65465c2..beb6114c0a3aa41ba2b76d08e856c89e7de33c0b 100644 (file)
@@ -14,7 +14,7 @@
   <li><dfn>Edit Point</dfn> as set in the <a href="@@edit-point-control">Edit point</a> control.</li>
 </ul>
 
-<p>The 2 leftmost zoom buttons (<kbd class="menu">&minus;</kbd> and <kbd class="menu">&plus;</kbd>) use this zoom focus to zoom out and in respectively.<p>
+<p>The two leftmost zoom buttons (<kbd class="menu">&minus;</kbd> and <kbd class="menu">&plus;</kbd>) use this zoom focus to zoom out and in respectively.<p>
 
 <p>The <kbd class="menu">Zoom to session</kbd> button is a handy shortcut to zoom out or in until all the session (as defined by it's <a href="@@working-with-markers">start/end markers</a>) fits horizontally.</p>
 
@@ -24,7 +24,7 @@ allows to fit this number of tracks vertically in the screen.<p>
 <p class="note">There <em>is</em> a minimal track height to keep it visible, so
 according to you screen vertical size, some high number can have no effect.</p>
 
-<p>Inside this menu are 2 handy choices:</p>
+<p>Inside this menu are two handy choices:</p>
 
 <ul>
   <li><dfn>Selected tracks</dfn> that focus on the selected tracks. If the selected tracks are not contiguous, the unselected tracks inbetween will be hidden, see the <a href="@@the-tracks-and-busses-list">Track and Bus list</a>.</li>
@@ -32,4 +32,3 @@ according to you screen vertical size, some high number can have no effect.</p>
 </ul>
 
 <p>The rightmost buttons <kbd class="menu">Shrink tracks</kbd> and <kbd class="menu">Expand tracks</kbd> reduce or expand the vertical size of the selected tracks. If no track is selected, all the tracks will be shrunk or expanded each time the button is pushed.
-