If /set_surface is not sent, the default values are used: @@ -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,7 +181,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 |
|---|
| /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/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 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/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 |
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.
@@ -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. +
+