X-Git-Url: http://shamusworld.gotdns.org/cgi-bin/gitweb.cgi?a=blobdiff_plain;f=_manual%2F22_using-control-surfaces%2F01_controlling-ardour-with-osc.html;h=f87c2f4bcb29e82111b5420b4fe4ff1c9f028c00;hb=b055bf2bf05cb9b349abee228083836948c76ddd;hp=d9ff36c1310f754d92b491f44011817a37bd3030;hpb=14511de427194d5f7c1e9deeeef0339f0363b778;p=ardour-manual-diverged 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 d9ff36c..f87c2f4 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 @@ -48,7 +48,10 @@ here"/> than one controller at a time. The two controllers can bank independantly and even use different math for faders. This could be used to allow talent to adjust their own monitor mix using a tablet - or phone that can run an OSC controller. + or phone that can run an OSC controller. For a full explanation of + how Ardour's feedback works please read + OSC feedback In Ardour.

Control Surface Set Up

@@ -63,16 +66,17 @@ here"/>

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. + strip's controls are sent (or refreshed) as well. This will also + refresh the Master feedback setup.

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

- These values give the same behaviour as prior versions of Ardour. + These values give the same behaviour as prior versions of Ardour. (or the closest possible)

/set_surface bank_size strip_types @@ -89,52 +93,34 @@ here"/>

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. + strip_types is an integer made up of bits. The easy way to + deal with this is to think of strip_types items being worth a number and + then adding all those numbers together for a value to send. + Strip Types will determine What kind of strips will be included in + bank. This would include: Audio, MIDI, busses, VCAs, Master, Monitor + and hidden or selected strips.

+

Please see: + Calculating Feedback and Strip-types Values.

feedback

-

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

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.

+

Please see: + Calculating Feedback and Strip-types Values.

+

gainmode

- Gainmode is a string that is one of: + Gainmode is a an int that acts as a bool:

@@ -142,26 +128,17 @@ here"/>

Master or Global messages

-

Master and Monitor strip control

-

(coming soon)

-
-
/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

-
/transport_stop
+
/transport_stop optional
-
/transport_play
+
/transport_play optional
/set_transport_speed s
where s is a float ranging from -8.0f to 8.0f
-
/ffwd
+
/ffwd optional
-
/rewind
+
/rewind optional
/goto_start
@@ -177,7 +154,7 @@ here"/>
where spos is the target position in samples and roll is a bool/integer defining whether you want transport to be kept rolling or not
-
/loop_toggle
+
/loop_toggle optional
@@ -198,48 +175,75 @@ here"/>
/toggle_punch_out
-
/rec_enable_toggle
+
/rec_enable_toggle optional
/toggle_all_rec_enables
(toggles all tracks' recording state)
+

Master and Monitor strip control

+
+
/master/gain dB
+
where dB is a float ranging from -193 to +6 representing the desired gain of master in dB
+
/master/fader position
+
where position is an int ranging from 0 to 1023 representing the fader control position
+
/master/trimdB dB
+
where dB is a float ranging from -20 to +20 representing the desired trim for master in dB
+
/master/pan_stereo_position position
+
where position is a float ranging from 0 to 1 representing the desired pan position for master
+
/master/mute yn
+
where yn is a bool/int representing the desired mute state of the track
+
/monitor/gain dB
+
where dB is a float ranging from -193 to 6 representing the desired gain of monitor in dB
+
/monitor/fader position
+
where position is an int ranging from 0 to 1023 representing the fader control position
+
+

Track specific operations

- For each of the following, rid is the remote ID for the track + For each of the following, ssid is the Surface Strip ID for the track

- RID has a different meaning than in Ardour version 4.7 and before. - Effectively, banking is always being used and the RID is generated on - the fly. The RID is the possition of the strip within bank as an int + SSID has a different meaning than RID in Ardour version 4.7 and before. + Effectively, banking is always being used and the SSID is generated on + the fly. The SSID is the possition of the strip within bank as an int 1 to bank size. There are no gaps as there have been in the past. Depending on the value of strip_types sent to Ardour, Master and - Monitor, may be included in the list of RIDs or not as the controller - sets. + Monitor, may be included in the list of SSIDs or not as set in + /set_surface. +

+

+ Some Surfaces (many Android applets) are not able to deal with more + than one parameter in a command. However, the two parameter commands + below can also be sent as /strip/command/ssid param. In this case the + param should be a float even if an int is required below.

-
/bank_up
+
/bank_up
Change bank to the next higher bank.
-
/bank_down
+
/bank_down
Change bank to the next lower bank.
-
/strip/mute rid mute_st
+
/strip/mute ssid mute_st
where mute_st is a bool/int representing the desired mute state of the track
-
/strip/solo rid solo_st
+
/strip/solo ssid solo_st
where solo_st is a bool/int representing the desired solo state of the track
-
/strip/recenable rid rec_st
+
/strip/monitor_input ssid monitor_st
+
where monitor_st is a bool/int where 1 is forced input monitoring.
+
/strip/monitor_disk ssid monitor_st
+
where monitor_st is a bool/int where 1 is forced disk monitoring. When input and disk are both off, + Auto monitoring is enabled.
+
/strip/recenable ssid rec_st
where rec_st is a bool/int representing the desired rec state of the track
-
/strip/gainabs rid gain_abs
-
where gain_abs is a float ranging from 0 to 2 (0 being -infinite, 1 being 0dB and 2 being +6dB).
-
/strip/gaindB rid gain_db
-
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/fader1024 rid fader1024
-
where fader1024 is an int ranging from 0 to 1023 representing the fader control position.
-
/strip/trimabs rid trim_abs
+
/strip/gain ssid gain
+
where gain is a float ranging from -193 to 6 representing the desired gain of the track in dB.
+
/strip/fader ssid position
+
where position is an int ranging from 0 to 1023 representing the fader control position.
+
/strip/trimabs ssid trim_abs
where trim_abs is a float ranging from 0.1 to 10 (-20dB to +20dB). (since 4.1)
-
/strip/trimdB rid trim_db
-
where trim_db is a float ranging from -20 to 20 representing the desired trim of the track in dB. (since 4.1)
+
/strip/trimdB ssid trim_db
+
where trim_db is a float ranging from -20 to 20 representing the desired trim of the track in dB.
+
/strip/pan_stereo_position ssid position
+
where position is a float ranging from 0 to 1 representing the desired pan position of the track

Menu actions

@@ -824,3 +828,5 @@ here"/>
Zoom/zoom-focus-playhead
Zoom Focus Playhead
Zoom/zoom-focus-right
Zoom Focus Right
+ +{% children %}