X-Git-Url: http://shamusworld.gotdns.org/cgi-bin/gitweb.cgi?a=blobdiff_plain;f=include%2Fosc-personal-monitoring.html;fp=include%2Fosc-personal-monitoring.html;h=9cc24f51118d89ba24dd43673d065dfab2b4b1d6;hb=26316522e607888a43944af5ca0faeff99354dec;hp=0000000000000000000000000000000000000000;hpb=868cf77b9cf3134a70f90802440ec713b3703e1c;p=ardour-manual-diverged
diff --git a/include/osc-personal-monitoring.html b/include/osc-personal-monitoring.html
new file mode 100644
index 0000000..9cc24f5
--- /dev/null
+++ b/include/osc-personal-monitoring.html
@@ -0,0 +1,112 @@
+---
+layout: default
+title: OSC: Personal Monitoring Control
+---
+
+
+ Personal monitoring can allow a performer with a smart phone to set
+ their personal monitor mix for a floor wedge or inear monitoring.
+
+Setup
+
+ Some setup needs to be done in the GUI mixer window before this can
+ work.
+
+
+ -
+ Create a bus for each performer who will have personal
+ monitoring. A good practice is to name the bus with the
+ performers name.
+
+ -
+ Connect the output of that bus to one of the audio
+ interface's playback ports that is not otherwise used. OSC
+ will now include this bus in it's list of aux buses as it
+ no longer has it's output connected to the Master bus.
+
+ -
+ Add an aux send to each channel the performer needs to hear
+ in their personal mix. Many performers only need three or
+ four sources to be mixed. If the performer needs to hear a
+ a set of inputs that are combined into a bus, adding the
+ aux send to that bus may make more sense than adding ten
+ drum channels for example.
+
+ -
+ If the performer wishes to hear effects in their monitor,
+ an extra send from the send bus, placing the performers aux
+ send after the effect or a plugin can be added in line in
+ the aux bus itself.
+
+
+
+ This gives stage or studio monitoring for the performer.
+
+
+The OSC commands and feedback for personal monitoring
+
+ All of the personal monitoring commands and feedback start with a
+ /cue. It is expected that a surface used as a personal
+ monitor control will use only /cue commands.
+
+
+ The send controls and feedback all have the send id (1 to n) in line
+ as part of the OSC path. So the path for the second send would be
+ /cue/send/fader/2 to set the level. It is considered that
+ most surfaces used for this will only be able to handle one parameter.
+
+Commands
+
+ - /cue/connect
+ - Returns a list of aux buses.
+ - /cue/aux aux-number
+ - where aux-number is an integer which is the aux bus
+ number this surface will use.
+ - /cue/next_aux
+ - Sets the the aux bus to one bus higher.
+ - /cue/previous_aux
+ - Sets the aux to one bus lower.
+ - /cue/connect
+ - Returns a list of aux buses.
+ - /cue/fader position
+ - where position is a float for the position of the fader
+ between 0.0 and 1.0.
+ - /cue/mute state
+ - where state is a float of 0.0 for mute off and 1.0 for mute on.
+ - /cue/send/fader/id position
+ - where position is a float for the position of the fader
+ between 0.0 and 1.0.
+ - /cue/send/enable/id state
+ - where state is a float of 0.0 for disable and 1.0 for enable.
+
+Feedback
+
+ - /cue/name name
+ - where name is a string that is the name of the currently
+ selected aux bus.
+ - /cue/name/id name
+ - where name is a string that is the name of the aux bus
+ that id belongs to.
+ - /cue/fader position
+ - where position is a float from 0.0 to 1.0 that shows the
+ fader position for the selected aux bus.
+ - /cue/mute state
+ - where state is a float of 0.0 or 1.0 that shows the state
+ of the mute for the selected aux bus.
+ - /cue/signal activity
+ - where activity is a float of 0.0 or 1.0 that shows audio
+ activity for the selected aux bus.
+ - /cue/send/name/id name
+ - where name is a string that is the name of the channel
+ that send id belongs to.
+ - /cue/send/fader/id position
+ - where position is a float from 0.0 to 1.0 that is the position
+ for the fader for the send that id belongs to.
+ - /cue/send/enable/id state
+ - where state is a float of 0.0 or 1.0 that is the state
+ of the enable for the send that id belongs to.
+
+
+ While a fader is being adjusted, the corresponding /*/name
+ text will give the level in db.
+