3 title: OSC: Personal Monitoring Control
7 Personal monitoring can allow a performer with a smart phone to set
8 their personal monitor mix for a floor wedge or inear monitoring.
9 In Ardour 5.6 OSC commands to allow this were added.
13 Some setup needs to be done in the GUI mixer window before this can
18 Create a bus for each performer who will have personal
19 monitoring. A good practice is to name the bus with the
23 Connect the output of that bus to one of the audio
24 interface's playback ports that is not otherwise used. OSC
25 will now include this bus in it's list of aux buses as it
26 no longer has it's output connected to the Master bus.
29 Add an aux send to each channel the performer needs to hear
30 in their personal mix. Many performers only need three or
31 four sources to be mixed. If the performer needs to hear a
32 a set of inputs that are combined into a bus, adding the
33 aux send to that bus may make more sense than adding ten
34 drum channels for example.
37 If the performer wishes to hear effects in their monitor,
38 an extra send from the send bus, placing the performers aux
39 send after the effect or a plugin can be added in line in
44 This gives stage or studio monitoring for the performer.
47 <h3>The OSC commands and feedback for personal monitoring</h3>
49 All of the personal monitoring commands and feedback start with a
50 <em>/cue</em>. It is expected that a surface used as a personal
51 monitor control will use only <em>/cue</em> commands.
54 The send controls and feedback all have the send id (1 to n) in line
55 as part of the OSC path. So the path for the second send would be
56 <em>/cue/send/fader/2</em> to set the level. It is considered that
57 most surfaces used for this will only be able to handle one parameter.
61 <dt><kbd class="osc">/cue/connect</kbd></dt>
62 <dd>Returns a list of aux buses.</dd>
63 <dt><kbd class="osc">/cue/aux <em>aux-number</em></kbd></dt>
64 <dd>where <em>aux-number</em> is an integer which is the aux bus
65 number this surface will use.</dd>
66 <dt><kbd class="osc">/cue/next_aux</kbd></dt>
67 <dd>Sets the the aux bus to one bus higher.</dd>
68 <dt><kbd class="osc">/cue/previous_aux</kbd></dt>
69 <dd>Sets the aux to one bus lower.</dd>
70 <dt><kbd class="osc">/cue/connect</kbd></dt>
71 <dd>Returns a list of aux buses.</dd>
72 <dt><kbd class="osc">/cue/fader <em>position</em></kbd></dt>
73 <dd>where <em>position</em> is a float for the position of the fader
74 between 0.0 and 1.0.</dd>
75 <dt><kbd class="osc">/cue/mute <em>state</em></kbd></dt>
76 <dd>where <em>state</em> is a float of 0.0 for mute off and 1.0 for mute on.</dd>
77 <dt><kbd class="osc">/cue/send/fader/<em>id</em> <em>position</em></kbd></dt>
78 <dd>where <em>position</em> is a float for the position of the fader
79 between 0.0 and 1.0.</dd>
80 <dt><kbd class="osc">/cue/send/enable/<em>id</em> <em>state</em></kbd></dt>
81 <dd>where <em>state</em> is a float of 0.0 for disable and 1.0 for enable.</dd>
85 <dt><kbd class="osc">/cue/name <em>name</em></kbd></dt>
86 <dd>where <em>name</em> is a string that is the name of the currently
87 selected aux bus.</dd>
88 <dt><kbd class="osc">/cue/name/<em>id</em> <em>name</em></kbd></dt>
89 <dd>where <em>name</em> is a string that is the name of the aux bus
90 that <em>id</em> belongs to.</dd>
91 <dt><kbd class="osc">/cue/fader <em>position</em></kbd></dt>
92 <dd>where <em>position</em> is a float from 0.0 to 1.0 that shows the
93 fader position for the selected aux bus.</dd>
94 <dt><kbd class="osc">/cue/mute <em>state</em></kbd></dt>
95 <dd>where <em>state</em> is a float of 0.0 or 1.0 that shows the state
96 of the mute for the selected aux bus.</dd>
97 <dt><kbd class="osc">/cue/signal <em>activity</em></kbd></dt>
98 <dd>where <em>activity</em> is a float of 0.0 or 1.0 that shows audio
99 activity for the selected aux bus.</dd>
100 <dt><kbd class="osc">/cue/send/name/<em>id</em> <em>name</em></kbd></dt>
101 <dd>where <em>name</em> is a string that is the name of the channel
102 that send <em>id</em> belongs to.</dd>
103 <dt><kbd class="osc">/cue/send/fader/<em>id</em> <em>position</em></kbd></dt>
104 <dd>where <em>position</em> is a float from 0.0 to 1.0 that is the position
105 for the fader for the send that <em>id</em> belongs to.</dd>
106 <dt><kbd class="osc">/cue/send/enable/<em>id</em> <em>state</em></kbd></dt>
107 <dd>where <em>state</em> is a float of 0.0 or 1.0 that is the state
108 of the enable for the send that <em>id</em> belongs to.</dd>
111 While a fader is being adjusted, the corresponding <em>/*/name</em>
112 text will give the level in db.