manual/include/osc58-linking-surfaces.html
2020-03-27 09:15:36 -07:00

171 lines
8.7 KiB
HTML

<p>
As of Ardour 6.0, Ardour provides the possibility of linking two or
more surface to work as one surface. This means that two surfaces,
one with 8 strips and one with 6 strips would look like a single 14
strip surface. A <code>/bank_up</code> or down on either surface with bank the two
so that they bank in 14 strip increments.
</p>
<p class="note">
Ardour 5.0 to 5.12 can use two surfaces as shown in <a href="#example3">Example 3</a>.
</p>
<h2>Surface Linking Concepts</h2>
<p>
<ul>
<li>A group of surfaces linked together are called a <code>Link Set</code>. A
<code>Link Set</code> is called by a positive integer number.</li>
<li>There may be more than one <code>Link Set</code> at a time used
with Ardour.</li>
<li>Each surface inside a <code>Link Set</code> has a <code>Link Id</code>.</li>
<li>The <code>Link ID</code> is a positive integer numbering consecutive
surfaces starting from 1 for the left most and going up to the right. So
if there are three surfaces in a <code>Link Set</code>, The left surface
will have a <code>Link Id</code> of <em>1</em>, the middle surface will
have a <code>Link Id</code> of <em>2</em> and the right surface will
have a <code>Link Id</code> of <em>3</em>.</li>
<li>There may not be skipped <code>Link Ids</code>. If there are a
surface 1 and 3, there must also be a surface 2. Surface 1 must always
exist. If any surface is missing, the track names will indicate the
<code>Link Id</code> of the first device missing.</li>
<li>In most things, surfaces are separate and can do things independently.
<ul>
<li>Each surface can have a different <code>Gain Mode</code></li>
<li>Each surface has it's own <code>Bank Size</code></li>
<li>Each surface has it's own <code>Feedback</code></li>
<li>Each surface has it's own <em>Expanded Strip</em></li>
</ul>
However, some things are shared by all surfaces in a <code>Link Set</code>:
<ul>
<li>Banking is done as a unit and each surface bank start is
determined by the <code>Link Set</code>. Any surface can
<em>Bank Up</em> or <em>Bank Down</em>.</li>
<li>All surfaces share the same <em>strip types</em>. Setting
<em>Strip Types</em> in any one surface sets it for the whole
<code>Link Set</code>.</li>
</ul>
</li>
</ul>
</p>
<h2>Setting Up a Link Set</h2>
<p>
There are only two OSC commands needed to set up a <code>Link Set</code>:
</p>
<table class="dl">
<tr><th><kbd class="osc">/link/set <em>linkset</em> <em>linkid</em></kbd></th>
<td>Where <em>linkset</em> is the Link Set this surface will be added to and
<em>linkid</em> is the Link Id of this surface.</td></tr>
<tr><th><kbd class="osc">/link/bank_size <em>linkset</em> <em>banksize</em></kbd></th>
<td>Where <em>linkset</em> is the Link Set this surface will be added to and
<em>banksize</em> is the target bank size for this Link Set. This Link Set
will not operate unless the total strip numbers is <em>banksize</em>.</td></tr>
</table>
<p>
It is also possible to send link set and ID values as part of a
<code>/set_surface</code> command.
<kbd class="osc">/set_surface <em>bank_size</em> <em>strip_types</em>
<em>feedback</em> <em>fadermode</em> <em>send_page_size</em> <em>plugin_page_size</em>
<em>port</em> <em>linkset</em> <em>linkid</em></kbd>
</p>
<p> The <code>/link/bank_size</code> command is optional. Ardour defaults
to linking with auto sizing banks where the <code>Link Set</code>
bank size is determined by adding the available surface bank sizes
together. So long as the <code>Link Ids</code> are consecutive, the
<code>Link Set</code> is considered ready. If the surface wants to make
sure all surfaces are present before the <code>Link Set</code> is
ready, the <code>/link/bank_size</code> command will not allow the
<code>Link Set</code> to be ready until the surface bank sizes add up
to the <code>Link Set's</code> bank size.
</p>
<p>
Setting up a linked set of surfaces is a simple as choosing a number
for the <code>Link Set</code>, <em>1</em> will work fine if there is
only one linked set of surfaces, and giving each surface a <code>
Link Id</code>. This can be done with the same method as the <code>
/set_surface</code> command is sent or by having each surface send
the <code>/link/set</code> command. As with other commands, the first
parameter (linkset) may be sent inline: <code>/link/set/1 <em>linkid</em></code>
for those surfaces unable to send multi parameter OSC messages.
</p>
<h2>Example Multi Device Surfaces</h2>
<h3>Example 1</h3>
<p>
Assuming two devices, the left device has 8 strips and very little
else on it's main page or tab. It may have secondary pages or tabs or
a physical control section to access the extra selected strip controls
like send levels or plugin controls. The right device has only 6
strips because it also has Master and Monitor channel as well as
transport controls. It also has a select section. As part of it's
Global controls it has a Bank up and a bank down button. (there is
nothing stopping the left surface from also having banking buttons)
The left surface will be linkid <em>1</em> and the right surface will be
linkid <em>2</em>. For this example the linkset will be <em>1</em>.
</p>
<p>
Device <em>1</em> will have a "Connect" button that will send:
<code>/set_surface iiiiiiiii 8 159 8323 0 0 0 0 1 1</code> and the second
device will have two buttons. One will be a "Connect" button that
sends: <code>/set_surface iiii 6 159 8403 0</code> and the other
will be a "Link" button that will send: <code>/link/set ii 1 2</code>.
These devices use two different methods of setup both to illustrate
their use and because this will allow them to be used unlinked. Device
<em>1</em> even as a linked device will operate on it's own as a one
device <code>Link Set</code>. However, device <em>2</em> would show
an error condition if device <em>1</em> is not present so we have a
seperate "Link" button. This is an optional way of doing things and
both could use just one "Connect" button or both could have a separate
"Link" button. Device <em>2</em> could also have an "Unlink" button
that sends: <code>/link/set ii 0 0</code> if desired.
</p>
<p>
To use these two devices as one, the "Connect" button on both devices and
the "Link" button on the second device are pressed in any order. The two
surfaces will now act as one surface with 14 bankable strips.
</p>
<h3>Example 2</h3>
<p>
This example will be more complex and use a total of five devices. The
first three devices will form Link Set <em>1</em> and have 8 strips each.
They are similar to the left device above, but will only show "input"
strips. The last two devices will form Link Set <em>2</em>. Device <em>1</em>
will be similar to the first three devices with 8 strips and the other
will be similar to the 6 strip device in example 1 having Master and
transport controls as well. The devices in Link Set 2 will be set up
to only use bus and VCA strips and so don't need to include record
enable buttons etc. It is expected that all devices have
banking buttons, but at least one surface in each Link Set would have
to have them.
</p>
<p>
Devices 1 to 3 (from left to right) would each have a "Connect"
button that sends: <code>/set_surface iiiiiiiii 8 3 8323 0 0 0 0 1 n</code>
where <em>n</em> is the position or Link Id of that surface from 1 to
3, left to right. Device 4 would use: <code>/set_surface iiiiiiiii 8
156 8323 0 0 0 0 2 1</code> and device 5 would use: <code>/set_surface
iiiiiiiii 6 156 8403 0 0 0 0 2 2</code>.
</p>
<p>
As before, the "Connect" on each surface is pressed in any order and
the resulting surface would have 24 input strips where the banking
buttons on any of the first three surfaces would bank those three
surfaces 24 strips at a time through the input strips (assuming more
than 24 input strips are available). The last two strips would form
a master and bus section with 14 bus only strips that will bank through
the bus strips (assuming more than 14 bus strips). This combined
surface would have 38 strips (plus Master) all together.
</p>
<h2 id="example3">Example 3</h2>
<p>
In this example there are two devices as in example 1. However, the
goal is to have only input strips on the left device and only bus strips,
Master and transport controls on the right device. In this case linking
is not needed. The left device would use a "Connect" button that sent:
<code>/set_surface iiii 8 3 8323 0</code> and the right device would
use a "Connect" button that sent: <code>/set_surface iiii 6 156 8403 0</code>.
The banking buttons on the left surface would bank through the input
channels and the banking buttons on the right surface would bank
through the buses and VCAs. As this example does not use Ardours OSC
linking commands, it will also work with Ardour versions 5.0 to 5.12.
</p>