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:
- Bank Size: 0 - No banking (or infinite bank size).
- - Strip Types: All strip types except hidden.
+ - Strip Types: All strip types except hidden and special.
- Feedback: Off.
- - Fader Mode: ABS - Absolute gain.
+ - Fader Mode: 0 - gain in dB
- 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.
-
- -
- 1 - feedback values of controls in strips.
-
- -
- 2 - Send meter values (not coded yet).
-
- -
- 4 - Send timecode (not codeed yet).
-
- -
- 8 - Send Bar and Beat (not coded yet).
-
- -
- 16 - Enable master section feedback (not coded yet).
-
-
- 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:
- - ABS Absolute Gain as a float value from 0.0 to 2.0
- sent in the same manner as the OSC command. For example:
- /strip/gainabs RID Value.
- - DB dB value as a float from -200 to +6. Sent as
- /strip/gaindB RID value.
- - FADER A positional fader based on the same math as
- Ardour's GUI. A float from 0.0 to 1.0.
- Sent as /strip/fader RID value
- - INT1024 Also a positonal value, but an Integer from
- 0 to 1023 (1024 values) for controllers with no FPU. Sent as
- /strip/fader1024 RID value
+ - 0 (or false) dB value as a float from -193 to +6. Sent as
+ /strip/gain RID value. (-193 or below are the same as -inf)
+ - 1 (or true) A positional fader based on the same math as
+ Ardour's GUI. An Integer from 0 to 1023 (1024 values). Sent as
+ /strip/fader RID value
@@ -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-playheadZoom Focus Playhead
Zoom/zoom-focus-rightZoom Focus Right
+
+{% children %}