From 1138f1dadbfa5db0014dd61e1496ef201e815e2c Mon Sep 17 00:00:00 2001 From: Len Ovens Date: Sat, 16 Jul 2016 17:44:14 -0700 Subject: [PATCH] OSC: update OSC docs. --- .../01_controlling-ardour-with-osc.html | 990 ++++++++++++------ .../02_feedback-in-osc.html | 74 +- ...ating-feedback-and-strip-types-values.html | 31 +- .../04_parameter-types-in-osc.html | 33 + .../05_selection-considerations-in-osc.html | 69 ++ 5 files changed, 860 insertions(+), 337 deletions(-) create mode 100644 _manual/22_using-control-surfaces/01_controlling-ardour-with-osc/04_parameter-types-in-osc.html create mode 100644 _manual/22_using-control-surfaces/01_controlling-ardour-with-osc/05_selection-considerations-in-osc.html diff --git a/_manual/22_using-control-surfaces/01_controlling-ardour-with-osc.html b/_manual/22_using-control-surfaces/01_controlling-ardour-with-osc.html index 59420aef..722ead99 100644 --- a/_manual/22_using-control-surfaces/01_controlling-ardour-with-osc.html +++ b/_manual/22_using-control-surfaces/01_controlling-ardour-with-osc.html @@ -46,7 +46,7 @@ here"/> feedback request. The port does not have to match Ardour's port. In fact it is better not to. This means that Ardour can deal with more than one controller at a time. The two controllers can bank - independantly and even use different math for faders. This could be + independently and even use different math for faders. This could be 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 "/> Control surface set up allows the controller to tell Ardour about it's 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 - to valuse set by Aurdour's GUI or automation, What kind of math the + to values set by Ardour's GUI or automation, What kind of math the faders use and more.

@@ -73,16 +73,18 @@ 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 explaination of each parameter. + See below for an explanation of each parameter.

bank_size

@@ -91,18 +93,39 @@ here"/> without banking. Setting this to 0 turns banking off by setting the bank size to infinite.

+

+ Bank size can also be set with /set_surface/bank_size size. +

strip_types

strip_types is an integer made up of bits. The easy way to 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, busses, VCAs, Master, Monitor + Strip Types will determine what kind of strips will be included in + bank. This would include: Audio, MIDI, buses, 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, + selected only, hidden only, by having the buttons send values of: 3, + 12, 256, 512. A full mix button might have a value 31. +

+

+ While Master and Monitor are listed as possibilities, most surfaces + will not use them. Using /master and /monitor makes more sense. + However, in the case where there are no master or monitor fader strips + on the surface, it may be necessary to include them in the banked + strips. +

Please see: - Calculating Feedback and Strip-types Values.

+ Calculating Feedback and Strip-types Values. +

+

+ Strip types can also be set with /set_surface/strip_types types. +

feedback

Feedback is an integer made up of bits. The easy way to deal with this is to think of feedback items being worth a number and @@ -111,6 +134,9 @@ here"/>

Please see: Calculating Feedback and Strip-types Values.

+

+ Feedback can also be set with /set_surface/feedback feedback. +

gainmode

@@ -123,29 +149,57 @@ here"/> /strip/fader RID value

+

+ Gainmode applies only to feedback values. The controller can choose + which gain math to use by choosing to use the /*/gain or /*/fader path + to send to Ardour. This makes sure a controller that doesn't set up + Ardour's OSC can still use either math. The gainmode for feedback also + determines the path Ardour uses for feedback so that the feedback + messages match the control messages. +

+

+ Gain mode can also be set with /set_surface/gainmode gainmode. +

List of OSC messages

- +

+ Parameter types show how the value will be used. However, they may + be sent as a different type if needed, see: + Parameter Types in OSC. +

Master or Global messages

Transport Control

-
/transport_stop optional
+
/transport_stop
-
/transport_play optional
+
/transport_play
+
/toggle_roll
+
Toggles between play and stop
/set_transport_speed s
where s is a float ranging from -8.0f to 8.0f
-
/ffwd optional
+
/ffwd
-
/rewind optional
+
/rewind
/goto_start
/goto_end
+
/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
/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
/prev_marker
@@ -154,8 +208,31 @@ here"/>
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 optional
+
/loop_toggle
+
/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
+
+ +

Transport Information

+
+
/transport_frame
+
Ardour sends /transport_frame current_frame
+
/transport_speed
+
Ardour sends /transport_speed speed
+
/record_enabled
+
Ardour sends /record_enabled recordenable_status

Editing-related

@@ -167,6 +244,28 @@ here"/>
/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

Recording control

@@ -175,28 +274,32 @@ here"/>
/toggle_punch_out
-
/rec_enable_toggle optional
+
/set_punch_range
+
Uses edit range as punch range
+
/rec_enable_toggle
-
/toggle_all_rec_enables
-
(toggles all tracks' recording state)
+ +
/stop_forget
+
Stop transport and delete/forget last take

Master and Monitor strip control

/master/gain dB
-
where dB is a float ranging from -193 to +6 representing the desired gain of master in dB
+
See gain in strips
/master/fader position
-
where position is an int ranging from 0 to 1023 representing the fader control position
+
See fader in strips
/master/trimdB dB
-
where dB is a float ranging from -20 to +20 representing the desired trim for master in dB
+
see trimdb in strips
/master/pan_stereo_position position
-
where position is a float ranging from 0 to 1 representing the desired pan position for master
+
See pan_stereo_position in strips
/master/mute yn
-
where yn is a bool/int representing the desired mute state of the track
+
See mute in strips
/monitor/gain dB
-
where dB is a float ranging from -193 to 6 representing the desired gain of monitor in dB
+
See gain in strips
/monitor/fader position
-
where position is an int ranging from 0 to 1023 representing the fader control position
+
See fader in strips

Track specific operations

@@ -206,7 +309,7 @@ here"/>

SSID has a different meaning than RID in Ardour version 4.7 and before. Effectively, banking is always being used and the SSID is generated on - the fly. The SSID is the possition of the strip within bank as an int + the fly. The SSID is the position of the strip within bank as an int 1 to bank size. There are no gaps as there have been in the past. Depending on the value of strip_types sent to Ardour, Master and Monitor, may be included in the list of SSIDs or not as set in @@ -227,6 +330,10 @@ here"/>

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
@@ -236,16 +343,116 @@ here"/>
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 an int ranging from 0 to 1023 representing the fader control position.
-
/strip/trimabs ssid trim_abs
-
where trim_abs is a float ranging from 0.1 to 10 (-20dB to +20dB). (since 4.1)
/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/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/send/gainabs", ssid sendid send_gain
+
where sendid = nth_send, send_gain is a float + ranging from 0 to 1 representing the desired gain for the send (note this will likey be replaced by a positional control)
+
/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 1023 representing the desired position for the send as a fader
+ +

Selected Strip Operations

+

+ New for Ardour 5, A whole set of operations that work on the selected + or expanded strip. +

+

+ Selected strip operations are complex enough for their own page. + Please read: + Selection Considerations in OSC. This is most important if more + than one OSC surface is being used with Ardour. +

+

+ There are two kinds of selection in OSC. GUI selection and local + expansion. By default expansion follows selection. +

+

+ +
+
/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 int ranging from 0 to 1023 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 1023 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

Menu actions

@@ -256,22 +463,42 @@ here"/> /access_action action_name

The list below shows all available values of action-name as of - mid-February 2014 for Ardour 3.5. You can get the current list at any + June 2016 for Ardour 5.0.pre0.1. You can get the current list at any time by running Ardour with the -b flag.

Action Name
Menu Name
-
Common/Chat
Chat
-
Common/KeepTearoffs
Show Toolbars
-
Common/Manual
Manual
+ +
ProcessorMenu/ab_plugins
A/B Plugins
+
ProcessorMenu/activate_all
Activate All
+
ProcessorMenu/clear
Clear (all)
+
ProcessorMenu/clear_post
Clear (post-fader)
+
ProcessorMenu/clear_pre
Clear (pre-fader)
+
ProcessorMenu/controls
Controls
+
ProcessorMenu/copy
Copy
+
ProcessorMenu/cut
Cut
+
ProcessorMenu/deactivate_all
Deactivate All
+
ProcessorMenu/delete
Delete
+
ProcessorMenu/deselectall
Deselect All
+
ProcessorMenu/edit-generic
Edit with generic controls...
+
ProcessorMenu/edit
Edit...
+
ProcessorMenu/newaux
New Aux Send ...
+
ProcessorMenu/newinsert
New Insert
+
ProcessorMenu/newplugin
New Plugin
+
ProcessorMenu/newsend
New External Send ...
+
ProcessorMenu/paste
Paste
+
ProcessorMenu/rename
Rename
+
ProcessorMenu/selectall
Select All
+
ProcessorMenu/send_options
Send Options
+ +
Common/Hide
Common/NewMIDITracer
MIDI Tracer
Common/Quit
Quit
-
Common/Reference
Reference
Common/Save
Save
-
Common/toggle-editor-mixer
Toggle Editor+Mixer
-
Common/ToggleMaximalEditor
Maximise Editor Space
-
Common/toggle-meterbridge
Meterbridge
-
Common/toggle-mixer
Mixer
+
Common/ToggleMaximalEditor
Maximize Editor Space
+
Common/ToggleMaximalMixer
+
Common/ToggleMixerList
+
Common/ToggleMonitorSection
Common/ToggleRecordEnableTrack10
Toggle Record Enable Track 10
Common/ToggleRecordEnableTrack11
Toggle Record Enable Track 11
Common/ToggleRecordEnableTrack12
Toggle Record Enable Track 12
@@ -304,9 +531,197 @@ here"/>
Common/ToggleRecordEnableTrack7
Toggle Record Enable Track 7
Common/ToggleRecordEnableTrack8
Toggle Record Enable Track 8
Common/ToggleRecordEnableTrack9
Toggle Record Enable Track 9
-
Editor/addExistingAudioFiles
Import
-
Editor/addExternalAudioToRegionList
Import to Region List...
+
Common/attach-editor
+
Common/attach-mixer
+
Common/attach-preferences
+
Common/change-editor-visibility
+
Common/change-mixer-visibility
+
Common/change-preferences-visibility
+
Common/Chat
Chat
+
Common/cheat-sheet
+
Common/detach-editor
+
Common/detach-mixer
+
Common/detach-preferences
+
Common/forums
+
Common/hide-editor
+
Common/hide-mixer
+
Common/hide-preferences
+
Common/howto-report
+
Common/key-change-editor-visibility
+
Common/key-change-mixer-visibility
+
Common/key-change-preferences-visibility
+
Common/Manual
Manual
+
Common/menu-show-preferences
+
Common/next-tab
+
Common/previous-tab
+
Common/Reference
Reference
+
Common/show-editor
+
Common/show-mixer
+
Common/show-preferences
+
Common/toggle-editor-mixer
Toggle Editor+Mixer
+
Common/toggle-luawindow
+
Common/toggle-meterbridge
Meterbridge
+
Common/tracker
+
Common/website
+
Common/website-dev
+ +
MIDI/panic
Panic
+ +
Main/AddLuaScript
+
Main/AddTrackBus
Add Track or Bus...
+
Main/CleanupPeakFiles
+
Main/CleanupUnused
Clean-up Unused Sources...
+
Main/Close
Close
+
Main/CloseVideo
Remove Video
+
Main/EditMetadata
Edit Metadata...
+
Main/Escape
+
Main/ExportAudio
Export To Audio File(s)...
+
Main/Export
Export
+
Main/ExportVideo
Export To Video File
+
Main/FlushWastebasket
Flush Wastebasket
+
Main/ImportMetadata
Import Metadata...
+
Main/Metadata
Metadata
+
Main/New
New...
+
Main/Open
Open...
+
Main/OpenVideo
Open Video
+
Main/QuickSnapshotStay
+
Main/QuickSnapshotSwitch
+
Main/Recent
Recent...
+
Main/RemoveLuaScript
+
Main/Rename
Rename...
+
Main/SaveAs
Save As...
+
Main/SaveTemplate
Save Template...
+
Main/Scripting
+
Main/SnapshotStay
+
Main/SnapshotSwitch
+
Main/StemExport
Stem export...
+
Main/cancel-solo
+
Main/duplicate-routes
+ +
Main_menu/AudioFileFormatData
Sample Format
+
Main_menu/AudioFileFormatHeader
File Type
+
Main_menu/AudioFileFormat
Audio File Format
+
Main_menu/Cleanup
Clean-up
+
Main_menu/ControlSurfaces
Control Surfaces
+
Main_menu/Denormals
Denormal Handling
+
Main_menu/Help
Help
+
Main_menu/KeyMouseActions
Misc. Shortcuts
+
Main_menu/MeteringFallOffRate
Fall Off Rate
+
Main_menu/MeteringHoldTime
Hold Time
+
Main_menu/Metering
Metering
+
Main_menu/MixerMenu
+
Main_menu/Plugins
Plugins
+
Main_menu/PrefsMenu
+
Main_menu/Session
Session
+
Main_menu/Sync
Sync
+
Main_menu/TransportOptions
Options
+
Main_menu/WindowMenu
Window
+ +
options/SendMidiClock
Send MIDI Clock
+
options/SendMIDIfeedback
Send MIDI Feedback
+
options/SendMMC
Send MMC
+
options/SendMTC
Send MTC
+
options/UseMMC
Use MMC
+ +
Transport/ForwardFast
Forward (Fast)
+
Transport/Forward
Forward
+
Transport/ForwardSlow
Forward (Slow)
+
Transport/GotoEnd
Goto End
+
Transport/GotoStart
Goto Start
+
Transport/GotoWallClock
Goto Wall Clock
+
Transport/GotoZero
Goto Zero
+
Transport/Loop
Play Loop Range
+
Transport/PlayPreroll
Play Selection w/Preroll
+
Transport/PlaySelection
Play Selected Range
+
Transport/Record
Enable Record
+
Transport/RewindFast
Rewind (Fast)
+
Transport/Rewind
Rewind
+
Transport/RewindSlow
Rewind (Slow)
+
Transport/Roll
Roll
+
Transport/Stop
Stop
+
Transport/ToggleAutoInput
Auto Input
+
Transport/ToggleAutoPlay
Auto Play
+
Transport/ToggleAutoReturn
Auto Return
+
Transport/ToggleClick
Click
+
Transport/ToggleExternalSync
+
Transport/ToggleFollowEdits
Follow Edits
+
Transport/TogglePunchIn
Punch In
+
Transport/TogglePunch
Punch In/Out
+
Transport/TogglePunchOut
Punch Out
+
Transport/ToggleRollForgetCapture
Stop and Forget Capture
+
Transport/ToggleRoll
Start/Stop
+
Transport/ToggleRollMaybe
Start/Continue/Stop
+
Transport/ToggleTimeMaster
Time Master
+
Transport/ToggleVideoSync
Sync Startup to Video
+
Transport/TransitionToReverse
Transition To Reverse
+
Transport/TransitionToRoll
Transition To Roll
+
Transport/Transport
Transport
+
Transport/alternate-GotoStart
+
Transport/alternate-ToggleRoll
+
Transport/alternate-numpad-decimal
+
Transport/alternate-record-roll
+
Transport/focus-on-clock
Focus On Clock
+
Transport/numpad-0
+
Transport/numpad-1
+
Transport/numpad-2
+
Transport/numpad-3
+
Transport/numpad-4
+
Transport/numpad-5
+
Transport/numpad-6
+
Transport/numpad-7
+
Transport/numpad-8
+
Transport/numpad-9
+
Transport/numpad-decimal
+
Transport/primary-clock-bbt
Bars & Beats
+
Transport/primary-clock-minsec
Minutes & Seconds
+
Transport/primary-clock-samples
Samples
+
Transport/primary-clock-timecode
Timecode
+
Transport/record-roll
Start Recording
+
Transport/secondary-clock-bbt
Bars & Beats
+
Transport/secondary-clock-minsec
Minutes & Seconds
+
Transport/secondary-clock-samples
Samples
+
Transport/secondary-clock-timecode
Timecode
+ +
Window/toggle-about
About
+
Window/toggle-add-routes
Add Tracks/Busses
+
Window/toggle-add-video
Add Tracks/Busses
+
Window/toggle-audio-connection-manager
Audio Connections
+
Window/toggle-audio-midi-setup
Audio/MIDI Setup
+
Window/toggle-big-clock
Big Clock
+
Window/toggle-bundle-manager
Bundle Manager
+
Window/toggle-inspector
Tracks and Busses
+
Window/toggle-key-editor
Key Bindings
+
Window/toggle-locations
Locations
+
Window/toggle-midi-connection-manager
MIDI Connections
+
Window/toggle-script-manager
+
Window/toggle-session-options-editor
Properties
+
Window/toggle-speaker-config
Speaker Configuration
+
Window/toggle-video-export
+ +
Editor/SnapMode
Snap Mode
+
Editor/SnapTo
Snap to
+
Editor/ToggleGroupTabs
Show Group Tabs
+
Editor/ToggleJadeo
Video Monitor
+
Editor/ToggleMeasureVisibility
Show Measures
+
Editor/ToggleSummary
Show Summary
Editor/add-location-from-playhead
Add Mark from Playhead
+
Editor/addExistingAudioFiles
Import
+
Editor/addExistingPTFiles
+
Editor/addExternalAudioToRegionList
Import to Region List...
+
Editor/alt-finish-range
+
Editor/alt-start-range
+
Editor/alternate-add-location-from-playhead
+
Editor/alternate-alternate-redo
+
Editor/alternate-editor-delete
+
Editor/alternate-jump-backward-to-mark
+
Editor/alternate-jump-forward-to-mark
+
Editor/alternate-redo
+
Editor/alternate-remove-location-from-playhead
+
Editor/alternate-select-all-after-edit-cursor
+
Editor/alternate-select-all-before-edit-cursor
+
Editor/alternate-tab-to-transient-backwards
+
Editor/alternate-tab-to-transient-forwards
+
Editor/bring-into-session
Editor/center-edit-cursor
Center Edit Point
Editor/center-playhead
Center Playhead
Editor/crop
Crop
@@ -327,20 +742,28 @@ here"/>
Editor/edit-cursor-to-previous-region-sync
To Previous Region Sync
Editor/edit-cursor-to-range-end
To Range End
Editor/edit-cursor-to-range-start
To Range Start
+
Editor/edit-to-playhead
Active Mark to Playhead
Editor/editor-copy
Copy
Editor/editor-crop
Crop
Editor/editor-cut
Cut
Editor/editor-delete
Delete
+
Editor/editor-fade-range
Editor/editor-paste
Paste
Editor/editor-separate
Separate
-
Editor/edit-to-playhead
Active Mark to Playhead
-
Editor/escape
Break drag or deselect all
Editor/expand-tracks
Expand Track Height
Editor/export-audio
Export Audio
Editor/export-range
Export Range
-
Editor/finish-add-range
Finish Add Range
+
Editor/finish-loop-range
+
Editor/finish-punch-range
Editor/finish-range
Finish Range
-
Editor/fit-tracks
Fit Selected Tracks
+
Editor/fit-selection
Fit Selected Tracks
+
Editor/fit_16_tracks
+
Editor/fit_1_track
+
Editor/fit_2_tracks
+
Editor/fit_32_tracks
+
Editor/fit_4_tracks
+
Editor/fit_8_tracks
+
Editor/fit_all_tracks
Editor/goto-mark-1
Locate to Mark 1
Editor/goto-mark-2
Locate to Mark 2
Editor/goto-mark-3
Locate to Mark 3
@@ -367,7 +790,161 @@ here"/>
Editor/invert-selection
Invert Selection
Editor/jump-backward-to-mark
Jump to Previous Mark
Editor/jump-forward-to-mark
Jump to Next Mark
+
Editor/lock
Editor/main-menu-play-selected-regions
Play Selected Regions
+
Editor/move-range-end-to-next-region-boundary
Move Range End to Next Region Boundary
+
Editor/move-range-end-to-previous-region-boundary
Move Range End to Previous Region Boundary
+
Editor/move-range-start-to-next-region-boundary
Move Range Start to Next Region Boundary
+
Editor/move-range-start-to-previous-region-boundary
Move Range Start to Previous Region Boundary
+
Editor/move-selected-tracks-down
Move Selected Tracks Down
+
Editor/move-selected-tracks-up
Move Selected Tracks Up
+
Editor/next-snap-choice
Next Snap Choice
+
Editor/next-snap-choice-music-only
Next Musical Snap Choice
+
Editor/nudge-next-backward
Nudge Next Earlier
+
Editor/nudge-next-forward
Nudge Next Later
+
Editor/nudge-playhead-backward
Nudge Playhead Backward
+
Editor/nudge-playhead-forward
Nudge Playhead Forward
+
Editor/play-edit-range
Play Edit Range
+
Editor/play-from-edit-point-and-return
Play from Edit Point and Return
+
Editor/play-from-edit-point
Play From Edit Point
+
Editor/playhead-backward-to-grid
Playhead To Previous Grid
+
Editor/playhead-forward-to-grid
Playhead To Next Grid
+
Editor/playhead-to-edit
Playhead to Active Mark
+
Editor/playhead-to-next-region-boundary
Playhead to Next Region Boundary
+
Editor/playhead-to-next-region-boundary-noselection
Playhead to Next Region Boundary (No Track Selection)
+
Editor/playhead-to-next-region-end
Playhead to Next Region End
+
Editor/playhead-to-next-region-start
Playhead to Next Region Start
+
Editor/playhead-to-next-region-sync
Playhead to Next Region Sync
+
Editor/playhead-to-previous-region-boundary
Playhead to Previous Region Boundary
+
Editor/playhead-to-previous-region-boundary-noselection
Playhead to Previous Region Boundary (No Track Selection)
+
Editor/playhead-to-previous-region-end
Playhead to Previous Region End
+
Editor/playhead-to-previous-region-start
Playhead to Previous Region Start
+
Editor/playhead-to-previous-region-sync
Playhead to Previous Region Sync
+
Editor/playhead-to-range-end
Playhead to Range End
+
Editor/playhead-to-range-start
Playhead to Range Start
+
Editor/prev-snap-choice
Previous Snap Choice
+
Editor/prev-snap-choice-music-only
Previous Musical Snap Choice
+
Editor/redo
Redo
+
Editor/redo-last-selection-op
+
Editor/remove-last-capture
Remove Last Capture
+
Editor/remove-location-from-playhead
+
Editor/remove-time
+
Editor/remove-track
Remove
+
Editor/save-visual-state-10
Save View 10
+
Editor/save-visual-state-11
Save View 11
+
Editor/save-visual-state-12
Save View 12
+
Editor/save-visual-state-1
Save View 1
+
Editor/save-visual-state-2
Save View 2
+
Editor/save-visual-state-3
Save View 3
+
Editor/save-visual-state-4
Save View 4
+
Editor/save-visual-state-5
Save View 5
+
Editor/save-visual-state-6
Save View 6
+
Editor/save-visual-state-7
Save View 7
+
Editor/save-visual-state-8
Save View 8
+
Editor/save-visual-state-9
Save View 9
+
Editor/script-action-1
+
Editor/script-action-2
+
Editor/script-action-3
+
Editor/script-action-4
+
Editor/script-action-5
+
Editor/script-action-6
+
Editor/script-action-7
+
Editor/script-action-8
+
Editor/script-action-9
+
Editor/scroll-backward
Scroll Backward
+
Editor/scroll-forward
Scroll Forward
+
Editor/scroll-playhead-backward
Playhead Backward
+
Editor/scroll-playhead-forward
Playhead Forward
+
Editor/scroll-tracks-down
Scroll Tracks Down
+
Editor/scroll-tracks-up
Scroll Tracks Up
+
Editor/select-all-after-edit-cursor
Select All After Edit Point
+
Editor/select-all-before-edit-cursor
Select All Before Edit Point
+
Editor/select-all-between-cursors
Select All Overlapping Edit Range
+
Editor/select-all-in-loop-range
Select All in Loop Range
+
Editor/select-all-in-punch-range
Select All in Punch Range
+
Editor/select-all-objects => Ctrl+A
+
Editor/select-all-tracks => Ctrl+T
+
Editor/select-all-within-cursors
Select All Inside Edit Range
+
Editor/select-from-regions
+
Editor/select-loop-range
+
Editor/select-next-route
Select Next Track or Bus
+
Editor/select-prev-route
Select Previous Track or Bus
+
Editor/select-punch-range
+
Editor/select-range-between-cursors
+
Editor/selected-marker-to-next-region-boundary
To Next Region Boundary
+
Editor/selected-marker-to-next-region-boundary-noselection
To Next Region Boundary (No Track Selection)
+
Editor/selected-marker-to-previous-region-boundary
To Previous Region Boundary
+
Editor/selected-marker-to-previous-region-boundary-noselection
To Previous Region Boundary (No Track Selection)
+
Editor/select-range-between-cursors
Select Edit Range
+
Editor/separate-from-loop
Separate Using Loop Range
+
Editor/separate-from-punch
Separate Using Punch Range
+
Editor/set-edit-lock
Lock
+
Editor/set-edit-point
Active Marker to Mouse
+
Editor/set-edit-ripple
+
Editor/set-edit-slide
Slide
+
Editor/set-loop-from-edit-range
Set Loop from Edit Range
+
Editor/set-playhead
Playhead to Mouse
+
Editor/set-punch-from-edit-range
Set Punch from Edit Range
+
Editor/set-session-end-from-playhead
+
Editor/set-session-from-edit-range
+
Editor/set-session-start-from-playhead
+
Editor/set-tempo-from-edit-range
Set Tempo from Edit Range = Bar
+
Editor/show-editor-list
Show Editor List
+
Editor/show-editor-mixer
Show Editor Mixer
+
Editor/show-marker-lines
Show Marker Lines
+
Editor/shrink-tracks
Shrink Track Height
+
Editor/snap-magnetic
Magnetic
+
Editor/snap-normal
Grid
+
Editor/snap-off
No Grid
+
Editor/sound-midi-notes
Sound Selected MIDI Notes
+
Editor/start-loop-range
+
Editor/start-punch-range
+
Editor/start-range
Start Range
+
Editor/start-range-from-playhead
+
Editor/step-mouse-mode
Step Mouse Mode
+
Editor/step-tracks-down
Step Tracks Down
+
Editor/step-tracks-up
Step Tracks Up
+
Editor/tab-to-transient-backwards
Move Earlier to Transient
+
Editor/tab-to-transient-forwards
Move Later to Transient
+
Editor/temporal-zoom-in
Zoom In
+
Editor/temporal-zoom-out
Zoom Out
+
Editor/toggle-edit-mode
Toggle Edit Mode
+
Editor/toggle-follow-playhead
Follow Playhead
+
Editor/toggle-log-window
Log
+
Editor/toggle-midi-input-active
Toggle MIDI Input Active for Editor-Selected Tracks/Busses
+
Editor/toggle-skip-playback
+
Editor/toggle-stationary-playhead
Stationary Playhead
+
Editor/toggle-track-active
Toggle Active
+
Editor/toggle-vmon-frame
Frame number
+
Editor/toggle-vmon-fullscreen
Fullscreen
+
Editor/toggle-vmon-letterbox
Letterbox
+
Editor/toggle-vmon-ontop
Always on Top
+
Editor/toggle-vmon-osdbg
Timecode Background
+
Editor/toggle-vmon-timecode
Timecode
+
Editor/toggle-zoom
Toggle Zoom State
+
Editor/track-height-large
Large
+
Editor/track-height-larger
Larger
+
Editor/track-height-largest
Largest
+
Editor/track-height-normal
Normal
+
Editor/track-height-small
Small
+
Editor/track-mute-toggle
Toggle Mute
+
Editor/track-record-enable-toggle
Toggle Record Enable
+
Editor/track-solo-isolate-toggle
Toggle Solo Isolate
+
Editor/track-solo-toggle
Toggle Solo
+
Editor/undo
Undo
+
Editor/undo-last-selection-op
+
Editor/zoom-to-selection
+
Editor/zoom-to-session
Zoom to Session
+
Editor/zoom-vmon-100
Original Size
+
Editor/zoom_100_ms
+
Editor/zoom_10_min
+
Editor/zoom_10_ms
+
Editor/zoom_10_sec
+
Editor/zoom_1_min
+
Editor/zoom_1_sec
+
Editor/zoom_5_min
+ +
EditorMenu/ActionScripts
EditorMenu/AlignMenu
Align
EditorMenu/Autoconnect
Autoconnect
EditorMenu/Crossfades
Crossfades
@@ -380,10 +957,10 @@ here"/>
EditorMenu/LatchMenu
Latch
EditorMenu/Link
Link
EditorMenu/LocateToMarker
Locate to Markers
+
EditorMenu/MIDI
MIDI Options
EditorMenu/MarkerMenu
Markers
EditorMenu/MeterFalloff
Meter falloff
EditorMenu/MeterHold
Meter hold
-
EditorMenu/MIDI
MIDI Options
EditorMenu/MiscOptions
Misc Options
EditorMenu/Monitoring
Monitoring
EditorMenu/MoveActiveMarkMenu
Active Mark
@@ -425,205 +1002,16 @@ here"/>
EditorMenu/ZoomFocus
Zoom Focus
EditorMenu/ZoomFocusMenu
Zoom Focus
EditorMenu/ZoomMenu
Zoom
-
Editor/move-range-end-to-next-region-boundary
Move Range End to Next Region Boundary
-
Editor/move-range-end-to-previous-region-boundary
Move Range End to Previous Region Boundary
-
Editor/move-range-start-to-next-region-boundary
Move Range Start to Next Region Boundary
-
Editor/move-range-start-to-previous-region-boundary
Move Range Start to Previous Region Boundary
-
Editor/move-selected-tracks-down
Move Selected Tracks Down
-
Editor/move-selected-tracks-up
Move Selected Tracks Up
-
Editor/next-snap-choice
Next Snap Choice
-
Editor/next-snap-choice-music-only
Next Musical Snap Choice
-
Editor/nudge-next-backward
Nudge Next Earlier
-
Editor/nudge-next-forward
Nudge Next Later
-
Editor/nudge-playhead-backward
Nudge Playhead Backward
-
Editor/nudge-playhead-forward
Nudge Playhead Forward
-
Editor/play-edit-range
Play Edit Range
-
Editor/play-from-edit-point-and-return
Play from Edit Point and Return
-
Editor/play-from-edit-point
Play From Edit Point
-
Editor/playhead-backward-to-grid
Playhead To Previous Grid
-
Editor/playhead-forward-to-grid
Playhead To Next Grid
-
Editor/playhead-to-edit
Playhead to Active Mark
-
Editor/playhead-to-next-region-boundary
Playhead to Next Region Boundary
-
Editor/playhead-to-next-region-boundary-noselection
Playhead to Next Region Boundary (No Track Selection)
-
Editor/playhead-to-next-region-end
Playhead to Next Region End
-
Editor/playhead-to-next-region-start
Playhead to Next Region Start
-
Editor/playhead-to-next-region-sync
Playhead to Next Region Sync
-
Editor/playhead-to-previous-region-boundary
Playhead to Previous Region Boundary
-
Editor/playhead-to-previous-region-boundary-noselection
Playhead to Previous Region Boundary (No Track Selection)
-
Editor/playhead-to-previous-region-end
Playhead to Previous Region End
-
Editor/playhead-to-previous-region-start
Playhead to Previous Region Start
-
Editor/playhead-to-previous-region-sync
Playhead to Previous Region Sync
-
Editor/playhead-to-range-end
Playhead to Range End
-
Editor/playhead-to-range-start
Playhead to Range Start
-
Editor/prev-snap-choice
Previous Snap Choice
-
Editor/prev-snap-choice-music-only
Previous Musical Snap Choice
-
Editor/redo
Redo
-
Editor/remove-last-capture
Remove Last Capture
-
Editor/remove-track
Remove
-
Editor/save-visual-state-10
Save View 10
-
Editor/save-visual-state-11
Save View 11
-
Editor/save-visual-state-12
Save View 12
-
Editor/save-visual-state-1
Save View 1
-
Editor/save-visual-state-2
Save View 2
-
Editor/save-visual-state-3
Save View 3
-
Editor/save-visual-state-4
Save View 4
-
Editor/save-visual-state-5
Save View 5
-
Editor/save-visual-state-6
Save View 6
-
Editor/save-visual-state-7
Save View 7
-
Editor/save-visual-state-8
Save View 8
-
Editor/save-visual-state-9
Save View 9
-
Editor/scroll-backward
Scroll Backward
-
Editor/scroll-forward
Scroll Forward
-
Editor/scroll-playhead-backward
Playhead Backward
-
Editor/scroll-playhead-forward
Playhead Forward
-
Editor/scroll-tracks-down
Scroll Tracks Down
-
Editor/scroll-tracks-up
Scroll Tracks Up
-
Editor/select-all-after-edit-cursor
Select All After Edit Point
-
Editor/select-all-before-edit-cursor
Select All Before Edit Point
-
Editor/select-all-between-cursors
Select All Overlapping Edit Range
-
Editor/select-all-in-loop-range
Select All in Loop Range
-
Editor/select-all-in-punch-range
Select All in Punch Range
-
Editor/select-all
Select All
-
Editor/select-all-within-cursors
Select All Inside Edit Range
-
Editor/selected-marker-to-next-region-boundary
To Next Region Boundary
-
Editor/selected-marker-to-next-region-boundary-noselection
To Next Region Boundary (No Track Selection)
-
Editor/selected-marker-to-previous-region-boundary
To Previous Region Boundary
-
Editor/selected-marker-to-previous-region-boundary-noselection
To Previous Region Boundary (No Track Selection)
-
Editor/select-next-route
Select Next Track or Bus
-
Editor/select-prev-route
Select Previous Track or Bus
-
Editor/select-range-between-cursors
Select Edit Range
-
Editor/separate-from-loop
Separate Using Loop Range
-
Editor/separate-from-punch
Separate Using Punch Range
-
Editor/set-edit-lock
Lock
-
Editor/set-edit-point
Active Marker to Mouse
-
Editor/set-edit-slide
Slide
-
Editor/set-edit-splice
Splice
-
Editor/set-loop-from-edit-range
Set Loop from Edit Range
-
Editor/set-playhead
Playhead to Mouse
-
Editor/set-punch-from-edit-range
Set Punch from Edit Range
-
Editor/set-tempo-from-edit-range
Set Tempo from Edit Range = Bar
-
Editor/show-editor-list
Show Editor List
-
Editor/show-editor-mixer
Show Editor Mixer
-
Editor/show-marker-lines
Show Marker Lines
-
Editor/shrink-tracks
Shrink Track Height
-
Editor/snap-magnetic
Magnetic
-
Editor/SnapMode
Snap Mode
-
Editor/snap-normal
Grid
-
Editor/snap-off
No Grid
-
Editor/SnapTo
Snap to
-
Editor/sound-midi-notes
Sound Selected MIDI Notes
-
Editor/start-range
Start Range
-
Editor/step-mouse-mode
Step Mouse Mode
-
Editor/step-tracks-down
Step Tracks Down
-
Editor/step-tracks-up
Step Tracks Up
-
Editor/tab-to-transient-backwards
Move Earlier to Transient
-
Editor/tab-to-transient-forwards
Move Later to Transient
-
Editor/temporal-zoom-in
Zoom In
-
Editor/temporal-zoom-out
Zoom Out
-
Editor/toggle-edit-mode
Toggle Edit Mode
-
Editor/toggle-follow-playhead
Follow Playhead
-
Editor/ToggleGroupTabs
Show Group Tabs
-
Editor/ToggleJadeo
Video Monitor
-
Editor/ToggleLogoVisibility
Show Logo
-
Editor/toggle-log-window
Log
-
Editor/ToggleMeasureVisibility
Show Measures
-
Editor/toggle-midi-input-active
Toggle MIDI Input Active for Editor-Selected Tracks/Busses
-
Editor/toggle-stationary-playhead
Stationary Playhead
-
Editor/ToggleSummary
Show Summary
-
Editor/toggle-track-active
Toggle Active
-
Editor/toggle-vmon-frame
Frame number
-
Editor/toggle-vmon-fullscreen
Fullscreen
-
Editor/toggle-vmon-letterbox
Letterbox
-
Editor/toggle-vmon-ontop
Always on Top
-
Editor/toggle-vmon-osdbg
Timecode Background
-
Editor/toggle-vmon-timecode
Timecode
-
Editor/toggle-zoom
Toggle Zoom State
-
Editor/track-height-large
Large
-
Editor/track-height-larger
Larger
-
Editor/track-height-largest
Largest
-
Editor/track-height-normal
Normal
-
Editor/track-height-small
Small
-
Editor/track-mute-toggle
Toggle Mute
-
Editor/track-record-enable-toggle
Toggle Record Enable
-
Editor/track-solo-isolate-toggle
Toggle Solo Isolate
-
Editor/track-solo-toggle
Toggle Solo
-
Editor/undo
Undo
-
Editor/zoom-to-region-both-axes
Zoom to Region (Width and Height)
-
Editor/zoom-to-region
Zoom to Region
-
Editor/zoom-to-session
Zoom to Session
-
Editor/zoom-vmon-100
Original Size
-
Main/AddTrackBus
Add Track or Bus...
-
Main/CleanupUnused
Clean-up Unused Sources...
-
Main/Close
Close
-
Main/CloseVideo
Remove Video
-
Main/EditMetadata
Edit Metadata...
-
Main/ExportAudio
Export To Audio File(s)...
-
Main/Export
Export
-
Main/ExportVideo
Export To Video File
-
Main/FlushWastebasket
Flush Wastebasket
-
Main/ImportMetadata
Import Metadata...
-
Main_menu/AudioFileFormatData
Sample Format
-
Main_menu/AudioFileFormatHeader
File Type
-
Main_menu/AudioFileFormat
Audio File Format
-
Main_menu/Cleanup
Clean-up
-
Main_menu/ControlSurfaces
Control Surfaces
-
Main_menu/Denormals
Denormal Handling
-
Main_menu/Help
Help
-
Main_menu/KeyMouseActions
Misc. Shortcuts
-
Main_menu/MeteringFallOffRate
Fall Off Rate
-
Main_menu/MeteringHoldTime
Hold Time
-
Main_menu/Metering
Metering
-
Main_menu/Plugins
Plugins
-
Main_menu/Session
Session
-
Main_menu/Sync
Sync
-
Main_menu/TransportOptions
Options
-
Main_menu/WindowMenu
Window
-
Main/Metadata
Metadata
-
Main/New
New...
-
Main/Open
Open...
-
Main/OpenVideo
Open Video
-
Main/Recent
Recent...
-
Main/Rename
Rename...
-
Main/SaveAs
Save As...
-
Main/SaveTemplate
Save Template...
-
Main/Snapshot
Snapshot...
-
Main/StemExport
Stem export...
-
MIDI/panic
Panic
+
MouseMode/set-mouse-mode-audition
Audition Tool
+
MouseMode/set-mouse-mode-content
+
MouseMode/set-mouse-mode-cut
MouseMode/set-mouse-mode-draw
Note Drawing Tool
-
MouseMode/set-mouse-mode-gain
Gain Tool
MouseMode/set-mouse-mode-object
Object Tool
MouseMode/set-mouse-mode-object-range
Smart Object Mode
MouseMode/set-mouse-mode-range
Range Tool
MouseMode/set-mouse-mode-timefx
Time FX Tool
-
MouseMode/set-mouse-mode-zoom
Zoom Tool
-
MouseMode/toggle-internal-edit
Edit MIDI
-
options/SendMidiClock
Send MIDI Clock
-
options/SendMIDIfeedback
Send MIDI Feedback
-
options/SendMMC
Send MMC
-
options/SendMTC
Send MTC
-
options/UseMMC
Use MMC
-
ProcessorMenu/ab_plugins
A/B Plugins
-
ProcessorMenu/activate_all
Activate All
-
ProcessorMenu/clear
Clear (all)
-
ProcessorMenu/clear_post
Clear (post-fader)
-
ProcessorMenu/clear_pre
Clear (pre-fader)
-
ProcessorMenu/controls
Controls
-
ProcessorMenu/copy
Copy
-
ProcessorMenu/cut
Cut
-
ProcessorMenu/deactivate_all
Deactivate All
-
ProcessorMenu/delete
Delete
-
ProcessorMenu/deselectall
Deselect All
-
ProcessorMenu/edit-generic
Edit with generic controls...
-
ProcessorMenu/edit
Edit...
-
ProcessorMenu/newaux
New Aux Send ...
-
ProcessorMenu/newinsert
New Insert
-
ProcessorMenu/newplugin
New Plugin
-
ProcessorMenu/newsend
New External Send ...
-
ProcessorMenu/paste
Paste
-
ProcessorMenu/rename
Rename
-
ProcessorMenu/selectall
Select All
-
ProcessorMenu/send_options
Send Options
+
Region/add-range-marker-from-region
Add Single Range Marker
Region/add-range-markers-from-region
Add Range Marker Per Region
Region/align-regions-end
Align End
@@ -632,7 +1020,10 @@ here"/>
Region/align-regions-start-relative
Align Start Relative
Region/align-regions-sync
Align Sync
Region/align-regions-sync-relative
Align Sync Relative
-
Region/analyze-region
Spectral Analysis...
+
/Region/alternate-nudge-backward
+
/Region/alternate-nudge-forward
+
/Region/alternate-set-fade-in-length
+
/Region/alternate-set-fade-out-length
Region/boost-region-gain
Boost Gain
Region/bounce-regions-processed
Bounce (without processing)
Region/bounce-regions-unprocessed
Bounce (with processing)
@@ -647,26 +1038,9 @@ here"/>
Region/insert-patch-change-context
Insert Patch Change...
Region/insert-patch-change
Insert Patch Change...
Region/insert-region-from-region-list
Insert Region From Region List
-
RegionList/RegionListSort
Sort
-
RegionList/removeUnusedRegions
Remove Unused
-
RegionList/rlAudition
Audition
-
RegionList/rlHide
Hide
-
RegionList/rlShowAll
Show All
-
RegionList/rlShowAuto
Show Automatic Regions
-
RegionList/rlShow
Show
-
RegionList/SortAscending
Ascending
-
RegionList/SortByRegionEndinFile
By Region End in File
-
RegionList/SortByRegionLength
By Region Length
-
RegionList/SortByRegionName
By Region Name
-
RegionList/SortByRegionPosition
By Region Position
-
RegionList/SortByRegionStartinFile
By Region Start in File
-
RegionList/SortByRegionTimestamp
By Region Timestamp
-
RegionList/SortBySourceFileCreationDate
By Source File Creation Date
-
RegionList/SortBySourceFileLength
By Source File Length
-
RegionList/SortBySourceFileName
By Source File Name
-
RegionList/SortBySourceFilesystem
By Source Filesystem
-
RegionList/SortDescending
Descending
+
/Region/legatize-region
Region/loop-region
Loop
+
Region/loudness-analyze-region
Region/lower-region
Lower
Region/lower-region-to-bottom
Lower to Bottom
Region/multi-duplicate-region
Multi-Duplicate...
@@ -690,6 +1064,7 @@ here"/>
Region/reset-region-scale-amplitude
Reset Gain
Region/reverse-region
Reverse
Region/separate-under-region
Separate Under
+
Region/sequence-regions
Region/set-fade-in-length
Set Fade In Length
Region/set-fade-out-length
Set Fade Out Length
Region/set-loop-from-region
Set Loop Range
@@ -714,6 +1089,7 @@ here"/>
Region/toggle-region-lock-style
Glue to Bars and Beats
Region/toggle-region-mute
Mute
Region/toggle-region-video-lock
Lock to Video
+
Region/transform-region
Region/transpose-region
Transpose...
Region/trim-back
Trim End at Edit Point
Region/trim-front
Trim Start at Edit Point
@@ -722,6 +1098,27 @@ here"/>
Region/trim-to-next-region
Trim to Next
Region/trim-to-previous-region
Trim to Previous
Region/uncombine-regions
Uncombine
+ +
RegionList/RegionListSort
Sort
+
RegionList/SortAscending
Ascending
+
RegionList/SortByRegionEndinFile
By Region End in File
+
RegionList/SortByRegionLength
By Region Length
+
RegionList/SortByRegionName
By Region Name
+
RegionList/SortByRegionPosition
By Region Position
+
RegionList/SortByRegionStartinFile
By Region Start in File
+
RegionList/SortByRegionTimestamp
By Region Timestamp
+
RegionList/SortBySourceFileCreationDate
By Source File Creation Date
+
RegionList/SortBySourceFileLength
By Source File Length
+
RegionList/SortBySourceFileName
By Source File Name
+
RegionList/SortBySourceFilesystem
By Source Filesystem
+
RegionList/SortDescending
Descending
+
RegionList/removeUnusedRegions
Remove Unused
+
RegionList/rlAudition
Audition
+
RegionList/rlHide
Hide
+
RegionList/rlShow
Show
+
RegionList/rlShowAll
Show All
+
RegionList/rlShowAuto
Show Automatic Regions
+
Rulers/toggle-bbt-ruler
Bars & Beats
Rulers/toggle-cd-marker-ruler
CD Markers
Rulers/toggle-loop-punch-ruler
Loop/Punch
@@ -733,8 +1130,10 @@ here"/>
Rulers/toggle-tempo-ruler
Tempo
Rulers/toggle-timecode-ruler
Timecode
Rulers/toggle-video-ruler
Video
+ +
Snap/snap-to-asixteenthbeat
Snap to Sixteenths
Snap/snap-to-bar
Snap to Bar
Snap/snap-to-beat
Snap to Beat
@@ -765,70 +1164,31 @@ here"/>
Snap/snap-to-twentieths
Snap to Twentieths
Snap/snap-to-twentyeighths
Snap to Twenty Eighths
Snap/snap-to-twentyfourths
Snap to Twenty Fourths
-
Transport/focus-on-clock
Focus On Clock
-
Transport/ForwardFast
Forward (Fast)
-
Transport/Forward
Forward
-
Transport/ForwardSlow
Forward (Slow)
-
Transport/GotoEnd
Goto End
-
Transport/GotoStart
Goto Start
-
Transport/GotoWallClock
Goto Wall Clock
-
Transport/GotoZero
Goto Zero
-
Transport/Loop
Play Loop Range
-
Transport/PlayPreroll
Play Selection w/Preroll
-
Transport/PlaySelection
Play Selected Range
-
Transport/primary-clock-bbt
Bars & Beats
-
Transport/primary-clock-minsec
Minutes & Seconds
-
Transport/primary-clock-samples
Samples
-
Transport/primary-clock-timecode
Timecode
-
Transport/Record
Enable Record
-
Transport/record-roll
Start Recording
-
Transport/RewindFast
Rewind (Fast)
-
Transport/Rewind
Rewind
-
Transport/RewindSlow
Rewind (Slow)
-
Transport/Roll
Roll
-
Transport/secondary-clock-bbt
Bars & Beats
-
Transport/secondary-clock-minsec
Minutes & Seconds
-
Transport/secondary-clock-samples
Samples
-
Transport/secondary-clock-timecode
Timecode
-
Transport/Stop
Stop
-
Transport/ToggleAutoInput
Auto Input
-
Transport/ToggleAutoPlay
Auto Play
-
Transport/ToggleAutoReturn
Auto Return
-
Transport/ToggleClick
Click
-
Transport/ToggleExternalSync
-
Transport/ToggleFollowEdits
Follow Edits
-
Transport/TogglePunchIn
Punch In
-
Transport/TogglePunch
Punch In/Out
-
Transport/TogglePunchOut
Punch Out
-
Transport/ToggleRollForgetCapture
Stop and Forget Capture
-
Transport/ToggleRoll
Start/Stop
-
Transport/ToggleRollMaybe
Start/Continue/Stop
-
Transport/ToggleTimeMaster
Time Master
-
Transport/ToggleVideoSync
Sync Startup to Video
-
Transport/TransitionToReverse
Transition To Reverse
-
Transport/TransitionToRoll
Transition To Roll
-
Transport/Transport
Transport
-
Window/toggle-about
About
-
Window/toggle-add-routes
Add Tracks/Busses
-
Window/toggle-add-video
Add Tracks/Busses
-
Window/toggle-audio-connection-manager
Audio Connections
-
Window/toggle-audio-midi-setup
Audio/MIDI Setup
-
Window/toggle-big-clock
Big Clock
-
Window/toggle-bundle-manager
Bundle Manager
-
Window/toggle-inspector
Tracks and Busses
-
Window/toggle-key-editor
Key Bindings
-
Window/toggle-locations
Locations
-
Window/toggle-midi-connection-manager
MIDI Connections
-
Window/toggle-rc-options-editor
Preferences
-
Window/toggle-session-options-editor
Properties
-
Window/toggle-speaker-config
Speaker Configuration
-
Window/toggle-theme-manager
Theme Manager
+
Zoom/zoom-focus-center
Zoom Focus Center
Zoom/zoom-focus-edit
Zoom Focus Edit Point
Zoom/zoom-focus-left
Zoom Focus Left
Zoom/zoom-focus-mouse
Zoom Focus Mouse
Zoom/zoom-focus-playhead
Zoom Focus Playhead
Zoom/zoom-focus-right
Zoom Focus Right
+ +
/Mixer/ab-plugins
+
/Mixer/copy-processors
+
/Mixer/cut-processors
+
/Mixer/decrement-gain
+
/Mixer/delete-processors
+
/Mixer/increment-gain
+
/Mixer/mute
+
/Mixer/paste-processors
+
/Mixer/recenable
+
/Mixer/scroll-left
+
/Mixer/scroll-right
+
/Mixer/select-all-processors
+
/Mixer/select-none
+
/Mixer/solo
+
/Mixer/toggle-midi-input-active
+
/Mixer/toggle-processors
+
/Mixer/unity-gain
{% children %} diff --git a/_manual/22_using-control-surfaces/01_controlling-ardour-with-osc/02_feedback-in-osc.html b/_manual/22_using-control-surfaces/01_controlling-ardour-with-osc/02_feedback-in-osc.html index 24b4ac5a..a65cbb93 100644 --- a/_manual/22_using-control-surfaces/01_controlling-ardour-with-osc/02_feedback-in-osc.html +++ b/_manual/22_using-control-surfaces/01_controlling-ardour-with-osc/02_feedback-in-osc.html @@ -43,7 +43,15 @@ title: OSC Feedback With Ardour
/transport_stop state
where state is an int/bool indicating if the transport is stopped or not.
- +

+ With feedback turned on, OSC control commands that try to change a + control that does not exist will get feedback that resets that control + to off. For example, sending a /strip/recenable to a buss will not work + and Ardour will try to turn the controller LED off in that case. Also + note that Pan operation may be limited by pan width in some cases. + That is with pan width at 100% (or -100%) there is no pan position + movement available. +

List of OSC feedback messages

Feedback only

@@ -55,7 +63,7 @@ title: OSC Feedback With Ardour

See strip section below for info about ssid and wrapping it into the - path. + path. Also /master and /monitor support what the /strip does.

/strip/name ssid track_name
@@ -66,30 +74,36 @@ title: OSC Feedback With Ardour
where meter is a value repesenting the current audio level. (the exact math used is determined by the feedback bits set)
/strip/signal ssid signal
-
where signal is a float indicating the instantainious +
where signal is a float indicating the instantaneous audio level is -40dB or higher.
-
/timecode time
-
where time is a string with the current play head time.
-
/bar_beat beat
+
/position/smpte time
+
where time is a string with the current play head time. Seconds as per smpte.
+
/position/bbt beat
where beat is a string with the current play head bar/beat.
+
/position/time time
+
where time is a string with the current play head time. Seconds are in milliseconds
+
/position/samples samples
+
where samples is a string with the current play head position in samples.
/heartbeat LED
where LED is a float that cycles 1/0 at 1 second intervals.
/record_tally state
-
Some record enable is true or "ready to record"
+
Some record enable is true or "ready to record". For a "Recording" sign at studio door.

Transport Control

/transport_stop state
-
+
state is true when transport is stopped
/transport_play state
-
+
state is true when transport speed is 1.0
/ffwd state
-
+
state is true when transport is moving forward but not at speed 1.0
/rewind state
-
+
state is true when transport speed is less than 0.0
/loop_toggle state
-
+
state is true when loop mode is true
+
/cancel_all_solos state
+
Where state true indicates there are active solos that can be canceled.

Recording control

@@ -139,6 +153,10 @@ title: OSC Feedback With Ardour

+
/bank_up LED
+
where LED is a bool that indicates another bank_up operation is possible.
+
/bank_down LED
+
where LED is a bool that indicates another bank_down operation is possible.
/strip/name ssid track_name
where track_name is a string representing the name of the track (note there is no coresponding command to set the track name)
@@ -164,7 +182,37 @@ title: OSC Feedback With Ardour
/strip/pan_stereo_position ssid position
where position is a float ranging from 0 to 1 representing the actual pan position of the track
- +

Selection Operations

+

+ Selection feedback is the same as for strips, only the path changes + from /strip to /select and there is no ssid. + there are some extra feedback and commands that will be listed here. +

+
+
/select/n_inputs number
+
where number number of inputs for this strip
+
/select/n_outputs number
+
where number number of outputs for this strip
+
/select/comment text
+
where text is the strip comment
+
/select/solo_iso state
+
where state is a bool/int representing the Actual solo isolate state of the track
+
/select/solo_safe state
+
where state is a bool/int representing the actual solo safe/lock state of the track
+
/select/polarity invert
+
where invert is a bool/int representing the actual polarity of the track
+
/select/pan_stereo_width width
+
where width is a float ranging from -1 to 1 representing the actual pan width of the track
+
/select/send_gain", sendid send_gain
+
where sendid = nth_send, send_gainis a float + ranging from -193 to +6 representing the actual gain in dB for the send
+
/select/send_fader", sendid send_gain
+
where sendid = nth_send, send_gainis a float + ranging from 0 to 1023 representing the actual position for the send as a fader
+
/select/send_name sendid send_name
+
where send_name is a string representing the name of the buss + this send goes to.
+

Menu actions

Every single menu item in Ardour's GUI is accessible via OSC. However, diff --git a/_manual/22_using-control-surfaces/01_controlling-ardour-with-osc/03_calculating-feedback-and-strip-types-values.html b/_manual/22_using-control-surfaces/01_controlling-ardour-with-osc/03_calculating-feedback-and-strip-types-values.html index bf153ce0..3f1cbe66 100644 --- a/_manual/22_using-control-surfaces/01_controlling-ardour-with-osc/03_calculating-feedback-and-strip-types-values.html +++ b/_manual/22_using-control-surfaces/01_controlling-ardour-with-osc/03_calculating-feedback-and-strip-types-values.html @@ -11,7 +11,7 @@ title: Calculating Feedback and Strip-types Values

Both ,feedback and strip-types use bitsets to keep track what they are doing. Any number in a computer is made out of - bits that are on or off, but we represtent them as normal base 10 + bits that are on or off, but we represent them as normal base 10 numbers. Any one bit turned on will add a unique value to the number as a whole. So for each kind of feedback or strip type to be used, that number should be added to the total.

@@ -32,29 +32,36 @@ title: Calculating Feedback and Strip-types Values 2 - MidiTracks.
  • - 4 - AudioBusses. + 4 - AudioBuses.
  • - 8 - MidiBusses. + 8 - MidiBuses.
  • 16 - VCAs.
  • - 2048 - Master. + 32 - Master.
  • - 4096 - Monitor. + 64 - Monitor.
  • - 16384 - Selected. + 256 - Selected.
  • - 32768 - Hidden. + 512 - Hidden.
    • +

    + Selected and Hidden bits are normally not needed as Ardour defaults to + showing Selected strips and not showing Hidden strips. The purpose of + these two flags is to allow showing only Selected strips or only + Hidden strips. Using Hidden with other flags will allow Hidden strips + to show inline with other strips. +

    - Some handy numbers to use might be: 15 (all tracks and busses), 31 + Some handy numbers to use might be: 15 (all tracks and buses), 31 (add VCAs to that). Master or Monitor strips are generally not useful on a surface that has dedicated controls for these strips as there are /master* and /monitor* commands already. However, on a surface with @@ -100,7 +107,13 @@ title: Calculating Feedback and Strip-types Values will not work if the above option is turned on.

  • - 512 - Send signal present, true if level is higher than -20dB + 512 - Send signal present, true if level is higher than -40dB +
    • +
  • + 1024 - Send position in samples +
    • +
  • + 2048 - Send position in time, hours, minutes, seconds and milliseconds

    • diff --git a/_manual/22_using-control-surfaces/01_controlling-ardour-with-osc/04_parameter-types-in-osc.html b/_manual/22_using-control-surfaces/01_controlling-ardour-with-osc/04_parameter-types-in-osc.html new file mode 100644 index 00000000..15956d04 --- /dev/null +++ b/_manual/22_using-control-surfaces/01_controlling-ardour-with-osc/04_parameter-types-in-osc.html @@ -0,0 +1,33 @@ +--- +layout: default +title: Parameter Types in OSC +--- + +

    + An OSC message is laid out in this form: +

    + + /path/of/command type parameter + +

    + The type is there to indicate what the parameter is. This gives + the idea that parameter types are quite strict and if the command + requires an Integer "i" then the controller had better send it. + However, the checking of the parameter type is left to the receiving + software. +

    +

    + What this means in practical terms is that the surface can get away + with sending the wrong type of parameter. There are some places + where that just doesn't make sense. For example, a parameter that + is specified as a Float with a range of 0 to 1, could be sent as + an Integer, but would only have full scale and minimum value with + nothing in between. This is not much use for a fader, though ok for + a button. +

    +

    + There are a number of OSC controllers based on iOS and Android + tablets that only send or receive parameters as floats or text. + These controllers should have no problem sending bool or int values + as floats. Ardour will interpret the values as required. +

    diff --git a/_manual/22_using-control-surfaces/01_controlling-ardour-with-osc/05_selection-considerations-in-osc.html b/_manual/22_using-control-surfaces/01_controlling-ardour-with-osc/05_selection-considerations-in-osc.html new file mode 100644 index 00000000..63b16bcd --- /dev/null +++ b/_manual/22_using-control-surfaces/01_controlling-ardour-with-osc/05_selection-considerations-in-osc.html @@ -0,0 +1,69 @@ +--- +layout: default +title: Selection/Feedback Expansion Considerations in OSC +--- + +

    + Ardour does not send every possible feedback value for each channel. + It does send expanded information on the selected channel. There are + also extra commands for the selected strip. All the feedback and + select commands have their own path /select. + This means that for the selected channel the surface does not have to + keep track of the strip ID. The /select strip will follow the + "current mixer strip" in the GUI editor window. +

    +

    + There are two major uses for this: +

      +
    1. Single strip control surfaces. Using + /access_action Editor/select-next-route or + /access_action Editor/select-prev-route + to step through the mixer strips.
      2. +
    2. Using a "Super strip" section of knobs to control parts + of the strip that are changed less often such as polarity, sends or + plugin parameters.
      3. +
    +

    +

    + Selection in Ardour's OSC implementation are complicated by the + possibility of using more than one OSC controller at the same time. + User "A" may select strip 4 and use a selected controller to make + changes to that strip. User "B" may subsequently select strip 7 to + make changes on. This leaves user "A" making changes to strip 7 + which they did not choose. +

    +

    + For this reason Ardour offers local expansion aside from the GUI + selection. Local expansion only affects the one OSC controller. GUI + selection is global and affects all controllers using GUI selection + as well as the GUI. +

    +

    + In general, in a one user situation where that one user may use either + the OSC surface or the GUI, using GUI based selection makes the most + sense. This is the default because this is the more common use. +

    +

    + When there is more than one operator, then expansion only is the + mode of choice. It may make sense for one of the surfaces to + use GUI selection where the operator is also using the GUI for some + things. However, the set up should be carefully analyzed for the + possibility of selection confusions. Expansion should be + considered the safe option. +

    +

    + It is always ok to use expansion on the surface even in a one + user scenario. This allows the user to use GUI and surface selection + for different uses. +

    +

    + It is also possible to use both if desired. /strip/select will ways + set the GUI select, but /strip/expand will set the select feedback + and commands locally without changing the GUI select. Another + /strip/expand or a /strip/select will override that expand command + and releasing the /strip/expand or /select/expand (setting it to 0 or + false) will set the /select set of commands/feedback back to whichever + strip the GUI has selected at that time. This could be used to switch + between the GUI select and the local expand to compare two strips + settings. +