X-Git-Url: http://shamusworld.gotdns.org/cgi-bin/gitweb.cgi?a=blobdiff_plain;f=include%2Fosc58-controlling-ardour-with-osc.html;h=f31f63991b07ad1d6e0972908a47151d4e64cd68;hb=b55fb0c2679726d38d28cf2dd7b1b0d7bf7ec085;hp=daea2866c23743422b0331d1ea580b1801b27c59;hpb=3ac2b1ab0af5ff2d380c60cad295cbced589602f;p=ardour-manual diff --git a/include/osc58-controlling-ardour-with-osc.html b/include/osc58-controlling-ardour-with-osc.html index daea286..f31f639 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,7 +74,7 @@ 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: @@ -88,13 +88,13 @@ here"/>
These values give the same behaviour as prior versions of Ardour. (or the closest possible)
-/set_surface bank_size strip_types + feedback fadermode | +See below for an explanation of each parameter. - - + |
---|
Bank Size is the number of channel strips the controller supports @@ -110,13 +110,13 @@ here"/> deal with this is to think of strip_types items being worth a number and then adding all those numbers together for a value to send. Strip Types will determine what kind of strips will be included in - bank. This would include: Audio, MIDI, buses, VCAs, Master, Monitor + bank. This would include: Audio, MIDI, busses, VCAs, Master, Monitor and hidden or selected strips.
Aside from setting the track types for the main mix assignments, using /set_surface/strip_types with more than one surface button will allow - switching between modes for example: inputs only, buses only, + switching between modes for example: inputs only, busses only, selected only, hidden only, by having the buttons send values of: 3, 12, 256, 512. A full mix button might have a value 31.
@@ -128,7 +128,7 @@ here"/> strips.Please see: + href="@@osc58-feedback-and-strip-types-values"> Calculating Feedback and Strip-types Values.
@@ -140,7 +140,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. @@ -173,7 +173,7 @@ here"/>
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,142 +181,121 @@ 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 |
/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) |
/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. |
/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 |
---|
/toggle_punch_in | +|
---|---|
/toggle_punch_out | +|
/rec_enable_toggle | +Toggles master record enable |
/transport_frame | +Ardour sends /transport_frame current_frame |
---|---|
/transport_speed | +Ardour sends /transport_speed speed |
/record_enabled | +Ardour sends /record_enabled recordenable_status |
/undo | +|
---|---|
/redo | +|
/save_state | +(this is the regular Session > Save + operation) |
/master/gain dB | +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/trimdB dB | +dB is a float from -20 to +20 representing the desired trim gain in dB |
/master/pan_stereo_position position | +position is a float from 0 to 1 representing the desired pan position |
/master/mute state | +state is an int of o or 1 representing the desired mute state |
/monitor/gain dB | +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/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 |
@@ -337,75 +316,75 @@ here"/> below can also be sent as /strip/command/ssid param. In this case the param should be a float even if an int is required below.
-/bank_up | +Change bank to the next higher bank. |
---|---|
/bank_down | +Change bank to the next lower bank. |
/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 | +where solo_st is a bool/int representing the desired solo state of the track |
/strip/solo_iso ssid state | +where state is a bool/int representing the desired solo isolate state of the track |
/strip/solo_safe ssid state | +where state is a bool/int representing the desired solo safe/lock state of the track |
/strip/monitor_input ssid monitor_st | +where monitor_st is a bool/int where 1 is forced input monitoring. |
/strip/monitor_disk ssid monitor_st | +where monitor_st is a bool/int where 1 is forced disk monitoring. When input and disk are both off, + Auto monitoring is enabled. |
/strip/recenable ssid rec_st | +where rec_st is a bool/int representing the desired rec state of the track |
/strip/record_safe ssid rec_st | +where rec_st is a bool/int representing the desired record safe state of the track |
/strip/polarity ssid invert | +where invert is a bool/int representing the desired polarity of the track |
/strip/gain ssid gain | +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/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 position is a float ranging from 0 to 1 representing the desired pan position of the track |
/strip/pan_stereo_width ssid width | +where width is a float ranging from 0 to 1 representing the desired pan width of the track |
/strip/send/gain ssid sendid send_gain | +where sendid = nth_send, send_gain is a float + ranging from -193 to +6 representing the desired gain in dB for the send |
/strip/send/fader ssid sendid send_gain | +where sendid = nth_send, send_gain is a float + ranging from 0 to 1 representing the desired position for the send as a fader |
/strip/send/enable ssid sendid state | +where sendid = nth_send, state is 1 for enabled and 0 for disabled |
/strip/list | +see: + Querying Ardour with OSC. |
/strip/sends ssid | +see: + Querying Ardour with OSC. |
/strip/receives ssid | +see: + Querying Ardour with OSC. |
/strip/plugin/list ssid | +see: + Querying Ardour with OSC. |
/strip/plugin/descriptor ssid | +see: + Querying Ardour with OSC. |
/strip/plugin/reset ssid piid | +where piid = nth Plugin, will reset all values to the plugin's original values |
/strip/plugin/activate ssid piid | +where piid = nth Plugin, will set the plugin's state to active |
/strip/plugin/deactivate ssid piid | +where piid = nth Plugin, will set the plugin's state to inactive |
/strip/plugin/parameter ssid piid param value | +where piid = nth Plugin, param = nth param, value + is a float ranging from 0 to 1 representing the desired parameter value |
/strip/name ssid name | +where name is a string for the desired name of the track |
New for Ardour 5, A whole set of operations that work on the selected @@ -414,7 +393,7 @@ here"/>
Selected strip operations are complex enough for their own page. Please read: + href="@@osc58-selection-and-expansion-considerations"> Selection Considerations in OSC. This is most important if more than one OSC surface is being used with Ardour.
@@ -440,58 +419,58 @@ here"/> -/strip/select ssid y/n | +Where y/n = 1 for select. Sets both GUI select and strip + to expanded mode. (0 is ignored) |
---|---|
/strip/expand ssid y/n | +Where y/n = 1 for expanded mode. Sets only local strip to + Expanded. Setting to 0 resets the expansion to follow selection. |
/select/expand y/n | +Where y/n = 1 for expanded mode, 0 for Select mode. |
/select/recenable y/n | +Where y/n is 1 for enabled and 0 for disabled |
/select/record_safe y/n | +Where y/n is 1 for safe and 0 for unlocked |
/select/mute y/n | +Where y/n is 1 for enabled and 0 for disabled |
/select/solo y/n | +Where y/n is 1 for enabled and 0 for disabled |
/select/solo_iso state | +where state is a bool/int representing the desired solo isolate state of the track |
/select/solo_safe state | +where state is a bool/int representing the desired solo safe/lock state of the track |
/select/monitor_input y/n | +Where y/n is 1 for monitor from input and 0 for auto |
/select/monitor_disk y/n | +Where y/n is 1 for monitor from disk and 0 for auto |
/select/polarity invert | +where invert is a bool/int representing the desired polarity of the track |
/select/gain gain | +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/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 | +where position is a float ranging from 0 to 1 representing the desired pan position of the track |
/select/pan_stereo_width width | +where width is a float ranging from 0 to 1 representing the desired pan width of the track |
/select/pan_elevation_position position | +where position is a float ranging from 0 to 1 representing the desired pan elevation of the track |
/select/pan_frontback_position position | +where position is a float ranging from 0 to 1 representing the desired front to back position of the track |
/select/pan_lfe_control value | +where value is a float ranging from 0 to 1 representing the desired LFE control value for the track |
/select/send_gain", sendid send_gain | +where sendid = nth_send, send_gain is a float + ranging from -193 to +6 representing the desired gain in dB for the send |
/select/send_fader", sendid send_gain | +where sendid = nth_send, send_gain is a float + 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 |
@@ -500,10 +479,63 @@ here"/> with the mouse (or keyboard):
/access_action action_name- 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. -
+ As of Ardour 5.9, access_action can be inlined for control surfaces + 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 + as an OSC path extension: + +/access_action/Group/action key_pressed ++ The 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 for Ardour. +
+ +