X-Git-Url: http://shamusworld.gotdns.org/cgi-bin/gitweb.cgi?a=blobdiff_plain;f=include%2Fosc58-controlling-ardour-with-osc.html;h=e6ba85f670988629cbf10d0509b16521d6d5f03c;hb=e74c09802c2ca4038144d051c425a65661bde3ea;hp=6bd2377fa1aee88d1e179f0e22363947352534c8;hpb=2ecd619a726e9b8991aa6094316e8b089633d879;p=ardour-manual diff --git a/include/osc58-controlling-ardour-with-osc.html b/include/osc58-controlling-ardour-with-osc.html index 6bd2377..e6ba85f 100644 --- a/include/osc58-controlling-ardour-with-osc.html +++ b/include/osc58-controlling-ardour-with-osc.html @@ -14,7 +14,7 @@ to gain controls. If you are using an Ardour version of 4.7 or less, please read - Osc control in ardour 4.7 and prior. + Osc control in Ardour 4.7 and prior.
@@ -53,9 +53,9 @@ here"/>
- Control surface set up allows the controller to tell Ardour about it's + Control surface set up allows the controller to tell Ardour about its capabilities. The surface can tell Ardour how many control strips it - has for banking, if it is capable of setting it's faders or buttons + has for banking, if it is capable of setting its faders or buttons to values set by Ardour's GUI or automation, What kind of math the faders use and more.
@@ -99,10 +99,19 @@ here"/>
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. + 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.
@@ -149,7 +158,7 @@ here"/> then adding all those numbers together for a value to send.
Please see: + href="@@osc58-feedback-and-strip-types-values#feedback"> Calculating Feedback and Strip-types Values.
Feedback can also be set with /set_surface/feedback feedback. @@ -180,7 +189,7 @@ here"/>
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. + 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. @@ -190,7 +199,8 @@ here"/> 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). + 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. @@ -313,16 +323,22 @@ here"/>
/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. |
/use_group state | +Where state is a float of 1 to use group or 0 to not use group. + more info on use_group |
/strip/mute ssid mute_st | where mute_st is a bool/int representing the desired mute state of the track |
/strip/solo ssid solo_st | @@ -378,6 +399,8 @@ 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. | 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/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 @@ -570,7 +600,7 @@ Any of these actions that can be moved to session->action calls may reapear.