From a885875b007fa0766edb62d5512e3099e946d055 Mon Sep 17 00:00:00 2001 From: Len Ovens Date: Thu, 15 Jun 2017 13:11:54 -0700 Subject: [PATCH] OSC: expand new /set_surface function. --- .../osc58-controlling-ardour-with-osc.html | 23 +++++++++++++++---- 1 file changed, 19 insertions(+), 4 deletions(-) diff --git a/include/osc58-controlling-ardour-with-osc.html b/include/osc58-controlling-ardour-with-osc.html index 6bd2377..ea395f6 100644 --- a/include/osc58-controlling-ardour-with-osc.html +++ b/include/osc58-controlling-ardour-with-osc.html @@ -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.

bank_size

@@ -180,7 +189,7 @@ here"/>

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. + 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. @@ -523,7 +533,12 @@ here"/> /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) +

Menu actions

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