Shamusworld >> Repos - ardour-manual/blob - include/osc58-personal-monitoring-control.html

   1
   2 <p>
   3         Personal monitoring can allow a performer with a smart phone to set
   4         their personal monitor mix for a floor wedge or in-ear monitoring.
   5         In Ardour 5.6 OSC commands to allow this were added.
   6 </p>
   7 <h3>Setup</h3>
   8 <p>
   9         Some setup needs to be done in the GUI mixer window before this can
  10         work.
  11 </p>
  12         <ul>
  13                 <li>
  14                         Create a bus for each performer who will have personal
  15                         monitoring. A good practice is to name the bus with the
  16                         performers name.
  17                 </li>
  18                 <li>
  19                         Connect the output of that bus to one of the audio
  20                         interface's playback ports that is not otherwise used. OSC
  21                         will now include this bus in it's list of aux busses as it
  22                         no longer has it's output connected to the Master bus.
  23                 </li>
  24                 <li>
  25                         Add an aux send to each channel the performer needs to hear
  26                         in their personal mix. Many performers only need three or
  27                         four sources to be mixed. If the performer needs to hear a
  28                         a set of inputs that are combined into a bus, adding the
  29                         aux send to that bus may make more sense than adding ten
  30                         drum channels for example.
  31                 </li>
  32                 <li>
  33                         If the performer wishes to hear effects in their monitor,
  34                         an extra send from the send bus, placing the performers aux
  35                         send after the effect or a plugin can be added in line in
  36                         the aux bus itself.
  37                 </li>
  38         </ul>
  39 <p>
  40         This gives stage or studio monitoring for the performer.
  41 </p>
  42
  43 <h3>The OSC commands and feedback for personal monitoring</h3>
  44 <p>
  45         All of the personal monitoring commands and feedback start with a
  46         <em>/cue</em>. It is expected that a surface used as a personal
  47         monitor control will use only <em>/cue</em> commands.
  48 </p>
  49 <p>
  50         Most phone OSC applets (TouchOSC, Control) require manual port to be set.
  51         There are certainly more controls than needed. Using send enables for
  52         example, may lead to wasted time discovering why a send has no sound.
  53         A good easy to use controler that fits on most phones while still
  54         being controllable even with big fingers might look like:
  55 </p>
  56 <img alt="TouchOSC Screenshot"
  57      src="/images/osc-cue-screen">
  58 <p class="note">
  59         The send controls and feedback all have the send id (1 to n) in line
  60         as part of the OSC path. So the path for the second send would be
  61         <em>/cue/send/fader/2</em> to set the level. It is considered that
  62         most surfaces used for this will only be able to handle one parameter.
  63 </p>
  64 <h4>Commands</h4>
  65 <table class="dl">
  66   <tr><th><kbd class="osc">/cue/connect</kbd></th>
  67   <td>Returns a list of aux busses and connects to the first.</td></tr>
  68   <tr><th><kbd class="osc">/cue/aux <em>aux-number</em></kbd></th>
  69   <td>where <em>aux-number</em> is an integer or float which is the aux bus
  70   number this surface will use.</td></tr>
  71   <tr><th><kbd class="osc">/cue/next_aux</kbd></th>
  72   <td>Sets the the aux bus to one bus higher.</td></tr>
  73   <tr><th><kbd class="osc">/cue/previous_aux</kbd></th>
  74   <td>Sets the aux to one bus lower. This can also be used as a "connect"
  75   button to save space in a phone layout.</td></tr>
  76   <tr><th><kbd class="osc">/cue/fader <em>position</em></kbd></th>
  77   <td>where <em>position</em> is a float for the position of the fader
  78   between 0.0 and 1.0.</td></tr>
  79   <tr><th><kbd class="osc">/cue/mute <em>state</em></kbd></th>
  80   <td>where <em>state</em> is a float of 0.0 for mute off and 1.0 for the Aux bus mute on.</td></tr>
  81   <tr><th><kbd class="osc">/cue/send/fader/<em>id</em> <em>position</em></kbd></th>
  82   <td>where <em>position</em> is a float for the position of the fader
  83   between 0.0 and 1.0.</td></tr>
  84   <tr><th><kbd class="osc">/cue/send/enable/<em>id</em> <em>state</em></kbd></th>
  85   <td>where <em>state</em> is a float of 0.0 for disable and 1.0 for enable.</td></tr>
  86 </table>
  87 <h4>Feedback</h4>
  88 <table class="dl">
  89   <tr><th><kbd class="osc">/cue/name <em>name</em></kbd></th>
  90   <td>where <em>name</em> is a string that is the name of the currently
  91   selected aux bus.</td></tr>
  92   <tr><th><kbd class="osc">/cue/name/<em>id</em> <em>name</em></kbd></th>
  93   <td>where <em>name</em> is a string that is the name of the aux bus
  94   that <em>id</em> belongs to.</td></tr>
  95   <tr><th><kbd class="osc">/cue/fader <em>position</em></kbd></th>
  96   <td>where <em>position</em> is a float from 0.0 to 1.0 that shows the
  97   fader position for the selected aux bus.</td></tr>
  98   <tr><th><kbd class="osc">/cue/mute <em>state</em></kbd></th>
  99   <td>where <em>state</em> is a float of 0.0 or 1.0 that shows the state
 100   of the mute for the selected aux bus.</td></tr>
 101   <tr><th><kbd class="osc">/cue/signal <em>activity</em></kbd></th>
 102   <td>where <em>activity</em> is a float of 0.0 or 1.0 that shows audio
 103   activity for the selected aux bus.</td></tr>
 104   <tr><th><kbd class="osc">/cue/send/name/<em>id</em> <em>name</em></kbd></th>
 105   <td>where <em>name</em> is a string that is the name of the channel
 106   that send <em>id</em> belongs to.</td></tr>
 107   <tr><th><kbd class="osc">/cue/send/fader/<em>id</em> <em>position</em></kbd></th>
 108   <td>where <em>position</em> is a float from 0.0 to 1.0 that is the position
 109   for the fader for the send that <em>id</em> belongs to.</td></tr>
 110   <tr><th><kbd class="osc">/cue/send/enable/<em>id</em> <em>state</em></kbd></th>
 111   <td>where <em>state</em> is a float of 0.0 or 1.0 that is the state
 112   of the enable for the send that <em>id</em> belongs to.</td></tr>
 113 </table>
 114 <p>
 115         While a fader is being adjusted, the corresponding <em>/*/name</em>
 116         text will give the level in db.
 117 </p>
 118