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 40505768e9763ba15ef474579ec46bbe0a5aab38..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
@@ -77,7 +102,7 @@ title: Calculating Feedback and Strip-types Values
                2 - Variable control values for strips.
        </li>
        <li>
-               4 - Send meter values (not coded yet).
+               4 - Send SSID as path extension.
        </li>
        <li>
                8 - heartbeat to surface.
@@ -86,13 +111,30 @@ title: Calculating Feedback and Strip-types Values
                16 - Enable master section feedback.
        </li>
        <li>
-               32 - Send Bar and Beat (not coded yet).
+               32 - Send Bar and Beat.
        </li>
        <li>
-               64 - Send timecode (not coded yet).
+               64 - Send timecode.
        </li>
        <li>
-               128 - Send SSID as path extension.
+               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
+               and all bits of lower level are on. For use in a LED strip. This
+               will not work if the above option is turned on.
+       </li>
+       <li>
+               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>