X-Git-Url: http://shamusworld.gotdns.org/cgi-bin/gitweb.cgi?a=blobdiff_plain;f=include%2Fosc58-controlling-ardour-with-osc.html;h=ea395f6569d7cd658cbb599bfcdabd9e6fe13b50;hb=a885875b007fa0766edb62d5512e3099e946d055;hp=f695c0c824ae7832fce9348d79201335073ed470;hpb=a123dfec51122f0be59c06e9e836d5fceedc7650;p=ardour-manual diff --git a/include/osc58-controlling-ardour-with-osc.html b/include/osc58-controlling-ardour-with-osc.html index f695c0c..ea395f6 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"/>

+ feedbackfadermodesend_page_sizeplugin_page_size
/set_surface bank_size strip_types - feedback fadermode See 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

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

+

+ 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

+

+ 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. +

Querying Ardour for information

@@ -234,6 +271,20 @@ here"/> /cancel_all_solos Cancel All Solos/PFLs/AFLs +

+ New for Ardour 5.9. +

+ + + + + + + +
/scrub deltaWhere delta is a float indicating forward or reverse movement. + See OSC Scrub Modes
/jog deltaWhere delta is a float indicating forward or reverse movement
/jog/mode modeWhere mode is an int from 0 to 7 indicating what the /jog + command controls. See + OSC Jog Modes

Recording control

@@ -337,6 +388,12 @@ here"/> + + + + @@ -443,6 +500,12 @@ here"/> + + + + @@ -463,8 +526,19 @@ here"/> ranging from 0 to 1 representing the desired position for the send as a fader + + + + + +
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/*/automation ssid modewhere mode is an int ranging from 0 to 3 representing the desired automation mode for the control. + See OSC Automation.
/strip/*/touch ssid statewhere 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 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/*/automation modewhere mode is an int ranging from 0 to 3 representing the desired automation mode for the control. + See OSC Automation.
/select/*/touch statewhere 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
/select/send_enable", sendid state where sendid = nth_send, state is 1 for enabled and 0 for disabled
/select/send_page", deltawhere delta is an int or float selecting another send as a delta from the current send.
/select/plugin_page", deltawhere delta is an int or float selecting another plugin parameter as a delta from the current parameter.
/select/plugin/parameter", plugin parameter valuewhere 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) +

Menu actions

Every single menu item in Ardour's GUI is accessible via OSC. There is