Shamusworld >> Repos - ardour-manual/blob - include/osc58-feedback-and-strip-types-values.html

   1
   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.
   7 </p>
   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>
  14 <h2>strip_types</h2>
  15 <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.
  22 </p>
  23   <ul>
  24         <li>
  25                 1: AudioTracks.
  26         </li>
  27         <li>
  28                 2: MidiTracks.
  29         </li>
  30         <li>
  31                 4: AudioBusses.
  32         </li>
  33         <li>
  34                 8: MidiBusses.
  35         </li>
  36         <li>
  37                 16: VCAs.
  38         </li>
  39         <li>
  40                 32: Master.
  41         </li>
  42         <li>
  43                 64: Monitor.
  44         </li>
  45         <li>
  46                 128: Audio Aux.
  47         </li>
  48         <li>
  49                 256: Selected.
  50         </li>
  51         <li>
  52                 512: Hidden.
  53         </li>
  54         <li>
  55                 1024: Use Group.
  56         </li>
  57   </ul>
  58 <p class="note">
  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.
  64 </p>
  65 <h3 id="use-group">Use Group</h3>
  66 <p class="note">
  67         Use Group on will tell ardour that any control on a strip that is part
  68         of a group will affect all strips within that group. Default is off
  69         or the control should only affect the strip the control is applied to.
  70         The <code>/use_group f state</code> command can be used to temporarily
  71         change this on the fly.
  72 <p>
  73   Some handy numbers to use might be: 15 (all tracks and busses), 31
  74   (add VCAs to that). Master or Monitor strips are generally not useful
  75   on a surface that has dedicated controls for these strips as there are
  76   /master* and /monitor* commands already. However, on a surface with
  77   just a bank of fader strips, adding master or monitor would allow
  78   access to them within the banks. Selected would be useful for working
  79   on a group or a set of user selected strips. Hidden shows strips the
  80   GUI has hidden.
  81 </p>
  82 <p class-"note">
  83   Audio Aux? say what? I am sure most people will have noticed that they
  84   can find no <em>Aux</em> strips in the Ardour mixer. There are none.
  85   There are busses that can be used a number of ways. From analog days,
  86   in OSC, a bus is something that gets used as a sub mix before ending up
  87   going to Master. An auxiliary bus is used like a separate mixer and
  88   it's output goes outside the program or computer to be used as:
  89   a monitor mix, a back up recording, or what have you. In OSC where
  90   controller strips may be limited, it may be useful not to use up a
  91   strip for an aux that is not really a part of the mix. It is also
  92   useful to get a list of only aux busses if the control surface is a
  93   phone used to provide talent monitor mix control on stage. Each
  94   performer would be able to mix their own monitor. The user is free
  95   to enable both busses and auxes if they would prefer.
  96 </p>
  97
  98 <h2>feedback</h2>
  99 <p>Feedback is an integer made up of bits. The easy way to
 100   deal with this is to think of feedback items being worth a number and
 101   then adding all those numbers together for a value to send.
 102 </p>
 103   <ul>
 104         <li>
 105                 1: Button status for strips.
 106         </li>
 107         <li>
 108                 2: Variable control values for strips.
 109         </li>
 110         <li>
 111                 4: Send SSID as path extension.
 112         </li>
 113         <li>
 114                 8: heartbeat to surface.
 115         </li>
 116         <li>
 117                 16: Enable master section feedback.
 118         </li>
 119         <li>
 120                 32: Send Bar and Beat.
 121         </li>
 122         <li>
 123                 64: Send timecode.
 124         </li>
 125         <li>
 126                 128: Send meter as dB (-193 to +6) or 0 to 1 depending on gainmode
 127         </li>
 128         <li>
 129                 256: Send meter a 16 bit value where each bit is a level
 130                 and all bits of lower level are on. For use in a LED strip. This
 131                 will not work if the above option is turned on.
 132         </li>
 133         <li>
 134                 512: Send signal present, true if level is higher than -40dB
 135         </li>
 136         <li>
 137                 1024: Send position in samples
 138         </li>
 139         <li>
 140                 2048: Send position in time, hours, minutes, seconds and milliseconds
 141         </li>
 142         <li>
 143                 8192: Turn on select channel feedback
 144         </li>
 145         <li>
 146                 16384: Use OSC 1.0 /reply instead of #reply
 147         </li>
 148   </ul>
 149 <p>
 150   So using a value of 19 would turn on feedback for strip and master
 151   controls, but leave meters, timecode and bar/beat feedback off.
 152 </p>
 153