diff --git a/_manual/22_using-control-surfaces/01_controlling-ardour-with-osc.html b/_manual/22_using-control-surfaces/01_controlling-ardour-with-osc.html index 59aa90c..d9ff36c 100644 --- a/_manual/22_using-control-surfaces/01_controlling-ardour-with-osc.html +++ b/_manual/22_using-control-surfaces/01_controlling-ardour-with-osc.html @@ -60,22 +60,44 @@ here"/> to valuse set by Aurdour's GUI or automation, What kind of math the faders use and more.

+

+ Any time the /set_surface command is sent, the current bank + is recalculated and if feedback is turned on, the values of each + strip's controls are sent (or refreshed) as well. +

+

If /set_surface is not sent, the default values are used: +

+ These values give the same behaviour as prior versions of Ardour. +

/set_surface bank_size strip_types feedback fadermode
-
where bank_size is an int ranging from 0 to about 65000 - (16bits) The value 0 means no banking (or infinite bank size). - strip_types (when implemented) is a bitset that will - determine what kind of channels will be included in the bank. - feedback is a bitset that determines what things should send - feedback to the control surface. fadermode is a string that - tells Ardour what kind of math the control surface's faders use.
+
+ See below for an explaination of each parameter. +
-

- Strip Types Coming soon... check for more info sometime. +

bank_size

+

+ Bank Size is the number of channel strips the controller supports + without banking. Setting this to 0 turns banking off by setting the + bank size to infinite.

-

- Feedback This is an integer made up of bits. The easy way to +

strip_types

+

+ Strip Types are coming soon... check for more info sometime. For now + just use 0 (or anything else) as this is ignored. I don't know the bit + order just yet, but it will work similar to feedback below. Strip Types + will determine What kind of strips will be included in a bank. This would + include: Audio, MIDI, busses, VCAs, Master, Monitor and hopefully + hidden or selected strips. +

+

feedback

+

Feedback is an integer made up of bits. The easy way to deal with this is to think of feedback items being worth a number and then adding all those numbers together for a value to send.

+ So using a value of 17 would turn on feedback for strip and master + controls, but leave meters, timecode and bar/beat feedback off.

-

+

gainmode

+

Gainmode is a string that is one of:

-

- Any time the /set_surface command is sent, the current bank - is recalculated and if feedback is turned on, the values of each - strip's controls are sent (or refreshed) as well. -

-

If /set_surface is not sent, the default values of: -

- These values give the same behaviour as prior versions of Ardour.

List of OSC messages

@@ -133,23 +143,12 @@ here"/>

Master or Global messages

Master and Monitor strip control

+

(coming soon)

-
/masterabs abs
-
where abs is a float ranging from 0.0f to 2.0f
-
/masterdB dB
-
where dB is a float ranging from -200f to 6f
-
/masterfader fader
-
where fader is a float ranging from 0.0f to 1.0f
-
/master1024 fader
-
where fader is an int ranging from 0 to 1023
-
/monitorabs abs
-
where abs is a float ranging from 0.0f to 2.0f
-
/monitordB dB
-
where dB is a float ranging from -200f to 6f
-
/monitorfader fader
-
where fader is a float ranging from 0.0f to 1.0f
-
/monitor1024 fader
-
where fader is an int ranging from 0 to 1023
+
/master/gain value
+
where value is determined by gainmode. (see /set_surface)
+
/monitor/gain value
+
where value is determined by gainmode. (see /set_surface)

Transport Control

@@ -235,7 +234,7 @@ here"/>
where gain_db is a float ranging from -200 to 6 representing the desired gain of the track in dB.
/strip/fader rid fader position
where fader position is a float ranging from 0 to 1 representing the fader control position.
-
/strip/gaindB rid gain_db
+
/strip/fader1024 rid fader1024
where fader1024 is an int ranging from 0 to 1023 representing the fader control position.
/strip/trimabs rid trim_abs
where trim_abs is a float ranging from 0.1 to 10 (-20dB to +20dB). (since 4.1)