X-Git-Url: http://shamusworld.gotdns.org/cgi-bin/gitweb.cgi?a=blobdiff_plain;f=include%2Fosc58-personal-monitoring-control.html;h=9efe1ce10d0a8de0a9c321bf4d994325626e1ac1;hb=21e5a751c89946c7b5dec5914ef6807090bff554;hp=5a28f1cf237e2311f30adff6985e48a9ba1135b2;hpb=0d4be5fdfb660d75853e46019e4a5acf3816363b;p=ardour-manual diff --git a/include/osc58-personal-monitoring-control.html b/include/osc58-personal-monitoring-control.html index 5a28f1c..9efe1ce 100644 --- a/include/osc58-personal-monitoring-control.html +++ b/include/osc58-personal-monitoring-control.html @@ -1,13 +1,16 @@

Personal monitoring can allow a performer with a smart phone to set - their personal monitor mix for a floor wedge or inear monitoring. - In Ardour 5.6 OSC commands to allow this were added. + their personal monitor mix for a floor wedge or in-ear monitoring. + In Ardour 5.6 OSC commands to allow this were added for use with aux + buses. Ardour 6.0 added Foldback buses for this purpose and these + commands work directly for those.

Setup

- Some setup needs to be done in the GUI mixer window before this can - work. + Foldback buses can be added from the GUI + (see: Foldback section) + or using the /cue/new_bus OSC command.

@@ -44,7 +45,41 @@

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. + monitor control will use only /cue commands. +

+

There is one OSC command apart from the /cue + commands: /select/add_fldbck_send +

+

+ Most phone OSC applets (TouchOSC, Control) require manual port to be set. + There are certainly more controls than needed. Using send enables for + example, may lead to wasted time discovering why a send has no sound. + A good easy to use controller that fits on most phones while still + being controllable even with big fingers might look like: +

+ + + + + +
+
+ TouchOSC Screenshot +
Personal Monitor controller using TouchOSC
+
+
+
+ Control Screenshot +
Personal Monitor controller using Control
+
+
+ +

+ Ardour is not limited to talking to one personal monitor controller + at a time, but is able to deal with many simultaneously, each controlling + its own foldback bus.

The send controls and feedback all have the send id (1 to n) in line @@ -53,58 +88,81 @@ most surfaces used for this will only be able to handle one parameter.

Commands

-
-
/cue/connect
-
Returns a list of aux busses.
-
/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 busses.
-
/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.
-
+ + + + + + + + + + + + + + + + + + + + +
/cue/connectReturns a list of foldback busses and connects to the first.
/cue/bus indexwhere index is an integer or float which is the + foldback bus number this surface will use.
/cue/next_busSets the the foldback bus to one bus higher.
/cue/previous_busSets the foldback bus to one bus lower. This can also be used as a + "connect" button to save space in a phone layout.
/cue/connect_output outputwhere output is a string that is the name of an output port + or the number of the output port if the port is a system:playback port + to connect the foldback bus to.
/cue/new_bus name l-output + r-output where name is the name for + the new foldback bus as a string, l-output (optional) is the name + of the output port to connect to. And r-output (if present) will + make the new foldback bus stereo and connect the right output port to the + named port. All parameters are string type. +
/cue/new_send stripwhere strip is a string with the name of the strip to add + a foldback send to that sends to the current foldback bus. + +
/cue/fader positionwhere position is a float for the position of the fader + between 0.0 and 1.0.
/cue/mute statewhere state is a float of 0.0 for mute off and 1.0 for + the foldback bus mute on.
/cue/send/fader/id positionwhere position is a float for the position of the send + fader between 0.0 and 1.0.
/cue/send/enable/id statewhere 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.
-
+ + + + + + + + + + + + + + + + + +
/cue/name namewhere name is a string that is the name of the currently + selected foldback bus.
/cue/name/id namewhere name is a string that is the name of the foldback bus + that id belongs to.
/cue/fader positionwhere position is a float from 0.0 to 1.0 that shows the + fader position for the selected foldback bus.
/cue/mute statewhere state is a float of 0.0 or 1.0 that shows the state + of the mute for the selected foldback bus.
/cue/signal activitywhere activity is a float of 0.0 or 1.0 that shows audio + activity for the selected foldback bus.
/cue/send/name/id namewhere name is a string that is the name of the channel + that send id belongs to.
/cue/send/fader/id positionwhere 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 statewhere 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.

- +

Setting up a Foldback bus from a selected strip

+

+ A selected or expanded strip can create a foldback send and create + a foldback bus at the same time using: + /select/add_fldbck_send name + where name is a string with the name of the desired foldback + bus. If the name matches an existing foldback bus the new send will + be added to the selected or expanded strip that feeds that bus. If there + is no strip of that name, one will be created. +