]> Shamusworld >> Repos - ardour-manual/commitdiff
Adding documentation about busses and VCAs, updating screenshots
authorEd Ward <edwsaintesprit@hotmail.com>
Mon, 9 Jan 2017 14:08:15 +0000 (15:08 +0100)
committerPaul Davis <paul@linuxaudiosystems.com>
Tue, 10 Jan 2017 10:35:19 +0000 (10:35 +0000)
18 files changed:
_manual/10_working-with-tracks/02_adding-tracks-and-busses.html [deleted file]
_manual/10_working-with-tracks/02_busses-and-vcas.html [new file with mode: 0644]
_manual/10_working-with-tracks/03_adding-tracks-and-busses.html [new file with mode: 0644]
_manual/10_working-with-tracks/04_selecting-tracks.html [moved from _manual/10_working-with-tracks/03_selecting-tracks.html with 100% similarity]
_manual/10_working-with-tracks/05_controlling-track-appearance.html [moved from _manual/10_working-with-tracks/04_controlling-track-appearance.html with 100% similarity]
_manual/10_working-with-tracks/06_controlling-track-ordering.html [moved from _manual/10_working-with-tracks/05_controlling-track-ordering.html with 100% similarity]
_manual/10_working-with-tracks/07_bus-controls.html [moved from _manual/10_working-with-tracks/06_bus-controls.html with 92% similarity]
_manual/10_working-with-tracks/08_audio-track-controls.html [moved from _manual/10_working-with-tracks/07_audio-track-controls.html with 100% similarity]
_manual/10_working-with-tracks/09_midi-track-controls.html [moved from _manual/10_working-with-tracks/08_midi-track-controls.html with 100% similarity]
_manual/10_working-with-tracks/11_track-context-menu.html [moved from _manual/10_working-with-tracks/09_track-context-menu.html with 100% similarity]
source/images/a3_nonlayered_example.png
source/images/add-track-or-bus.png
source/images/connecting_bus_output.png [new file with mode: 0644]
source/images/connecting_bus_send.png [new file with mode: 0644]
source/images/connecting_to_vca.png [new file with mode: 0644]
source/images/typical-audio-track-controls.png
source/images/typical-bus-controls.png
source/images/vcas.png [new file with mode: 0644]

diff --git a/_manual/10_working-with-tracks/02_adding-tracks-and-busses.html b/_manual/10_working-with-tracks/02_adding-tracks-and-busses.html
deleted file mode 100644 (file)
index 21aade3..0000000
+++ /dev/null
@@ -1,51 +0,0 @@
----
-layout: default
-title: Adding Tracks and Busses
----                        
-
-<img class="right" src="/images/add-track-or-bus.png" alt="the add-track dialog" />
-<p>A track or bus can be added to a session in various ways:</p>
-<ul>
-  <li>Choose <kbd class="menu">Track &gt; Add Track or Bus</kbd>.</li>
-  <li><kbd class="mouse">Right</kbd>-click in an empty part of the track controls area.</li>
-  <li>Click the <kbd class="menu">Plus (+)</kbd> button underneath the list of tracks in the mixer.</li>
-</ul>
-<p>
-  Any of these actions will open the Add Track or Bus dialog. Note that any 
-  new tracks from this dialog will appear after the last currently selected 
-  track, or at the end if no track is selected.
-</p>
-<dl>
-  <dt>Add</dt>
-  <dd>Here you can select the number of tracks or busses you wish to create, and
-  their <a href="/working-with-tracks/track-types/">types</a>.</dd>
-  <dt>Configuration</dt>
-  <dd>This menu lets you choose from a number of route
-  templates, which determine the number of input ports and optionally
-  contain plugins and other mixer strip configuration.</dd>
-  <dt>Track mode</dt>
-  <dd>This option is only available for audio tracks. See <a href="/working-with-tracks/track-types/#trackmodes">Track Modes</a> for details.</dd>
-  <dt>Instrument</dt>
-  <dd>This option is only available for MIDI tracks and lets you select a
-  default instrument from the list of available plugins.</dd>
-  <dt>Group</dt>
-  <dd>Tracks and busses can be assigned groups so that a selected range of 
-  operations are applied to all members of a group at the same time (selecting 
-  record enable, or editing, for example). This option lets you assign to an 
-  existing group, or create a new group.</dd>
-</dl>
-<p>
-  New tracks appear in both the editor and mixer windows. The editor window 
-  shows the timeline, with any recorded data, and the mixer shows just the 
-  processing elements of the track (its plugins, fader and so on).
-</p>
-
-<h2>Removing Tracks and Busses</h2>
-<p>
-  To <dfn>remove</dfn> tracks and busses, select them, <kbd
-  class="mouse">right</kbd>-click and choose <kbd
-  class="menu">Remove</kbd> 
-  from the menu. A warning dialog will pop up, as track removal cannot be undone; 
-  use this option with care!
-</p>
-
diff --git a/_manual/10_working-with-tracks/02_busses-and-vcas.html b/_manual/10_working-with-tracks/02_busses-and-vcas.html
new file mode 100644 (file)
index 0000000..0c27d58
--- /dev/null
@@ -0,0 +1,119 @@
+---
+layout: default
+title: Busses and VCAs
+---                        
+
+<p>
+  In order to use the process of mixing, Ardour offers two tools traditionally found on hardware mixing consoles : <dfn>Busses</dfn> and <dfn><abbr title="Voltage-Controlled Amplifier">VCA</abbr></dfn>s.
+</p>
+
+<h2>Busses</h2>
+
+<p>
+  An Ardour bus can be considered a virtual track, as in a track that doesn't have a playlist (so, no regions).
+</p>
+
+<p>
+  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. 10 discrete delay plugins on 10 different tracks, busses are often used as receivers of <a href="/signal-routing/aux-sends/">sends</a>, and only 1 delay plugin is used on this bus, reducing the processing power needed.
+</p>
+
+<p class="note">Note that the Master strip, which by default receives the output from all tracks, <em>is</em> a bus itself.</p>
+
+<h3>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 its input (which is 1 midi input instead of <em>n</em> audio), 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.
+</p>
+
+<p>
+  MIDI bus are 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.
+</p>
+
+<p>
+  Depending on the user's workflow and the way busses are used, 2 possibilities exists :
+</p>
+
+<h3>Connecting a track to a bus via outputs</h3>
+
+<img class="right" 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).
+</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... 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... &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.
+</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. 
+</p>
+
+<h2>VCAs</h2>
+
+<img class="left" src="/images/vcas.png" alt="VCAs strips">
+
+<p>
+   Although track/bus <a href="/working-with-tracks/track-and-bus-groups/">groups</a> offer a certain kind of grouped-control over gain, solo, mute and more, traditional mixing consoles have long had group master channels ("VCAs") which allows to combine both a single fader to control the group level while also allowing you to easily adjust the relative levels inside the group. For large projects, this can make mixing much easier to control.
+</p>
+
+<p> 
+  It allows to use either or both of the conventions for combining multiple masters:
+</p>
+
+<ul>
+  <li>Nest VCAs (VCA 2 controls VCA 1 etc.)</li>
+  <li>Chain VCAs (VCA 1 and VCA2 both control track or bus N)</li>
+</ul>
+
+<h3>Using a VCA strip</h3>
+
+<p>
+A VCA strip is made of (from top to bottom in the screenshot) :
+</p> 
+
+<ul>
+  <li><dfn>1</dfn>: number of the VCA</li>
+  <li><dfn>X</dfn>: allows to hide the VCA strip. Left clicking this button toggles the exclusive visibility of the tracks connected to this VCA</li>
+  <li><dfn>M</dfn>: mutes the VCA</li>
+  <li><dfn>S</dfn>: solos the VCA</li>
+  <li><dfn>A level meter</dfn>: allows to adjust the level of the VCA</li>
+  <li><dfn>~vca~</dfn>: a VCA button to optionally connect to another VCA</li>
+</ul>
+
+<p>Right-clicking the name button shows a context menus comprised of :</p>
+
+<ul>
+  <li><kbd class="menu">Rename</kbd>: Renames the VCA</li>
+  <li><kbd class="menu">Color...</kbd>: Changes the color of the VCA button in the tracks connected to this one</li>
+  <li><kbd class="menu">Drop All Slaves</kbd>: Deletes all connections to this VCA, i.e. no tracks are controlled by this VCA anymore</li>
+  <li><kbd class="menu">Remove</kbd>: Deletes this VCA</li>
+</ul>
+
+<h3>Connecting to a VCA strip</h3>
+
+<img class="left" src="/images/connecting_to_vca.png" alt="Connecting to VCA">
+
+<p>
+       Connecting a track/bus/VCA to a VCA is as simple as clicking the VCA button on any mixer strip and choosing the VCA to connect to. 
+</p>
+
+<p class="note">The VCA button only shows up in mixer strips when at least 1 VCA exists, i.e., you have to first create a VCA before connecting it.
+</p>
+  
+  
diff --git a/_manual/10_working-with-tracks/03_adding-tracks-and-busses.html b/_manual/10_working-with-tracks/03_adding-tracks-and-busses.html
new file mode 100644 (file)
index 0000000..5bb142f
--- /dev/null
@@ -0,0 +1,54 @@
+---
+layout: default
+title: Adding Tracks, Busses and VCAs
+---                        
+
+<img class="right" src="/images/add-track-or-bus.png" alt="the add-track dialog" />
+<p>A track, bus or VCA can be added to a session in various ways:</p>
+<ul>
+  <li>Choose <kbd class="menu">Track &gt; Add Track, Bus or VCA...</kbd>.</li>
+  <li><kbd class="mouse">Right</kbd>-click in an empty part of the track controls area.</li>
+  <li>Click the <kbd class="menu">Plus (+)</kbd> button underneath the list of tracks in the mixer.</li>
+</ul>
+<p>
+  Any of these actions will open the Add Track/Bus/VCA dialog.
+</p>
+<dl>
+  <dt>Add</dt>
+  <dd>Here you can select the number of tracks, busses or VCAs you wish to create, and
+  their <a href="/working-with-tracks/track-types/">types</a>.</dd>
+  <dt>Name</dt>  
+  <dd>Defines the name of the new track(s). If multiple tracks are created, or if a track with the same name already exists, a space and number will be happened at the end (e.g. : Audio 1, Audio 2...)</dd>
+  <dt>Configuration</dt>
+  <dd>This menu lets you choose from a number of route templates, which determine the number of input ports and optionally contain plugins and other mixer strip configuration. The most common choices here are <em>mono</em> and <em>stereo</em>.</dd>
+  <dt>Record mode</dt>
+  <dd>This option is only available for audio tracks and affects how it behaves when recording. See <a href="/working-with-tracks/track-types/#trackmodes">Track Modes</a> for details.</dd>
+  <dt>Instrument</dt>
+  <dd>This option is only available for MIDI tracks and busses and lets you select a
+  default instrument from the list of available plugins.</dd>
+  <dt>Group</dt>
+  <dd>Tracks and busses can be assigned groups so that a selected range of 
+  operations are applied to all members of a group at the same time (selecting 
+  record enable, or editing, for example). This option lets you assign to an 
+  existing group, or create a new group.</dd>
+  <dt>Insert</dt>
+  <dd>Defines where in the track list is the track created. The default is <em>Last</em>, i.e. after all the tracks and busses, and can also be <em>First</em>, <em>Before Selection</em> (to place it just above the selected track) or <em>After selection</em>.</dd>
+  <dt>Output Ports</dt>
+  <dd>Defines how the number of output responds to adding a plugin with a different number of outputs than the track itself. in <em>Strict I/O</em> mode, the track will only use a few of the plugins I/O and will keep its own number of output fixed, while in <em>lexible I/O</em> mode, it will automatically adapt to the I/O of its plugins. See <a href="/signal-routing/signal-flow/">Signal flow</a> to learn more about those options.</dd>
+</dl>
+
+<p>
+  New tracks appear in both the editor and mixer windows. The editor window 
+  shows the timeline, with any recorded data, and the mixer shows just the 
+  processing elements of the track (its plugins, fader and so on).
+</p>
+
+<h2>Removing Tracks and Busses</h2>
+<p>
+  To <dfn>remove</dfn> tracks and busses, select them, <kbd
+  class="mouse">right</kbd>-click and choose <kbd
+  class="menu">Remove</kbd> 
+  from the menu. A warning dialog will pop up, as track removal cannot be undone; 
+  use this option with care!
+</p>
+
similarity index 92%
rename from _manual/10_working-with-tracks/06_bus-controls.html
rename to _manual/10_working-with-tracks/07_bus-controls.html
index ed03c5c00bfb33bc34711956391aeba82e9c173a..4b0bc59df0c963c67f093831e2178d851219dcb4 100644 (file)
@@ -13,17 +13,17 @@ title: Bus Controls
   The control buttons to the right-hand side are:
 </p>
 <dl>
-  <dt id="mute">m</dt>
+  <dt id="mute">M</dt>
   <dd><dfn>Mute</dfn> &mdash; click to mute the bus. Right-click to display 
   a menu which dictates what particular parts of the bus should be muted.</dd>
-  <dt id="solo">s</dt>
+  <dt id="solo">S</dt>
   <dd><dfn>Solo</dfn> &mdash; solo the bus. The behaviour of the solo system 
   is described in detail in the section <a
   href="/mixing/muting-and-soloing/">Muting and Soloing</a>.</dd>
-  <dt id="automation">a</dt>
+  <dt id="automation">A</dt>
   <dd><dfn>Automation</dfn> &mdash; opens the automation menu for the 
   bus. For details see <a href="/automation/">Automation</a>.</dd>
-  <dt id="group">g</dt>
+  <dt id="group">G</dt>
   <dd><dfn>Group</dfn> &mdash; lets you assign the bus to an existing or a
   new group. For details see <a href="/working-with-tracks/track-and-bus-groups/">Track and bus groups</a>. </dd>
 </dl>
index 9ce600c4b2aa97f66c586031a5ae3602427c7eb7..ddd864ee7a976b7d112b852245efaff7e6413adf 100644 (file)
Binary files a/source/images/a3_nonlayered_example.png and b/source/images/a3_nonlayered_example.png differ
index 58694036e8b7ed420e883ca04d93882034f593e0..5c5b7e883628e39aaa1f19f28fa85abb8e910eb9 100644 (file)
Binary files a/source/images/add-track-or-bus.png and b/source/images/add-track-or-bus.png differ
diff --git a/source/images/connecting_bus_output.png b/source/images/connecting_bus_output.png
new file mode 100644 (file)
index 0000000..ff0ede5
Binary files /dev/null and b/source/images/connecting_bus_output.png differ
diff --git a/source/images/connecting_bus_send.png b/source/images/connecting_bus_send.png
new file mode 100644 (file)
index 0000000..7a6303c
Binary files /dev/null and b/source/images/connecting_bus_send.png differ
diff --git a/source/images/connecting_to_vca.png b/source/images/connecting_to_vca.png
new file mode 100644 (file)
index 0000000..d83dac1
Binary files /dev/null and b/source/images/connecting_to_vca.png differ
index 8664ee887b0a1b1f7e41e18c81feedf5ac9f3994..c6226cf9a6bfcff6f4006f60cba05b3d08a6b46e 100644 (file)
Binary files a/source/images/typical-audio-track-controls.png and b/source/images/typical-audio-track-controls.png differ
index 8fd276e1523003f37f755c8aa28aba6141881a5b..c8f68fbc6d5cb00ea8dfd440f5cf9a9ba1d6fdea 100644 (file)
Binary files a/source/images/typical-bus-controls.png and b/source/images/typical-bus-controls.png differ
diff --git a/source/images/vcas.png b/source/images/vcas.png
new file mode 100644 (file)
index 0000000..e16f09e
Binary files /dev/null and b/source/images/vcas.png differ