Shamusworld >> Repos - ardour-manual-diverged/blob - _manual/22_using-control-surfaces/01_controlling-ardour-with-osc/03_calculating-feedback-and-strip-types-values.html

   1 ---
   2 layout: default
   3 title: Calculating Feedback and Strip-types Values
   4 ---
   5
   6 <p><em>/set_surface</em> has two values the user needs to calculate before
   7   use. In general these will not be calculated at run time, but
   8   beforehand. There may be more than one button with different values
   9   to turn various kinds of feedback on or off or to determine which
  10   kinds of strips are currently viewed/controlled.
  11 </p>
  12 <p>Both ,<em>feedback</em> and <em>strip-types</em> use bitsets to keep
  13   track what they are doing. Any number in a computer is made out of
  14   bits that are on or off, but we represent them as normal base 10
  15   numbers. Any one bit turned on will add a unique value to the
  16   number as a whole. So for each kind of feedback or strip type
  17   to be used, that number should be added to the total.</p>
  18 <h3>strip_types</h3>
  19 <p>
  20   strip_types is an integer made up of bits. The easy way to
  21   deal with this is to think of strip_types items being worth a number and
  22   then adding all those numbers together for a value to send.
  23   Strip Types will determine What kind of strips will be included in
  24   bank. This would include: Audio, MIDI, busses, VCAs, Master, Monitor
  25   and hidden or selected strips.
  26 </p>
  27   <ul>
  28         <li>
  29                 1       - AudioTracks.
  30         </li>
  31         <li>
  32                 2       - MidiTracks.
  33         </li>
  34         <li>
  35                 4       - AudioBuses.
  36         </li>
  37         <li>
  38                 8       - MidiBuses.
  39         </li>
  40         <li>
  41                 16      - VCAs.
  42         </li>
  43         <li>
  44                 32      - Master.
  45         </li>
  46         <li>
  47                 64      - Monitor.
  48         </li>
  49         <li>
  50                 256     - Selected.
  51         </li>
  52         <li>
  53                 512     - Hidden.
  54         </li>
  55   </ul>
  56 <p class="note">
  57   Selected and Hidden bits are normally not needed as Ardour defaults to
  58   showing Selected strips and not showing Hidden strips. The purpose of
  59   these two flags is to allow showing only Selected strips or only
  60   Hidden strips. Using Hidden with other flags will allow Hidden strips
  61   to show inline with other strips.
  62 </p>
  63 <p>
  64   Some handy numbers to use might be: 15 (all tracks and buses), 31
  65   (add VCAs to that). Master or Monitor strips are generally not useful
  66   on a surface that has dedicated controls for these strips as there are
  67   /master* and /monitor* commands already. However, on a surface with
  68   just a bank of fader strips, adding master or monitor would allow
  69   access to them within the banks. Selected would be useful for working
  70   on a group or a set of user selected strips. Hidden shows strips the
  71   GUI has hidden.
  72 </p>
  73
  74 <h3>feedback</h3>
  75 <p>Feedback is an integer made up of bits. The easy way to
  76   deal with this is to think of feedback items being worth a number and
  77   then adding all those numbers together for a value to send.
  78 </p>
  79   <ul>
  80         <li>
  81                 1 - Button status for strips.
  82         </li>
  83         <li>
  84                 2 - Variable control values for strips.
  85         </li>
  86         <li>
  87                 4 - Send SSID as path extension.
  88         </li>
  89         <li>
  90                 8 - heartbeat to surface.
  91         </li>
  92         <li>
  93                 16 - Enable master section feedback.
  94         </li>
  95         <li>
  96                 32 - Send Bar and Beat.
  97         </li>
  98         <li>
  99                 64 - Send timecode.
 100         </li>
 101         <li>
 102                 128 - Send meter as dB (-193 to +6) or 1024 depending on gainmode
 103         </li>
 104         <li>
 105                 256 - Send meter a 16 bit value where each bit is a level
 106                 and all bits of lower level are on. For use in a LED strip. This
 107                 will not work if the above option is turned on.
 108         </li>
 109         <li>
 110                 512 - Send signal present, true if level is higher than -40dB
 111         </li>
 112         <li>
 113                 1024 - Send position in samples
 114         </li>
 115         <li>
 116                 2048 - Send position in time, hours, minutes, seconds and milliseconds
 117         </li>
 118   </ul>
 119 <p>
 120   So using a value of 19 would turn on feedback for strip and master
 121   controls, but leave meters, timecode and bar/beat feedback off.
 122 </p>