OSC: Updates for Ardour 5.5

[ardour-manual] / _manual / 22_using-control-surfaces / 01_controlling-ardour-with-osc / 03_calculating-feedback-and-strip-types-values.html

diff --git a/_manual/22_using-control-surfaces/01_controlling-ardour-with-osc/03_calculating-feedback-and-strip-types-values.html b/_manual/22_using-control-surfaces/01_controlling-ardour-with-osc/03_calculating-feedback-and-strip-types-values.html
index bf153ce032d7c71ac99828bcfb8b614217c0a114..6e8340c1f4e269ee9c097c9c77b8a61970b1bc63 100644 (file)
--- a/_manual/22_using-control-surfaces/01_controlling-ardour-with-osc/03_calculating-feedback-and-strip-types-values.html
+++ b/_manual/22_using-control-surfaces/01_controlling-ardour-with-osc/03_calculating-feedback-and-strip-types-values.html
@@ -11,7 +11,7 @@ title: Calculating Feedback and Strip-types Values
 </p>
 <p>Both ,<em>feedback</em> and <em>strip-types</em> use bitsets to keep
   track what they are doing. Any number in a computer is made out of
-  bits that are on or off, but we represtent them as normal base 10
+  bits that are on or off, but we represent them as normal base 10
   numbers. Any one bit turned on will add a unique value to the
   number as a whole. So for each kind of feedback or strip type
   to be used, that number should be added to the total.</p>
@@ -32,29 +32,39 @@ title: Calculating Feedback and Strip-types Values
                2       - MidiTracks.
        </li>
        <li>
-               4       - AudioBusses.
+               4       - AudioBuses.
        </li>
        <li>
-               8       - MidiBusses.
+               8       - MidiBuses.
        </li>
        <li>
                16      - VCAs.
        </li>
        <li>
-               2048    - Master.
+               32      - Master.
        </li>
        <li>
-               4096    - Monitor.
+               64      - Monitor.
        </li>
        <li>
-               16384   - Selected.
+               128     - Audio Aux.
        </li>
        <li>
-               32768   - Hidden.
+               256     - Selected.
+       </li>
+       <li>
+               512     - Hidden.
        </li>
   </ul>
+<p class="note">
+  Selected and Hidden bits are normally not needed as Ardour defaults to
+  showing Selected strips and not showing Hidden strips. The purpose of
+  these two flags is to allow showing only Selected strips or only
+  Hidden strips. Using Hidden with other flags will allow Hidden strips
+  to show inline with other strips.
+</p>
 <p>
-  Some handy numbers to use might be: 15 (all tracks and busses), 31 
+  Some handy numbers to use might be: 15 (all tracks and buses), 31
   (add VCAs to that). Master or Monitor strips are generally not useful
   on a surface that has dedicated controls for these strips as there are
   /master* and /monitor* commands already. However, on a surface with
@@ -63,6 +73,21 @@ title: Calculating Feedback and Strip-types Values
   on a group or a set of user selected strips. Hidden shows strips the
   GUI has hidden.
 </p>
+<p class-"note">
+  Audio Aux? say what? I am sure most people will have noticed that they
+  can find no <em>Aux</em> strips in the Ardour mixer. There are none.
+  There are buses that can be used a number of ways. From analog days,
+  in OSC a bus is something that gets used as a sub mix before ending up
+  going to Master. An auxiliary bus is used like a separate mixer and
+  it's output goes outside the program or computer to be used as:
+  a monitor mix, a back up recording, or what have you. In OSC where
+  controller strips may be limited, it may be useful not to use up a
+  strip for an aux that is not really a part of the mix. It is also
+  useful to get a list of only aux buses if the control surface is a
+  phone used to provide talent monitor mix control on stage. Each
+  performer would be able to mix their own monitor. The user is free
+  to enable both buses and auxes if they would prefer.
+</p>
 
 <h3>feedback</h3> 
 <p>Feedback is an integer made up of bits. The easy way to
@@ -92,7 +117,7 @@ title: Calculating Feedback and Strip-types Values
                64 - Send timecode.
        </li>
        <li>
-               128 - Send meter as dB (-193 to +6) or 1024 depending on gainmode
+               128 - Send meter as dB (-193 to +6) or 0 to 1 depending on gainmode
        </li>
        <li>
                256 - Send meter a 16 bit value where each bit is a level
@@ -100,7 +125,16 @@ title: Calculating Feedback and Strip-types Values
                will not work if the above option is turned on.
        </li>
        <li>
-               512 - Send signal present, true if level is higher than -20dB
+               512 - Send signal present, true if level is higher than -40dB
+       </li>
+       <li>
+               1024 - Send position in samples
+       </li>
+       <li>
+               2048 - Send position in time, hours, minutes, seconds and milliseconds
+       </li>
+       <li>
+               8192 - Turn on extra select channel feedback beyond what a /strip supports
        </li>
   </ul>
 <p>