X-Git-Url: http://shamusworld.gotdns.org/cgi-bin/gitweb.cgi?a=blobdiff_plain;f=include%2Fosc58-controlling-ardour-with-osc.html;h=33cd4bb91a8a3ddcde78e1ae9b0c3bc0829fdbad;hb=ca8c53473dfbcb7d4b483a5ce792bbf4b5caffe8;hp=3e3cdd40af1429b3bb5db7f2ac107e824f22d3e4;hpb=f748342d8f02f3cb9b07e498e00ea8631e66f581;p=ardour-manual diff --git a/include/osc58-controlling-ardour-with-osc.html b/include/osc58-controlling-ardour-with-osc.html index 3e3cdd4..33cd4bb 100644 --- a/include/osc58-controlling-ardour-with-osc.html +++ b/include/osc58-controlling-ardour-with-osc.html @@ -79,10 +79,12 @@ here"/>
If /set_surface is not sent, the default values are used:
@@ -90,11 +92,27 @@ here"/>
/set_surface bank_size strip_types - feedback fadermode | + feedback fadermode send_page_size plugin_page_sizeSee below for an explanation of each parameter. |
---|
+ The /set_surface message may have all values except the last in-line.
+ For example: /set_surface/8/31/8403/0/8 i 16
would be valid.
+ Do be careful of switches which send a 0 on release, it may be necessary
+ to set the value as the release value rather than the press value.
+
+ The /set_surface message may have less than the full set of parameters. + those left out will remain as they were before the /set_surface message was + sent. All parameters included must be valid. For example, setting send page + size would require also setting bank_size, strip_types, feedback and gain mode. + using only two parameters will set bank_size and strip_types. Sending /set_surface with + no parameters will result in Ardour returning a /set_surface message with the + current settings. Surfaces using /set_surface iiii b st fb gm as was the case + in versions of Ardour older than 5.10 will continue to work. +
Bank Size is the number of channel strips the controller supports @@ -168,6 +186,25 @@ here"/>
Gain mode can also be set with /set_surface/gainmode gainmode.
++ Send_page_size is an int for the number of send channels that can be controlled + at one time. Each channel has a name, level and enable control. (added in Ardour 5.10) +
++ Send page size can also be set with /set_surface/send_page_size send_page_size. +
++ plugin_page_size is an int for the number of plugin controls that can be controlled + at one time. Each control has a name and level. As each plugin is different (as is each + parameter), the surface should expect to control the plugin parameters with a variable + control (pot or slider) with a float value from 0 to 1 (even on/off switches). (added in + Ardour 5.10) +
++ Plugin page size can also be set with /set_surface/plugin_page_size plugin_page_size. +
@@ -240,7 +277,7 @@ here"/>
/scrub delta | Where delta is a float indicating forward or reverse movement. - See OSC Scrub Modes | |||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
/jog delta | Where delta is a float indicating forward or reverse movement | |||||||||||||||||||||||||||||||||||||||
/jog/mode mode | @@ -286,6 +323,8 @@ here"/>dB is a float indicating the desired gain in dB | |||||||||||||||||||||||||||||||||||||||
/master/fader position | position is a float between 0 and 1 setting the desired position of the fader | |||||||||||||||||||||||||||||||||||||||
/master/db_delta delta | +where delta is a float that will increase or decrease the gain of master by the amount of the delta. (Ardour 5.11+) | |||||||||||||||||||||||||||||||||||||||
/master/trimdB dB | dB is a float from -20 to +20 representing the desired trim gain in dB | |||||||||||||||||||||||||||||||||||||||
/master/pan_stereo_position position | @@ -296,6 +335,8 @@ here"/>dB is a float indicating the desired gain in dB | |||||||||||||||||||||||||||||||||||||||
/monitor/fader position | position is a float between 0 and 1 setting the desired position of the fader | |||||||||||||||||||||||||||||||||||||||
/monitor/db_delta delta | +where delta is a float that will increase or decrease the gain of monitor by the amount of the delta. (Ardour 5.11+) | |||||||||||||||||||||||||||||||||||||||
/monitor/mute state | state is an int of 0 or 1 where 1 is muted | |||||||||||||||||||||||||||||||||||||||
/monitor/dim state | @@ -324,8 +365,10 @@ here"/> param should be a float even if an int is required below.
/bank_up | +|
---|---|
/bank_up | Change bank to the next higher bank. |
/bank_up delta | +Where delta is a float of 1 to bank up and -1 is bank down for use with an encoder (Ardour 5.11+) |
/bank_down | Change bank to the next lower bank. |
/strip/mute ssid mute_st | @@ -351,9 +394,14 @@ here"/>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 a float ranging from 0 to 1 representing the fader control position. |
/strip/db_delta ssid delta | +where delta is a float that will increase or decrease the gain of a track by the amount of the delta. (Ardour 5.11+) |
/strip/*/automation ssid mode | where mode is an int ranging from 0 to 3 representing the desired automation mode for the control. See OSC Automation. |
/strip/*/touch ssid state | +where state is an int of 1 for touched and 0 for released. + See OSC Automation. |
/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 | @@ -460,9 +508,14 @@ here"/>Where gain is a float ranging from -193 to 6 representing the desired gain of the track in dB. |
/select/fader position | Where position is an float ranging from 0 to 1 representing the fader control position. |
/select/db_delta delta | +where delta is a float that will increase or decrease the gain of the selected track by the amount of the delta. (Ardour 5.11+) |
/select/*/automation mode | where mode is an int ranging from 0 to 3 representing the desired automation mode for the control. See OSC Automation. |
/select/*/touch state | +where state is an int of 1 for touched and 0 for released. + See OSC Automation. |
/select/trimdB trim_db | where trim_db is a float ranging from -20 to 20 representing the desired trim of the track in dB. |
/select/pan_stereo_position position | @@ -483,8 +536,19 @@ here"/> ranging from 0 to 1 representing the desired position for the send as a fader|
/select/send_enable", sendid state | where sendid = nth_send, state is 1 for enabled and 0 for disabled |
/select/send_page", delta | +where delta is an int or float selecting another send as a delta from the current send. |
/select/plugin_page", delta | +where delta is an int or float selecting another plugin parameter as a delta from the current parameter. |
/select/plugin/parameter", plugin parameter value | +where plugin = nth plugin, parameter = nth parameter and value is a float from 0 to 1 |
+ /select/send_page
and /select/plugin_page
may be used
+ with a page up and page down switch by using a switch with a value of 1
+ for page up and a switch with a value of -1
for page down. An encoder
+ can be used as well. (these commands were added in Ardour version 5.10)
+
Every single menu item in Ardour's GUI is accessible via OSC. There is