Tidy up the region menu a bit, and hopefully clarify what regions will be
[ardour.git] / gtk2_ardour / mnemonic-us.bindings.in
1 ; this is a template file processed by tools/fmt-bindings to generate either 
2 ; a gtk accelmap file or a LaTeX key binding cheat sheet.
3 ;
4 ; it is the reference for any bindings or cheatsheets
5 ;
6 ;
7 ; FORMAT:
8 ; $text -> defines cheatsheet title as "text", which may contain LaTeX markup
9 ;
10 ; %group text -> defines a binding group called "group" which will have the title "text" on the cheatsheet. 
11 ;                may be followed by zero or more lines of descriptive text, which may contain LaTeX markup
12 ;
13 ; @group|action|binding|description -> defines an action+binding with description, as a member of a binding group
14 ;                                       if group starts with '-' it will not be printed in the cheatsheet.
15 ;                                       if group starts with '+' it will be printed in the cheatsheet no matter what
16 ;                                       if the group is a mouse binding group, action should contain a ':', and
17 ;                                            have the binding before the colon, and the target area after it
18
19 ;; Title
20 $ARDOUR Shortcuts \linebreak Mnemonic US-Keypad
21
22 ;; GROUP DEFINITIONS
23
24 %trans Transport \& Recording Control
25
26 %sess Session \& File Handling
27
28 %edit Basic Editing
29
30 %vis Changing What's Visible
31
32 %wvis Window Visibility
33
34 %eep Editing with Edit Point
35 Most edit functions operate on a single "Edit Point". The edit point can be any of: playhead (default), the mouse or an active marker. The choice of Edit Point is by default linked to the Zoom Focus.
36
37 %aep Aligning with the Edit Point
38 Align operations move regions so that their start/end/sync point is at the edit point. "Relative" operations
39 just align the first region and moves other selected regions to maintain relative positioning.
40
41 %epp Edit Point Playback
42
43 %movp Moving the Playhead
44 A left click in the rulers positions the playhead unless Ardour is recording. You can use {\tt KP$\_$n} to move the 
45 playhead to the n-th marker.
46
47 %rop Region Operations
48
49 %edit Edit Range
50 There are only a few functions that refer to an "Edit Range". The current edit range is defined using combinations of the possible edit points: Playhead, Marker or Mouse.\par
51 \begin{tabular}{lll}
52 {\bf Edit Point} & {\bf Active Mark?} & {\bf Edit Range} \\
53 Playhead & no & from Playhead to Mouse \\
54 Playhead & yes & from Playhead to Active Marker \\
55  & & \\
56 Mouse & no & from Mouse to Playhead \\
57 Mouse & yes & from Mouse to Active Marker \\
58  & & \\
59 Marker & no & {\it No edit range defined} \\
60 Marker & yes & from Active Marker to Mouse
61 \end{tabular}
62
63 %select Selecting
64
65 %ranges Defining Loop, Punch Range and Tempo Changes
66
67 %markers Markers \& Locations
68 The "move" commands all move the active marker(s). Jump to the first 9 markers using
69 the keypad digits 1-9 (requires numlock).
70
71 %mmode Mouse Modes
72
73 %mouse Mouse Usage
74 Right click on most objects and controls displays a context menu
75 Shift+Right click deletes most objects. 
76 OS X users without a 3 button mouse can use {\tt Option+Ctrl+Left} to simulate "Middle" for some purposes.
77 Use F1 to step through mouse modes.
78
79 %mobject Mouse Object Mode
80 This mode provides many different operations on both regions and control points, partially depending on where you click/drag with the mouse. The "body" of a region is the area where the waveform is displayed.
81
82 %mzoom Mouse Zoom Mode
83 %mops Mouse Ops on Solo/Mute/Rec-enable
84 %mopsolo Mouse Ops on Solo Buttons only
85 %mopsfader Mouse Ops on Faders \& Plugin Controls
86
87 %midi MIDI specific commands
88
89 ;; END GROUP DEFINITIONS
90
91 ;; punctuation
92
93 @vis|Editor/temporal-zoom-in|equal|zoom in
94 @vis|Editor/temporal-zoom-out|minus|zoom out
95 @eep|Editor/edit-cursor-to-previous-region-sync|apostrophe|EP to previous region sync
96 @eep|Editor/edit-cursor-to-next-region-sync|semicolon|EP to next region sync
97 @eep|Editor/cycle-edit-point|grave|next EP w/o marker
98 @eep|Editor/cycle-edit-point-with-marker|<@PRIMARY@>asciicircum|next EP w/marker
99
100 @aep|Editor/extend-range-to-end-of-region|rightanglebracket|align sync point relative
101 @-group|Editor/extend-range-to-start-of-region|leftanglebracket|some text
102
103 @trans|Transport/ToggleRoll|space|toggle roll
104 @epp|Editor/play-edit-range|<@SECONDARY@>space|play edit range
105 @epp|Editor/play-from-edit-point-and-return|<@LEVEL4@>space|play from EP \& return
106 @trans|Transport/ToggleRollMaybe|<@PRIMARY@><@SECONDARY@>space|stop but do not leave loop/range play
107 @trans|Transport/ToggleRollForgetCapture|<@PRIMARY@>space|stop and destroy
108 @trans|Transport/record-roll|<@TERTIARY@>space|start recording
109
110 @rop|Region/set-fade-in-length|slash|set fade in length
111 @rop|Region/toggle-region-fade-out|<@PRIMARY@>slash|toggle fade in active
112 @rop|Region/set-fade-out-length|backslash|set fade out length
113 @rop|Region/toggle-region-fade-out|<@PRIMARY@>backslash|toggle fade out active
114
115 @eep|Region/trim-from-start|<@TERTIARY@>braceleft|trim region start to edit point
116 @eep|Region/trim-to-end|<@TERTIARY@>braceright|trim region end to edit point
117
118 @eep|Editor/trim-to-previous-region|<@PRIMARY@>j|trim region to end of previous region
119 @eep|Editor/trim-to-next-region|<@PRIMARY@>k|trim region to start of next region
120
121 @ranges|Editor/set-loop-from-edit-range|bracketright|set loop range from edit range
122 @ranges|Region/set-loop-from-region|<@SECONDARY@>bracketright|set loop range from region(s)
123
124 @ranges|Editor/set-punch-from-edit-range|bracketleft|set punch range from edit range
125 @ranges|Region/set-punch-from-region|<@SECONDARY@>bracketleft|set punch range from region(s)
126
127 @rop|Region/boost-region-gain|asciicircum|increase region gain
128 @rop|Region/cut-region-gain|ampersand|reduce region gain
129
130 ;; letters
131 ;; TOP ROW
132
133 @sess|Common/Quit|<@PRIMARY@>q|quit
134
135 ;; note that ctrl-w is special and consumed by the keyboard snooper
136
137 @rop|Region/set-edit-point|e|set fade out length
138 @select|Editor/select-all-before-edit-cursor|<@PRIMARY@>e|select all before EP
139 @rop|Region/export-region|<@PRIMARY@><@LEVEL4@>e|export selected region(s)
140 @sess|Main/ExportSession|<@LEVEL4@>e|export session
141 @select|Editor/select-all-after-edit-cursor|<@PRIMARY@><@TERTIARY@>e|select all after EP
142 @vis|Editor/show-editor-mixer|<@TERTIARY@>e|toggle editor window mixer
143 @wvis|Common/goto-editor|<@WINDOW@>e|toggle editor window
144 @mmode|MouseMode/set-mouse-mode-range|r|range mode
145 @edit|Editor/redo|<@PRIMARY@>r|redo
146 @rop|Region/reverse-region|<@SECONDARY@>r|reverse
147 @trans|Transport/Record|<@TERTIARY@>r|engage record
148 @mmode|MouseMode/set-mouse-mode-timefx|t|timefx mode
149 @rop|Region/pitch-shift-region|<@SECONDARY@>t|transpose
150 @eep|Editor/insert-time|<@PRIMARY@>t|insert time
151 @mmode|MouseMode/set-mouse-mode-object-range|y|link object/range tools
152 @select|Editor/select-all-between-cursors|<@PRIMARY@>u|all enclosed by edit range
153 @select|Editor/select-all-within-cursors|u|all present in edit range
154 @eep|Region/insert-region-from-region-list|i|insert from region list
155 @select|Editor/invert-selection|<@TERTIARY@>i|invert selection
156 @sess|Editor/addExistingAudioFiles|<@SECONDARY@>i|import audio files
157 @mmode|MouseMode/set-mouse-mode-object|o|object mode
158 @sess|Main/Open|<@PRIMARY@>o|open an existing session
159 @sess|Main/Recent|<@PRIMARY@><@TERTIARY@>o|open a recent session
160 @wvis|Common/ToggleOptionsEditor|<@WINDOW@>o|toggle preferences dialog
161 @rop|Region/naturalize-region|<@LEVEL4@>o|move to original position
162 @trans|Editor/set-playhead|p|toggle auto-punch status
163 @select|Editor/select-all-before-playhead|<@PRIMARY@>p|all before playhead
164 @midi|MIDI/panic|<@SECONDARY@>p|MIDI panic (stop all notes etc)
165 @select|Editor/select-all-after-playhead|<@TERTIARY@><@PRIMARY@>p|all after playhead
166
167 ;; MIDDLE ROW
168
169 @aep|Editor/align-regions-sync-relative|a|align sync points (relative)
170 @select|Editor/select-all|<@PRIMARY@>a|select everything
171 @aep|Editor/align-regions-end|<@SECONDARY@>a|align end(s)
172 @aep|Editor/align-regions-sync|<@TERTIARY@>a|align sync points
173 @aep|Editor/align-regions-start|<@PRIMARY@><@LEVEL4@>a|align start(s)
174 @aep|Editor/align-regions-start-relative|<@LEVEL4@>a|align start(s) relative
175 @rop|Region/split-region|s|split
176 @sess|Common/Save|<@PRIMARY@>s|save session
177 @sess|Main/Snapshot|<@PRIMARY@><@TERTIARY@>s|snapshot session
178 @rop|Region/duplicate-region|d|duplicate region (once)
179 @rop|Region/multi-duplicate-region|<@TERTIARY@>d|duplicate region (multi)
180 @select|Editor/select-all-in-punch-range|<@PRIMARY@>d|select all in punch range
181 @vis|Editor/fit-tracks|f|fit tracks vertically
182 @trans|Editor/toggle-follow-playhead|<@PRIMARY@>f|toggle playhead tracking
183 @wvis|Region/show-rhythm-ferret|<@WINDOW@>f|show rhythm ferret window 
184 @mmode|MouseMode/set-mouse-mode-gain|g|region gain mode
185 @epp|Region/play-selected-regions|h|play selected region(s)
186 @eep|Editor/trim-front|j|trim front
187 @eep|Editor/trim-back|k|trim back
188 @wvis|Common/ToggleKeyEditor|<@WINDOW@>k|toggle key bindings editor
189 @trans|Transport/Loop|l|loop play (the loop range)
190 @select|Editor/select-all-in-loop-range|<@PRIMARY@>l|select all in loop range
191 @wvis|Common/ToggleLocations|<@WINDOW@>l| toggle locations dialog
192
193 ;; HOME ROW
194
195 @mmode|MouseMode/set-mouse-mode-zoom|z|zoom mode
196 @edit|Editor/undo|<@PRIMARY@>z|undo
197 @vis|Editor/zoom-to-region|<@PRIMARY@><@SECONDARY@>z|zoom (x) to selected region(s)
198 @vis|Editor/zoom-to-region-both-axes|<@SECONDARY@>z|zoom (x+y) to selected region
199 @vis|Editor/toggle-zoom|<@TERTIARY@>z|toggle last 2 zoom states
200 @edit|Editor/editor-cut|<@PRIMARY@>x|cut
201 @edit|Editor/editor-copy|<@PRIMARY@>c|copy
202 @wvis|Common/ToggleColorManager|<@WINDOW@>c|toggle color manager
203 @rop|Region/set-region-sync-position|v|set region sync point
204 @edit|Editor/editor-paste|<@PRIMARY@>v|paste
205 @-group|Editor/brush-at-mouse|<@PRIMARY@>b|some text
206 @trans|Editor/track-record-enable-toggle|<@SECONDARY@>b|toggle track rec-enable 
207 @wvis|Common/ToggleBigClock|<@WINDOW@>b|toggle big clock
208 @rop|Region/normalize-region|n|normalize
209 @sess|Main/AddTrackBus|<@PRIMARY@><@TERTIARY@>n|add track(s) or bus(ses)
210 @sess|Main/New|<@PRIMARY@>n|open a new session
211 @mmode|MouseMode/toggle-internal-edit|m|toggle MIDI note editing
212 @rop|Region/toggle-region-mute|<@PRIMARY@>m|mute/unmute
213 @wvis|Common/toggle-editor-mixer-on-top|<@WINDOW@>m|rotate editor \& mixer window
214
215 ;; arrow keys, navigation etc.
216
217 @vis|Editor/step-tracks-up|uparrow|scroll up (step)
218 @trans|Transport/TransitionToRoll|<@TERTIARY@>uparrow|transition to roll
219 @select|Editor/select-prev-route|<@SECONDARY@>uparrow|select previous track/bus
220 @vis|Editor/move-selected-tracks-up|<@PRIMARY@>uparrow|move selected tracks up
221
222 @vis|Editor/step-tracks-down|downarrow|scroll down (step)
223 @trans|Transport/TransitionToReverse|<@TERTIARY@>downarrow|transition to reverse
224 @select|Editor/select-next-route|<@SECONDARY@>downarrow|select next track/bus
225 @vis|Editor/move-selected-tracks-down|<@PRIMARY@>downarrow|move selected tracks down
226
227 @movp|Editor/playhead-to-previous-region-boundary|leftarrow|to previous region edge
228 @movp|Editor/playhead-to-previous-region-boundary-noselection|<@LEVEL4@>leftarrow|to previous edge \linebreak[4] (ignore selection)
229 @movp|Editor/playhead-to-previous-region-sync|<@PRIMARY@><@SECONDARY@>leftarrow|to previous region sync
230 @movp|Editor/tab-to-transient-backwards|<@PRIMARY@>leftarrow|to previous transient
231 @movp|Editor/nudge-playhead-backward|<@SECONDARY@>leftarrow|nudge backward
232 @movp|Editor/playhead-backward-to-grid|<@TERTIARY@><@LEVEL4@>leftarrow|to previous grid point
233 @trans|Transport/Rewind|<@TERTIARY@>leftarrow|rewind
234 @markers|Editor/selected-marker-to-previous-region-boundary|<@PRIMARY@><@TERTIARY@>leftarrow|move to prev. region edge
235
236 @movp|Editor/playhead-to-next-region-boundary|rightarrow|to next region edge
237 @movp|Editor/playhead-to-next-region-boundary-noselection|<@LEVEL4@>rightarrow|to next region edge \linebreak[4] (ignore selection)
238 @movp|Editor/playhead-to-next-region-sync|<@PRIMARY@><@SECONDARY@>rightarrow|to next region sync
239 @movp|Editor/tab-to-transient-forwards|<@PRIMARY@>rightarrow|to next transient
240 @movp|Editor/nudge-playhead-forward|<@SECONDARY@>rightarrow|nudge forwards
241 @movp|Editor/playhead-forward-to-grid|<@TERTIARY@><@LEVEL4@>rightarrow|to next grid point
242 @trans|Transport/Forward|<@TERTIARY@>rightarrow|fast forward
243 @markers|Editor/selected-marker-to-next-region-boundary|<@PRIMARY@><@TERTIARY@>rightarrow|move to next region edge
244
245 @vis|Editor/scroll-tracks-down|Page_Down|scroll down (page)
246 @vis|Editor/scroll-tracks-up|Page_Up|scroll up (page)
247 @movp|Transport/GotoStart|Home|to start marker
248 @movp|Transport/GotoEnd|End|to end marker
249 @edit|Editor/editor-delete|Delete|delete
250
251 @movp|Editor/playhead-to-edit|Return|to edit point
252 @eep|Editor/edit-to-playhead|<@SECONDARY@>Return|move EP to playhead
253 @trans|Editor/remove-last-capture|<@PRIMARY@>Delete|destroy last recording
254
255 @-group|Editor/escape|Escape|break drag or deselect all
256
257 ;; keypad
258
259 @rop|Region/nudge-backward|KP_Subtract|nudge backward
260 @-group|Editor/nudge-next-backward|<@PRIMARY@>KP_Subtract|some text
261
262 @movp|Editor/jump-forward-to-mark|<@PRIMARY@>KP_Right|to next mark
263 @movp|Editor/jump-backward-to-mark|<@PRIMARY@>KP_Left|to previous mark
264
265 @rop|Region/nudge-forward|KP_Add|nudge forward
266 @-group|Editor/nudge-next-forward|<@PRIMARY@>KP_Add|some text
267
268 @-group|Editor/start-range|<@PRIMARY@>KP_Down|some text
269
270 @-group|Editor/finish-range|<@PRIMARY@>KP_Up|some text
271 @-group|Editor/finish-add-range|<@TERTIARY@><@PRIMARY@>KP_Up|some text
272
273 @markers|Editor/add-location-from-playhead|KP_Enter|add mark at playhead
274 @wvis|Transport/focus-on-clock|KP_Divide|focus on main clock
275
276 @movp|Transport/GotoZero|KP_0|to zero
277 @-group|Editor/goto-mark-1|KP_1|some text
278 @-group|Editor/goto-mark-2|KP_2|some text
279 @-group|Editor/goto-mark-3|KP_3|some text
280 @-group|Editor/goto-mark-4|KP_4|some text
281 @-group|Editor/goto-mark-5|KP_5|some text
282 @-group|Editor/goto-mark-6|KP_6|some text
283 @-group|Editor/goto-mark-7|KP_7|some text
284 @-group|Editor/goto-mark-8|KP_8|some text
285 @-group|Editor/goto-mark-9|KP_9|some text
286
287 ;; F-N keys
288
289 @-group|Editor/edit-cursor-to-range-start|F1|some text
290 @-group|Editor/edit-cursor-to-range-end|F2|some text
291 @-group|Editor/crop|F3|some text
292 @-group|Editor/separate|F4|some text
293 @-group|Editor/pitch-shift-region|F5|some text
294 @select|Editor/select-range-between-cursors|F6|convert edit range to range
295 @wvis|Common/ToggleMaximalEditor|F11|toggle fullscreen editor window
296
297 @-group|Editor/save-visual-state-1|<@PRIMARY@>F1|some text
298 @-group|Editor/save-visual-state-2|<@PRIMARY@>F2|some text
299 @-group|Editor/save-visual-state-3|<@PRIMARY@>F3|some text
300 @-group|Editor/save-visual-state-4|<@PRIMARY@>F4|some text
301 @-group|Editor/save-visual-state-5|<@PRIMARY@>F5|some text
302 @-group|Editor/save-visual-state-6|<@PRIMARY@>F6|some text
303 @-group|Editor/save-visual-state-7|<@PRIMARY@>F7|some text
304 @-group|Editor/save-visual-state-8|<@PRIMARY@>F8|some text
305 @-group|Editor/save-visual-state-9|<@PRIMARY@>F9|some text
306 @-group|Editor/save-visual-state-10|<@PRIMARY@>F10|some text
307 @-group|Editor/save-visual-state-11|<@PRIMARY@>F11|some text
308 @-group|Editor/save-visual-state-12|<@PRIMARY@>F12|some text
309
310 @-group|Editor/goto-visual-state-1|<Release><@PRIMARY@>F1|some text
311 @-group|Editor/goto-visual-state-2|<Release><@PRIMARY@>F2|some text
312 @-group|Editor/goto-visual-state-3|<Release><@PRIMARY@>F3|some text
313 @-group|Editor/goto-visual-state-4|<Release><@PRIMARY@>F4|some text
314 @-group|Editor/goto-visual-state-5|<Release><@PRIMARY@>F5|some text
315 @-group|Editor/goto-visual-state-6|<Release><@PRIMARY@>F6|some text
316 @-group|Editor/goto-visual-state-7|<Release><@PRIMARY@>F7|some text
317 @-group|Editor/goto-visual-state-8|<Release><@PRIMARY@>F8|some text
318 @-group|Editor/goto-visual-state-9|<Release><@PRIMARY@>F9|some text
319 @-group|Editor/goto-visual-state-10|<Release><@PRIMARY@>F10|some text
320 @-group|Editor/goto-visual-state-11|<Release><@PRIMARY@>F11|some text
321 @-group|Editor/goto-visual-state-12|<Release><@PRIMARY@>F12|some text
322
323
324 ;; numbers
325
326 @eep|Editor/cycle-snap-mode|2|cycle to next grid snap mode
327 @eep|Editor/cycle-snap-choice|3|cycle to next grid unit
328 @trans|Editor/step-mouse-mode|4|toggle auto play
329 @trans|Transport/ToggleAutoReturn|5|toggle auto return
330 @trans|Transport/ToggleClick|6|toggle auto input
331 @ranges|Editor/set-tempo-from-region|9|set tempo (1 bar) from region(s)
332 @ranges|Editor/set-tempo-from-edit-range|0|set tempo (1 bar) from edit range
333
334 ; mouse stuff
335
336 @+mobject|foo|left-click:on body|select
337 @+mobject|foo|<@TERTIARY@>left-click:on body|extend selection
338 @+mobject|foo|<@PRIMARY@>left-click:on body|add/remove selection
339 @+mobject|foo|left-drag:on body|move region(s)
340 @+mobject|foo|<@PRIMARY@>left-drag:on body|copy+move region(s)
341 @+mobject|foo|<@PRIMARY@>middle-drag:on body|fixed time copy+move
342 @+mobject|foo|middle-drag:on body|fixed time move
343 @+mobject|foo|<@SECONDARY@><@TERTIARY@>midde:on body|lower region
344 @+mobject|foo|<@TERTIARY@>middle:on body|raise region
345 @+mobject|foo|<@PRIMARY@>left-drag:in trim bar|slip audio in region
346 @+mobject|foo|left-click:in trim bar|set region start
347 @+mobject|foo|middle:in trim bar|set region end
348 @+mobject|foo|left-drag:near ends of trim bar|adjust region edges
349 @+mobject|foo|left-click:in auto track|add control point
350 @+mobject|foo|left-drag:on point|move control point
351 @+mobject|foo|middle-drag:on point|fixed time adjust
352 @+mobject|foo|<@PRIMARY@>left-drag:on point|move point+later points
353 @+mobject|foo|<@PRIMARY@>middle-drag:on point|fixed time move
354 @+mobject|foo|left-drag:on line|move line segment
355 @+mobject|foo|<@PRIMARY@><@SECONDARY@>left-drag:on regions|rubber-band select
356 @+mobject|foo|left-drag:in auto track|rubber-band select\linebreak control points
357 @+mobject|foo|left-drag:empty space|rubber-band select
358
359 ; mouse zoom
360 @+mzoom|foo|<@PRIMARY@>middle|zoom to session
361 @+mzoom|foo|middle-click|zoom out
362 @+mzoom|foo|left-click|zoom in
363 @+mzoom|foo|left+drag |define the new visible area
364
365 ; mouse solo etc.
366 @+mops|foo|<@PRIMARY@>middle-click|learn MIDI control
367 @+mops|foo|<@PRIMARY@><@TERTIARY@>left-click|apply to all tracks/busses
368 @+mops|foo|<@PRIMARY@>left-click|apply to group
369 @+mops|foo|middle-click|momentary switch
370 @+mops|foo|left-click|apply to track or active group
371
372 ; mouse solo
373
374 @+mopsolo|foo|<@PRIMARY@><@SECONDARY@>left-click|exclusive solo
375 @+mopsolo|foo|<@TERTIARY@>left-click|temporary latched solo
376
377 ; mouse fader etc.
378
379 @+mopsfader|foo|<@PRIMARY@>middle-click|learn MIDI control
380 @+mopsfader|foo|<@TERTIARY@>left-click|reset to default
381 @+mopsfader|foo|<@PRIMARY@><@SECONDARY@>left-drag|finest-drag control
382 @+mopsfader|foo|<@PRIMARY@>left-drag|fine-drag control
383 @+mopsfader|foo|left-drag|adjust