2 <p><em>/set_surface</em> has two values the user needs to calculate before
3 use. In general these will not be calculated at run time, but
4 beforehand. There may be more than one button with different values
5 to turn various kinds of feedback on or off or to determine which
6 kinds of strips are currently viewed/controlled.
8 <p>Both <em>feedback</em> and <em>strip-types</em> use bitsets to keep
9 track what they are doing. Any number in a computer is made out of
10 bits that are on or off, but we represent them as normal base 10
11 numbers. Any one bit turned on will add a unique value to the
12 number as a whole. So for each kind of feedback or strip type
13 to be used, that number should be added to the total.</p>
16 strip_types is an integer made up of bits. The easy way to
17 deal with this is to think of strip_types items being worth a number and
18 then adding all those numbers together for a value to send.
19 Strip Types will determine What kind of strips will be included in
20 bank. This would include: Audio, MIDI, busses, VCAs, Master, Monitor
21 and hidden or selected strips.
59 Selected and Hidden bits are normally not needed as Ardour defaults to
60 showing Selected strips and not showing Hidden strips. The purpose of
61 these two flags is to allow showing only Selected strips or only
62 Hidden strips. Using Hidden with other flags will allow Hidden strips
63 to show inline with other strips.
65 <p class="note" id="use-group">
66 Use Group on will tell ardour that any control on a strip that is part
67 of a group will affect all strips within that group. Default is off
68 or the control should only affect the strip the control is applied to.
69 The <code>/use_group f state</code> command can be used to temporarily
70 change this on the fly.
73 Some handy numbers to use might be: 15 (all tracks and busses -
75 (add VCAs to that - 15 + 16). Master or Monitor strips are generally
76 not useful on a surface that has dedicated controls for these strips
77 as there are /master* and /monitor* commands already. However, on a
78 surface with just a bank of fader strips, adding master or monitor
79 would allow access to them within the banks. Selected would be useful
80 for working on a group or a set of user selected strips. Hidden shows
81 strips the GUI has hidden. As such, a control surface will likely have
82 a number of buttons with different strip_types for convenience.
85 Mixer - All strip types <kbd class="osc">/set_surface/strip_types 159</kbd>
88 Audio Tracks - Just Audio tracks that can record <kbd class="osc">/set_surface/strip_types 1</kbd>
91 MIDI Tracks - Tracks with at least 1 MIDI input that can record
92 <kbd class="osc">/set_surface/strip_types 2</kbd>
95 Busses - A mix of all busses, possibly including VCAs
96 <kbd class="osc">/set_surface/strip_types 156</kbd>
99 Selected - All strips that are currently selected
100 <kbd class="osc">/set_surface/strip_types 256</kbd>
103 Hidden - All hidden strips <kbd class="osc">/set_surface/strip_types 512</kbd>
106 Custom - see <a href="@@osc58-custom-strips">
107 Making a user selected strip list.</a>
108 <kbd class="osc">/strip/custom/mode 1</kbd>
113 <h3 id="hidden">Using hidden strips</h3>
115 Ardour allows any of it's strips to be hidden so that they do not show
116 up on the GUI mixer or editor. OSC follows the GUI by default and will
117 not show hidden strips. As of Ardour 6.0 the OSC commands include
118 <kbd class="osc">/select/hide <em>y/n</em></kbd> for the selected
119 strip and <kbd class="osc">/strip/hide <em>ssid</em> <em>y/n</em></kbd>
120 for any strip. This allows the control surface to hide or unhide a strip.
121 What may not be obvious is that hiding a strip makes it disappear and
122 become unselected. So if a selected strip is hidden, it is no longer
123 selected and the select channel will show the default select strip
124 (Master). In order to show a hidden strip, the hidden strips need to
125 be shown first using the <kbd class="osc">/set_surface/strip_types 512</kbd>
126 command to show only hidden strips. Then use the
127 <kbd class="osc">/strip/hide <em>SSID</em> 0</kbd> or
128 <kbd class="osc">/select/hide 0</kbd>
129 to show that strip. Of course, because only hidden strips are showing,
130 the strip you have set to no long hide will seem to vanish. A
131 <kbd class="osc">/set_surface/strip_types 159</kbd> will then show
132 the default strip types or replace the 159 with the desired strip_types.
135 When hiding more than one strip in a row, check the strip name before
136 hiding as the strips will move as each strip is hidden just as it does
137 with the GUI mixer. So to hide strips 5, 6 and 7, the hide button
138 for <code>ssid</code> 5 is pressed 3 times. A more intuitive method
139 would be to hide strips from right to left (7, 6 and 5) which will
142 In short, shown strips can only be hidden when they are viewable and
143 hidden strip can only shown (or un-hid) when strip_types include hidden
146 <h2 id="feedback">feedback</h2>
147 <p>Feedback is an integer made up of bits. The easy way to
148 deal with this is to think of feedback items being worth a number and
149 then adding all those numbers together for a value to send.
153 1: Button status for strips.
156 2: Variable control values for strips.
159 4: Send SSID as path extension.
162 8: heartbeat to surface.
165 16: Enable master section feedback.
168 32: Send Bar and Beat.
174 128: Send meter as dB (-193 to +6) or 0 to 1 depending on gainmode
177 256: Send meter a 16 bit value where each bit is a level
178 and all bits of lower level are on. For use in a LED strip. This
179 will not work if the above option is turned on.
182 512: Send signal present, true if level is higher than -40dB
185 1024: Send position in samples
188 2048: Send position in time, hours, minutes, seconds and milliseconds
191 8192: Turn on select channel feedback
194 16384: Use OSC 1.0 /reply instead of #reply
198 So using a value of 19 (1 + 2 + 16) would turn on feedback for strip
199 and master controls, but leave meters, timecode and bar/beat feedback off.