Shamusworld >> Repos - ardour-manual/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 represtent 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       - AudioBusses.
  36         </li>
  37         <li>
  38                 8       - MidiBusses.
  39         </li>
  40         <li>
  41                 16      - VCAs.
  42         </li>
  43         <li>
  44                 2048    - Master.
  45         </li>
  46         <li>
  47                 4096    - Monitor.
  48         </li>
  49         <li>
  50                 16384   - Selected.
  51         </li>
  52         <li>
  53                 32768   - Hidden.
  54         </li>
  55   </ul>
  56 <p>
  57   Some handy numbers to use might be: 15 (all tracks and busses), 31
  58   (add VCAs to that). Master or Monitor strips are generally not useful
  59   on a surface that has dedicated controls for these strips as there are
  60   /master* and /monitor* commands already. However, on a surface with
  61   just a bank of fader strips, adding master or monitor would allow
  62   access to them within the banks. Selected would be useful for working
  63   on a group or a set of user selected strips. Hidden shows strips the
  64   GUI has hidden.
  65 </p>
  66
  67 <h3>feedback</h3>
  68 <p>Feedback is an integer made up of bits. The easy way to
  69   deal with this is to think of feedback items being worth a number and
  70   then adding all those numbers together for a value to send.
  71 </p>
  72   <ul>
  73         <li>
  74                 1 - Button status for strips.
  75         </li>
  76         <li>
  77                 2 - Variable control values for strips.
  78         </li>
  79         <li>
  80                 4 - Send SSID as path extension.
  81         </li>
  82         <li>
  83                 8 - heartbeat to surface.
  84         </li>
  85         <li>
  86                 16 - Enable master section feedback.
  87         </li>
  88         <li>
  89                 32 - Send Bar and Beat.
  90         </li>
  91         <li>
  92                 64 - Send timecode.
  93         </li>
  94         <li>
  95                 128 - Send meter as dB (-193 to +6) or 1024 depending on gainmode
  96         </li>
  97         <li>
  98                 256 - Send meter a 16 bit value where each bit is a level
  99                 and all bits of lower level are on. For use in a LED strip. This
 100                 will not work if the above option is turned on.
 101         </li>
 102         <li>
 103                 512 - Send signal present, true if level is higher than -20dB
 104         </li>
 105   </ul>
 106 <p>
 107   So using a value of 19 would turn on feedback for strip and master
 108   controls, but leave meters, timecode and bar/beat feedback off.
 109 </p>