]> Shamusworld >> Repos - ardour-manual/blobdiff - include/osc58-feedback-and-strip-types-values.html
OSC: new for 6.0
[ardour-manual] / include / osc58-feedback-and-strip-types-values.html
index f64ad7f3acbd9945074e7993529d2c74f89a5f2e..8785ae89230c67718d2416ffc50a7ffbd0713d39 100644 (file)
@@ -68,6 +68,7 @@
        or the control should only affect the strip the control is applied to.
        The <code>/use_group f state</code> command can be used to temporarily
        change this on the fly.
+</p>
 <p>
   Some handy numbers to use might be: 15 (all tracks and busses -
   1 + 2 + 4 + 8), 31
   surface with just a bank of fader strips, adding master or monitor
   would allow access to them within the banks. Selected would be useful
   for working on a group or a set of user selected strips. Hidden shows
-  strips the GUI has hidden.
+  strips the GUI has hidden. As such, a control surface will likely have
+  a number of buttons with different strip_types for convenience.
+  <ul>
+         <li>
+               Mixer - All strip types <kbd class="osc">/set_surface/strip_types 159</kbd>
+         </li>
+         <li>
+               Audio Tracks - Just Audio tracks that can record <kbd class="osc">/set_surface/strip_types 1</kbd>
+         </li>
+         <li>
+               MIDI Tracks - Tracks with at least 1 MIDI input that can record
+               <kbd class="osc">/set_surface/strip_types 2</kbd>
+         </li>
+         <li>
+               Busses - A mix of all busses, possibly including VCAs
+               <kbd class="osc">/set_surface/strip_types 156</kbd>
+         </li>
+         <li>
+               Selected - All strips that are currently selected
+               <kbd class="osc">/set_surface/strip_types 256</kbd>
+         </li>
+         <li>
+               Hidden - All hidden strips <kbd class="osc">/set_surface/strip_types 512</kbd>
+         </li>
+         <li>
+               Custom - see <a href="@@osc58-custom-strips">
+               Making a user selected strip list.</a>
+               <kbd class="osc">/strip/custom/mode 1</kbd>
+         </li>
+  
+  </ul>
 </p>
-<p class-"note">
+<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 busses that can be used a number of ways. From analog days,
   performer would be able to mix their own monitor. The user is free
   to enable both busses and auxes if they would prefer.
 </p>
-
+<h3 id="hidden">Using hidden strips</h3>
+<p>
+       Ardour allows any of it's strips to be hidden so that they do not show
+       up on the GUI mixer or editor. OSC follows the GUI by default and will
+       not show hidden strips. As of Ardour 6.0 the OSC commands include
+       <kbd class="osc">/select/hide <em>y/n</em></kbd> for the selected
+       strip and <kbd class="osc">/strip/hide <em>ssid</em> <em>y/n</em></kbd>
+       for any strip. This allows the control surface to hide or unhide a strip.
+       What may not be obvious is that hiding a strip makes it disappear and
+       become unselected. So if a selected strip is hidden, it is no longer
+       selected and the select channel will show the default select strip
+       (Master). In order to show a hidden strip, the hidden strips need to
+       be shown first using the <kbd class="osc">/set_surface/strip_types 512</kbd>
+       command to show only hidden strips. Then use the
+       <kbd class="osc">/strip/hide <em>SSID</em> 0</kbd> or
+       <kbd class="osc">/select/hide 0</kbd>
+       to show that strip. Of course, because only hidden strips are showing,
+       the strip you have set to no long hide will seem to vanish. A
+       <kbd class="osc">/set_surface/strip_types 159</kbd> will then show
+       the default strip types or replace the 159 with the desired strip_types.
+</p>
+<p class="note">
+       When hiding more than one strip in a row, check the strip name before
+       hiding as the strips will move as each strip is hidden just as it does
+       with the GUI mixer. So to hide strips 5, 6 and 7, the hide button
+       for <code>ssid</code> 5 is pressed 3 times. A more intuitive method
+       would be to hide strips from right to left (7, 6 and 5) which will
+       work as expected.
+<p>
+       In short, shown strips can only be hidden when they are viewable and
+       hidden strip can only shown (or un-hid) when strip_types include hidden
+       strips.
+</p>
 <h2 id="feedback">feedback</h2>
 <p>Feedback is an integer made up of bits. The easy way to
   deal with this is to think of feedback items being worth a number and