Shamusworld >> Repos - ardour-manual/blob - include/working-with-extenders.html

   1
   2 <p>
   3   There are currently 5 devices pre-configured to work with extenders.
   4   Two of them are for one master and one extender with the master on the
   5   right side or master on the left side. There are three presets for a
   6   master and two extenders with the master on the left, in the center
   7   and on the right. While these files will work for many uses there may
   8   be cases where a custom device profile makes more sense.
   9   The best way is to start with the *.device file in the <a
  10   href="https://github.com/Ardour/ardour/tree/master/mcp">
  11   Source Tree</a> that matches your
  12   master device and copy it to a new name such as xt+mc.device in the
  13   <a href="@@files-and-directories-ardour-knows-about">
  14   user config</a> sub directory <code>mcp</code> and then edit that file. It is best to
  15   name the file with the order the devices are expected to be used in as
  16   the position of the master device is specified in this file.
  17 </p>
  18 <p>
  19   The three lines of interest are:
  20 <p>
  21 <pre>
  22  &lt;Name value="Device name"/&gt;
  23  &lt;Extenders value="0"/&gt;
  24  &lt;MasterPosition value="0"/&gt;
  25 </pre>
  26 <p>
  27   Add any lines that are not present.
  28 </p>
  29 <p>
  30   The <code>Name</code> value should be a unique name so it is obvious
  31   in the list of devices (so change it).
  32 </p>
  33 <p>
  34   The <code>Extenders</code>
  35   value is the number of extenders used and should not include the master in
  36   that number.
  37 </p>
  38 <p>
  39   When an <code>Extenders</code> value of greater than 0 is used, extra midi
  40   ports will appear for the extenders to be connected to. The MIDI ports
  41   for the controllers will be named <code>mackie control in/out</code> for
  42   the master, <code>mackie control in/out ext #*</code> where * is the
  43   position of the extender from left to right. So for a master in the middle
  44   with an extender on either side, the ports from left to right will be
  45   mackie control in/out ext #1, mackie control in/out and mackie control in/out ext #3.
  46 </p>
  47 <p>
  48   If using the MCP GUI to connect surfaces the top surface is the leftmost
  49   and the bottom is the rightmost. The GUI shows explicitly the position
  50   of the main or master surface within the group of surfaces.
  51 </p>
  52
  53 <figure>
  54   <img src="/images/mcp-extender-position.png" alt="The Mackie Control Device Dialog">
  55   <figcaption>
  56     The Mackie Control Device Dialog
  57   </figcaption>
  58 </figure>
  59
  60 <p>
  61   The <code>MasterPosition</code> value is the position the master unit
  62   (with the master fader) is located at within the group of surfaces.
  63   The surfaces are numbered from 1 at the left side and up. So if there
  64   are three surfaces, <code>&lt;MasterPosition value="1"/&gt;</code> will
  65   expect the master on the left, <code>&lt;MasterPosition value="2"/&gt;</code>
  66   would be master in the middle and <code>&lt;MasterPosition value="3"/&gt;</code>
  67   would be master on the right.
  68 </p>
  69 <p class="note">
  70   The default value of <code>&lt;MasterPosition value="0"/&gt;</code> has
  71   the same effect as <code>&lt;MasterPosition value="1"/&gt;</code>.
  72 </p>
  73 <p>
  74   If the <code>MasterPosition</code> value does not properly match the
  75   physical position and MIDI port, the master fader and global controls will
  76   not work. The master unit will act like an extender.
  77 </p>
  78