X-Git-Url: http://shamusworld.gotdns.org/cgi-bin/gitweb.cgi?a=blobdiff_plain;f=include%2Fosc58-controlling-ardour-with-osc.html;h=bc3d330e7f7a62faa36e6f9a2c33a75c874502f5;hb=081e7af0b6f6dec0ca685d3a538eacf20394c2cc;hp=984bb6386f6bb75d2ffc51bcc7f596e3368f3d0e;hpb=e3adf6dfba963bcd7763d15f965b1243e7af662d;p=ardour-manual diff --git a/include/osc58-controlling-ardour-with-osc.html b/include/osc58-controlling-ardour-with-osc.html index 984bb63..bc3d330 100644 --- a/include/osc58-controlling-ardour-with-osc.html +++ b/include/osc58-controlling-ardour-with-osc.html @@ -13,7 +13,7 @@ work with (including bank size) and two new math styles have been added to gain controls. If you are using an Ardour version of 4.7 or less, please read + href="@@osc-control-for-ardour-4.7-and-prior"> Osc control in ardour 4.7 and prior.
@@ -46,7 +46,7 @@ here"/> used to allow talent to adjust their own monitor mix using a tablet or phone that can run an OSC controller. For a full explanation of how Ardour's feedback works please read + href="@@osc58-feedback"> OSC feedback In Ardour. @@ -74,15 +74,17 @@ here"/> able to set a port for Ardour to send to. It can also change the default setting for set_surface. For more information about Ardour's OSC configuration GUI please read + href="@@osc58-using-the-setup-dialog"> Ardour's Setup Dialog.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 @@ -128,7 +146,7 @@ here"/> strips.
Please see: + href="@@osc58-feedback-and-strip-types-values"> Calculating Feedback and Strip-types Values.
@@ -140,7 +158,7 @@ here"/> then adding all those numbers together for a value to send.
Please see: + href="@@osc58-feedback-and-strip-types-values"> Calculating Feedback and Strip-types Values.
Feedback can also be set with /set_surface/feedback feedback. @@ -168,12 +186,31 @@ 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. +
The control Surface may wish to control the type a frequency of updates it receives. It can do this with querying commands. See: + href="@@osc58-querying-ardour"> Querying Ardour with OSC.
@@ -181,7 +218,7 @@ here"/>Parameter types show how the value will be used. However, they may be sent as a different type if needed, see: + href="@@osc58-parameter-types"> Parameter Types in OSC.
/transport_stop | -Stops a rolling transport |
---|---|
/transport_play | -Puts transport in play mode |
/toggle_roll | Toggles between play and stop |
/set_transport_speed s | -where s is a float ranging from -8.0f to 8.0f |
/stop_forget | +Stop transport and delete/forget last take |
/set_transport_speed speed | +where speed is a float ranging from -8.0f to 8.0f |
/ffwd | -Adds 1.5 times to transport speed to maximum +8 times normal speed |
/rewind | -Adds -1.5 times to transport speed to maximum -8 times normal speed |
/goto_start | -Move playhead to start of session |
/goto_end | -Move playhead to end of session |
/jump_bars bars | Where bars is a float (+/-) of the number of bars to jump |
/jump_seconds seconds | Where seconds is a float (+/-) of the number of seconds to jump |
/toggle_click | +Toggle metronome click on and off |
/add_marker | (adds marker to the current transport position) |
/remove_marker | Removes marker at the current transport position (if there is one) |
/mark_in | -Marks the begining of a range at the current transport position |
/mark_out | -Marks the end of a range at the current transport position |
/next_marker | -Move playhead to next marker |
/prev_marker | -Move playhead to previous marker |
/locate spos roll | 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 | -Toggle loop mode on and off |
/loop_location start end | start is the beginning of a loop and end is the end of a loop both are integer frame positions. |
/set_loop_range | -Uses edit range as loop range |
/set_session_range | -Uses edit range as session range |
/toggle_click | -|
/midi_panic | Ardour will send an all notes off to all midi tracks |
/cancel_all_solos | Cancel All Solos/PFLs/AFLs |
+ New for Ardour 5.9. +
+/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 | +Where mode is an int from 0 to 7 indicating what the /jog + command controls. See + OSC Jog Modes |
/toggle_punch_in | +|
---|---|
/toggle_punch_out | +|
/rec_enable_toggle | +Toggles master record enable |
/save_state | (this is the regular Session > Save operation) |
---|---|
/quick_snapshot_switch | -Take a snapshot and switch to new version |
/quick_snapshot_stay | -Take a snapshot and keep working on this version |
/fit_*_track(s) | -Were * is one of 1, 2, 4, 8, 16, 32 or all. Fits this - many tracks in editor window. (add s for more than 1) |
/zoom_* | -Zoom editor to include * where * is 100_ms, 1_sec, - 10_sec, 1_min, 5_min, 10_min or to_session |
/temporal_zoom_in | -Zoom editor in to show less time |
/temporal_zoom_out | -Zoom editor out to show more time |
/scroll_up_1_track | -Scroll the editor pane up 1 track |
/scroll_up_1_page | -Scroll the editor pane up 1 page |
/scroll_dn_1_track | -Scroll the editor pane down 1 track |
/scroll_dn_1_page | -Scroll the editor pane down 1 page |
/toggle_punch_in | -|
---|---|
/toggle_punch_out | -|
/set_punch_range | -Uses edit range as punch range |
/rec_enable_toggle | -|
/stop_forget | -Stop transport and delete/forget last take |
/master/gain dB | -See gain in strips | dB is a float indicating the desired gain in dB |
---|---|
/master/fader position | -See fader in strips | 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 | -see trimdb in strips | dB is a float from -20 to +20 representing the desired trim gain in dB |
/master/pan_stereo_position position | -See pan_stereo_position in strips |
/master/mute yn | -See mute in strips | position is a float from 0 to 1 representing the desired pan position | +
/master/mute key | +key is an optional float 1 representing a master bus select |
/master/select state | +state is an int of o or 1 representing the desired mute state |
/monitor/gain dB | -See gain in strips | dB is a float indicating the desired gain in dB |
/monitor/fader position | -See fader in strips | 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 | +state is an int of 0 or 1 where 1 is dimmed |
/monitor/mono state | +state is an int of 0 or 1 where 1 is mono mode |
/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 | @@ -365,6 +396,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 | @@ -414,7 +453,7 @@ 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 | @@ -491,8 +538,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 @@ -501,20 +559,63 @@ here"/> /access_action action_name
As of Ardour 5.9, access_action can be inlined for control surfaces - that are unable to send string parameters. Action_name is composed of + that are unable to send string parameters. The action_name is composed of a group and an action in the form of Group/action which fits very well - an OSC path extension: + as an OSC path extension:
/access_action/Group/action key_pressedThe key_pressed is optional, but if present is a float 1 or 0 where the command is ignored if key_pressed is 0.
++ Some of the Menu Actions duplicate other OSC commands. In all cases it is better + to use the OSC commands rather than the Menu Actions if possible as the OSC commands + are more direct. +
- The - list of actions shows all available values of action-name as of - June 2016 for Ardour 5.0.pre0.1. You can get the current list at any - time by running Ardour with the -b flag. -
+ The list of actions + shows all available values of action-name for Ardour. + + +