]> Shamusworld >> Repos - ardour-manual-diverged/blob - include/working-with-extenders.html
Sync with master branch.
[ardour-manual-diverged] / include / working-with-extenders.html
1 ---
2 layout: default
3 title: Working With Extenders
4 menu_title: Working With Extenders
5 ---
6
7 <p>
8   Extenders will require a custom file as there are no combinations listed
9   at this time. The best way is to start with the mc.device file and copy it
10   to a new name such as xt+mc.device and then edit that file. It is best to
11   name the file with the order the devices are expected to be used in as
12   the position of the master device is specified in this file.
13 </p>
14 <p>
15   The two lines of interest are:
16 <p>
17 <pre>
18  &lt;Extenders value="0"/&gt;
19  &lt;MasterPosition value="0"/&gt;
20 </pre>
21 <p>
22   Add these two lines if they are not present. The <code>Extenders</code>
23   value is the number of extenders used and should not include the master in
24   that number.
25 </p>
26 <p>
27   When an <code>Extenders</code> value of greater than 0 is used, extra midi
28   ports will appear for the extenders to be connected to. The MIDI ports
29   for the controllers will be named <code>mackie control #1</code>,
30   <code>mackie control #2</code> and up. The numbers will go from left to
31   right. That is, from lowest number channel to highest.
32 </p>
33 <p>
34   The <code>MasterPosition</code> value is the port number the master unit
35   (with the master fader) is connected to. So if there are three surfaces,
36   <code>&lt;MasterPosition value="1"/&gt;</code> will expect the master on
37   the left, <code>&lt;MasterPosition value="2"/&gt;</code> would be master
38   in the middle and <code>&lt;MasterPosition value="3"/&gt;</code> would be
39   master on the right. So the position matches the port name.
40 </p>
41 <p class="note">
42   The default value of <code>&lt;MasterPosition value="0"/&gt;</code> has
43   the same effect as <code>&lt;MasterPosition value="1"/&gt;</code>.
44 </p>
45 <p>
46   If the <code>MasterPosition</code> value does not properly match the
47   physcal position and MIDI port, the master fader and global controls will
48   not work. The master unit will act like an extender.
49 </p>