X-Git-Url: http://shamusworld.gotdns.org/cgi-bin/gitweb.cgi?a=blobdiff_plain;f=include%2Fosc58-personal-monitoring-control.html;h=9efe1ce10d0a8de0a9c321bf4d994325626e1ac1;hb=a61fbacdfcb7a76fe425fada61f49fc85751e47a;hp=54123281ae65ce77b8ed82b84f7b295945fcd962;hpb=042723be8949fe53bb488183a91e27c398d40ce4;p=ardour-manual diff --git a/include/osc58-personal-monitoring-control.html b/include/osc58-personal-monitoring-control.html index 5412328..9efe1ce 100644 --- a/include/osc58-personal-monitoring-control.html +++ b/include/osc58-personal-monitoring-control.html @@ -2,12 +2,15 @@

Personal monitoring can allow a performer with a smart phone to set their personal monitor mix for a floor wedge or in-ear monitoring. - In Ardour 5.6 OSC commands to allow this were added. + 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,10 @@

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. @@ -75,7 +79,7 @@

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 Aux bus. + its own foldback bus.

The send controls and feedback all have the send id (1 to n) in line @@ -86,23 +90,38 @@

Commands

- - - - - - - + + + + + + + + + + + - + - +
/cue/connectReturns a list of aux busses and connects to the first.
/cue/aux aux-numberwhere aux-number is an integer or float which is the aux bus - number this surface will use.
/cue/next_auxSets the the aux bus to one bus higher.
/cue/previous_auxSets the aux to one bus lower. This can also be used as a "connect" - button to save space in a phone layout.
Returns 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 position where 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 Aux bus mute on.
where 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 fader - between 0.0 and 1.0.
where position is a float for the position of the send + 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.
@@ -110,19 +129,19 @@ + selected foldback bus. - + fader position for the selected foldback bus. + of the mute for the selected foldback bus. + activity for the selected foldback bus. @@ -137,4 +156,13 @@ 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. +

/cue/name name where name is a string that is the name of the currently - selected aux bus.
/cue/name/id namewhere name is a string that is the name of the aux bus + where name is a string that is the name of the foldback 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.