Sync to master.

[ardour-manual-diverged] / _manual / 25_using-control-surfaces / 02_mackie-control-protocol / 05_working-with-extenders.html

diff --git a/_manual/25_using-control-surfaces/02_mackie-control-protocol/05_working-with-extenders.html b/_manual/25_using-control-surfaces/02_mackie-control-protocol/05_working-with-extenders.html
index 9f0fe7351b26d440444bb5bf166ec5e453564dcf..81f8606958b3bcc30d875416df59c7d0825429d5 100644 (file)
--- a/_manual/25_using-control-surfaces/02_mackie-control-protocol/05_working-with-extenders.html
+++ b/_manual/25_using-control-surfaces/02_mackie-control-protocol/05_working-with-extenders.html
@@ -11,9 +11,12 @@ menu_title: Working With Extenders
   master and two extenders with the master on the left, in the center
   and on the right. While these files will work for many uses there may
   be cases where a custom device profile makes more sense. 
-  The best way is to start with the *.device file that matches your 
-  master device and copy it
-  to a new name such as xt+mc.device and then edit that file. It is best to
+  The best way is to start with the *.device file in the <a
+  href="/appendix/files-and-directories/">
+  sytem config sub directory mcp</a> that matches your
+  master device and copy it to a new name such as xt+mc.device in the
+  <a href="/appendix/files-and-directories/">
+  user config sub directory mcp</a> and then edit that file. It is best to
   name the file with the order the devices are expected to be used in as
   the position of the master device is specified in this file.
 </p>
@@ -30,7 +33,7 @@ menu_title: Working With Extenders
 </p>
 <p>
   The <code>Name</code> value should be a unique name so it is obvious
-  in the list of devices.
+  in the list of devices (so change it).
 </p>
 <p>
   The <code>Extenders</code>
@@ -40,17 +43,27 @@ menu_title: Working With Extenders
 <p>
   When an <code>Extenders</code> value of greater than 0 is used, extra midi
   ports will appear for the extenders to be connected to. The MIDI ports
-  for the controllers will be named <code>mackie control #1</code>,
-  <code>mackie control #2</code> and up. The numbers will go from left to
-  right. That is, from lowest number channel to highest.
+  for the controllers will be named <code>mackie control in/out</code> for
+  the master, <code>mackie control in/out ext #*</code> where * is the
+  position of the extender from left to right. So for a master in the middle
+  with an extender on either side, the ports from left to right will be
+  mackie control in/out ext #1, mackie control in/out and mackie control in/out ext #3.
 </p>
 <p>
-  The <code>MasterPosition</code> value is the port number the master unit
-  (with the master fader) is connected to. So if there are three surfaces,
-  <code>&lt;MasterPosition value="1"/&gt;</code> will expect the master on
-  the left, <code>&lt;MasterPosition value="2"/&gt;</code> would be master
-  in the middle and <code>&lt;MasterPosition value="3"/&gt;</code> would be
-  master on the right. So the position matches the port name.
+  If using the MCP GUI to connect surfaces the top surface is the leftmost
+  and the bottom is the rightmost. The GUI shows explicitly the position
+  of the main or master surface within the group of surfaces.
+</p>
+<p><img alt="the Mackie Control Device Dialog"
+     src="/images/mcp-extender-position.png"></p>
+<p>
+  The <code>MasterPosition</code> value is the position the master unit
+  (with the master fader) is located at within the group of surfaces.
+  The surfaces are numbered from 1 at the left side and up. So if there
+  are three surfaces, <code>&lt;MasterPosition value="1"/&gt;</code> will
+  expect the master on the left, <code>&lt;MasterPosition value="2"/&gt;</code>
+  would be master in the middle and <code>&lt;MasterPosition value="3"/&gt;</code>
+  would be master on the right.
 </p>
 <p class="note">
   The default value of <code>&lt;MasterPosition value="0"/&gt;</code> has
@@ -58,6 +71,6 @@ menu_title: Working With Extenders
 </p>
 <p>
   If the <code>MasterPosition</code> value does not properly match the
-  physcal position and MIDI port, the master fader and global controls will
+  physical position and MIDI port, the master fader and global controls will
   not work. The master unit will act like an extender.
 </p>