X-Git-Url: https://git.cinelerra-gg.org/git/?p=goodguy%2Fcin-manual-latex.git;a=blobdiff_plain;f=parts%2FShortcuts.tex;h=b96fd5c0857dc420b83c96156becee5081dc3e09;hp=ee0298c954f58e15343fdec9c7a053dd53d17d73;hb=ab8eefa7ebe4e4c420af37fe09214ba1927266ed;hpb=b632295809ed092f95117be70324b78d372c772d

diff --git a/parts/Shortcuts.tex b/parts/Shortcuts.tex
index ee0298c..b96fd5c 100644
--- a/parts/Shortcuts.tex
+++ b/parts/Shortcuts.tex
@@ -1,11 +1,25 @@
 \chapter{Shortcuts}%
 \label{cha:shortcuts}
 
-Almost every Cinelerra GG Infinity command has its own keyboard and mouse shortcuts. Here
-they are listed organized by window and type.  If a desktop window manager and operating
-system is already using a specific key for its own purpose then that key will not be available
-for use as a shortcut in Cinelerra. An example might be the Alt key. Some specific alternatives
-are listed in \ref{ssub:key_alternatives} in the "Key Alternatives" paragraph.
+In \CGGI{} a lot of shortcuts are defined for various operations.
+Although it is quite possible to do everything with the mouse, the extensive
+use of shortcuts can make the editing process much more convenient and
+efficient. However, with so large a variety of shortcuts it is not uncommon
+that some of them may interfere with assignments of the same shortcuts in
+the user's desktop environment, keyboard language switcher, etc. For
+example in KDE, the Alt-Tab and Shift-Alt-Tab shortcuts are commonly assigned to
+switch between different desktop applications, and if so, these keystrokes
+would not be available to \CGGI{}. Another example, in Arch linux KDE: the combination Alt+LMB does not translate the mask, but the entire Compositor window. To translate the mask we must use Ctrl+Alt+LMB.
+
+When having problems with some shortcut in \CGGI{}, it is recommended
+first to examine which set of shortcuts is assigned to the desktop
+environment and, if necessary, resolve the conflict. A special X11 application
+\texttt{xev} (or \texttt{xorg-xev}) can also help to test the keystrokes functionality (see \texttt{man xev}).
+Otherwise, \CGGI{} is completely desktop-neutral and has no
+requirements of some special window manager's support.
+
+Here the shortcuts are listed organized by window and type. Some specific alternatives are listed in~\ref{ssub:key_alternatives} in the "Key Alternatives" paragraph.  Any reference to
+Alt or Ctrl always refers to the left one on the keyboard.
 
 \section{Main window }%
 \label{sec:main_window}
@@ -29,6 +43,7 @@ The Main window (also called the program window) consists of pulldown menus, but
   & -- load tool & Ctrl-a & Selects all files. \\
   & -- load tool & Ctrl-z & Deselects any highlighted files. \\
   & Save & s & Save project. \\
+  & Save & Ctrl-s & Save project. \\
   & Save As\dots & Shift-S & Save a project for easy moving. \\
   & Export Project & Alt-s & Save a project for easy moving. \\
   & Record\dots & r & Open record window. \\
@@ -46,6 +61,7 @@ The Main window (also called the program window) consists of pulldown menus, but
   & Save Backup & b & Save auto-backup file “backup.xml". \\
   \midrule
   \textcolor{CinBlueText}{Edit} & Undo clear & z & Undo from history previous operation. \\
+  & Undo clear & Ctrl-z & Undo from history previous opration. \\
   & Redo & Shift-Z & Redo from history next opration. \\
   & Cut & x & Copy selection to cut buffer and delete. \\
   & Split & x & Split edit into 2 sections at hairline cursor. \\
@@ -58,7 +74,7 @@ The Main window (also called the program window) consists of pulldown menus, but
   & Shuffle Edits &  & Randomly reorder track edits. \\
   & Reverse Edits &  & Reverse track edits. \\
   & Edit Length\dots &  & Change selected track given duration. \\
-  & Align Edits &  & Change selected corresp. track edits to start/end same. \\
+  & Align Edits &  & Change selected corresp.\ track edits to start/end same. \\
   & Trans. Length\dots &  & Change selected track transitions to given duration. \\
   & Detach trans. &  & Remove selected track transitions. \\
   & Clear labels &  & Delete selected timeline label markers. \\
@@ -89,8 +105,10 @@ The Main window (also called the program window) consists of pulldown menus, but
   & Attach Effect\dots &  & Open video effect selection for insert at edit boundary. \\
   & Render Effect\dots &  & Open video render select to render from select as pcm. \\
   \midrule
-  \textcolor{CinBlueText}{Tracks} & Move tracks up & Shift-Up & Circulate tracks up. \\
-  & Move trks down & Shift-Down & Circulate tracks down. \\
+  \textcolor{CinBlueText}{Tracks} & Move tracks up & Shift-Up & Swap tracks up. \\
+  & Move trks down & Shift-Down & Swap tracks down. \\
+  & Roll tracks up & Ctrl-Shift-Up & Circulate tracks up. \\
+  & Roll trks down & Ctrl-Shift-Down & Circulate tracks down. \\
   & Delete tracks &  & Delete all tracks. \\
   & Delete last track & Ctrl-d & Delete last track. \\
   & Delete first track & Shift-D & Delete first track. \\
@@ -105,9 +123,9 @@ The Main window (also called the program window) consists of pulldown menus, but
   & Align cursor\dots & Ctrl-a & Align cursor on frames. \\
   & -- Edit labels &  & Toggle labels follow edits. \\
   & -- Edit effects &  & Toggle plugins follow edits. \\
-  & -- Keyfrs fol. edits &  & Toggle keyframes follow edits. \\
+  & -- Keyfrs fol.\ edits &  & Toggle keyframes follow edits. \\
   & -- Typeless keyfrs &  & Toggle typeless keyframes mode. \\
-  & Save settings & Ctrl-s & Save Cinelerra\_rc. \\
+  & Save settings now & Ctrl-Shift-S & Save \CGG{}\_rc. \\
   & Loop Playback & Shift-L & Set loop playback region to selection/all. \\
   & Set bkg render & Shift-G & Toggle background rendering. \\
   \midrule
@@ -215,13 +233,16 @@ The Main window (also called the program window) consists of pulldown menus, but
   & Redo & Shift-Z & Redo from history next operation. \\
   & Manual Goto & g & Jump to time selected by popup. \\
   \midrule
-  \textcolor{CinBlueText}{Drag/Drop Edits} & Clear Selec & Ctrl-Shift-A & Delselect all selected edits. \\
+  \textcolor{CinBlueText}{Drag/Drop Edits} & Clear Select & Ctrl-Shift-A & Deselect all selected edits. \\
+  & Select Edits & Ctrl-Alt-a & Add highlight to selected edits. \\
+  & LMB & Alt + Drag & Drag select. \\
+  & LMB & Ctrl+Alt + Drag & Drag deselect. \\
   & Copy & Ctrl-c & Copy selected edits into copy buffer. \\
   & Cut & Ctrl-x & Delete selected edits/put in buffer/collapse. \\
   & Mute & Ctrl-m & Delete selected edits/put in buffer/insert space. \\
   & Mute & Backspace & Delete selected edits/put in buffer/insert space. \\
   & Copy Pack & Ctrl-Shift-C & Copy selected edits and pack together. \\
-  & Cut Pack & Ctrl-z & Delete selected edits/put in buffer/collapse. \\
+  & Cut Pack & Ctrl-Alt-z & Delete selected edits/put in buffer/collapse. \\
   & Mute Pack & Ctrl-Shift-M & Delete selected edits/put in buffer/insert space. \\
   & Paste & Ctrl-v & Paste (splice) buffer at insertion point or reticle. \\
   & Overwrite & Ctrl-b & Paste (overwrite) buffer at insertion pt/reticle. \\
@@ -266,17 +287,19 @@ The Main window (also called the program window) consists of pulldown menus, but
   & , (comma) &  & Scroll window timeline display left (not insertion pt). \\
   & , (comma) & Ctrl & Move cursor to label left of cursor (main shortcuts). \\
   & , (comma) & Alt & Decrease auto curve limits (zoombar selected curve). \\
-  & . (period) &  & Scroll window timeline display right (not insertion pt). \\
-  & . (period) & Ctrl & Move cursor to label right of cursor (main shortcuts). \\
-  & . (period) & Alt & Move cursor to edit boundary right of cursor position. \\
+  & .\ (period) &  & Scroll window timeline display right (not insertion pt). \\
+  & .\ (period) & Ctrl & Move cursor to label right of cursor (main shortcuts). \\
+  & .\ (period) & Alt & Move cursor to edit boundary right of cursor position. \\
   & $\uparrow$ (up arrow) &  & Increase timeline duration (zoom out timeline). \\
   & $\uparrow$ (up arrow) & Ctrl & Increase audio sample waveform scale. \\
   & $\uparrow$ (up arrow) & Alt & Increase auto curve limits (zoombar selected curve). \\
   & $\uparrow$ (up arrow) & Ctrl-alt & Increase all auto curve limits. \\
+  & $\uparrow$ (up arrow) & Shift & Move all tracks up by 1. \\
   & $\downarrow$ (down arrow) &  & Decrease timeline duration (zoom in timeline). \\
   & $\downarrow$ (down arrow) & Ctrl & Decrease audio sample waveform scale. \\
   & $\downarrow$ (down arrow) & Alt & Decrease auto curve limits (zoombar selected curve). \\
   & $\downarrow$ (down arrow) & Ctrl-alt & Decrease all auto curve limits. \\
+  & $\downarrow$ (down arrow) & Shift & Move all tracks down by 1. \\
   & PGUP (page up) &  & Scroll current track vertical window pane up. \\
   & Mouse wheel & UP & Scroll current track vertical window pane up. \\
   & PGUP (page up) & Ctrl & Increase track scale geometry (zoom in track data). \\
@@ -293,6 +316,8 @@ The Main window (also called the program window) consists of pulldown menus, but
   &  & Shift+click & Over edit causes highlight section to extend to cursor. \\
   &  & Shift+click & Over boundary of effect, trims only that effect. \\
   &  & Shift+click & Over Hard Edge of Blade Cut, toggles marker. \\
+  &  & Shift+click & Between labels, highlights selection. \\
+  &  & Shift+click & Over Automation Range values, changes value. \\
   & Toggle single trk & Tab & Toggle single track arming status. \\
   & Toggle other trks & Shift-tab & Toggle all of the other tracks arming status. \\
   &  & Double click & On plugin title bar, selects that area. \\
@@ -359,8 +384,7 @@ The Main window (also called the program window) consists of pulldown menus, but
   & Show tool info & F9 & Works with editing/cropping buttons. \\
   & Show safe regs. & F10 & Draws safe regions in the video output. \\
   &  & p & Turn on/off Click to Play. \\
-  % FIXME: []
-  &  & Shift+w/Ctrl & With transport btn. loops play; all or with [\;]. \\
+  &  & Shift+w/Ctrl & With transport btn.\ loops play; all or with [\;]. \\
   \midrule
   \textcolor{CinBlueText}{Transport} & (plus 3 below) &  & Same as in Main window. \\
   \midrule
@@ -379,7 +403,7 @@ The Main window (also called the program window) consists of pulldown menus, but
   Identifier & \textbf{Key} & \textbf{Qualifier} & \textbf{Description}\\
   \midrule
   \endhead
-  \textcolor{CinBlueText}{Keypresses} & Mid. click+drag &  & Pans the view/moves the image. \\
+  \textcolor{CinBlueText}{Keypresses} & Mid.\ click+drag &  & Pans the view/moves the image. \\
   & Middle mouse & Shift & Returns to Auto zoom. \\
   & RMB &  & Brings up zoom\%/auto;reset cam/proj;hide ctrls. \\
   & LMB Zoom &  & Zooms in. \\
@@ -431,18 +455,18 @@ The Main window (also called the program window) consists of pulldown menus, but
   \midrule
   \endhead
   \textcolor{CinBlueText}{Transport} & Rewind & home & Jump to beginning. \\
-  & Fast reverse & 'KP +' /Alt-p & Toggle double speed reverse play. \\
-  & Normal reverse & 'KP 6' / Alt-o & Toggle normal speed reverse play. \\
-  & Frame reverse & 'KP 4' / Alt-u & Render previous frame. \\
-  & Stop & 'KP 0' / Alt-m & Stop playback. \\
-  & Frame forward & 'KP 1' / Alt-j & Render next frame. \\
-  & Normal forward & 'KP 3' / Alt-l & Toggle normal speed forward play. \\
-  & Fast forward & 'KP Enter'/A-; & Toggle double speed forward play. \\
+  & Fast reverse & `KP +' /Alt-p & Toggle double speed reverse play. \\
+  & Normal reverse & `KP 6' / Alt-o & Toggle normal speed reverse play. \\
+  & Frame reverse & `KP 4' / Alt-u & Render previous frame. \\
+  & Stop & `KP 0' / Alt-m & Stop playback. \\
+  & Frame forward & `KP 1' / Alt-j & Render next frame. \\
+  & Normal forward & `KP 3' / Alt-l & Toggle normal speed forward play. \\
+  & Fast forward & `KP Enter'/A-; & Toggle double speed forward play. \\
   & Jump to end & end & Jump to end. \\
-  & (No button) & 'KP 5' / Alt-i & Toggle slow speed reverse play. \\
-  & (No button) & 'KP 2' / Alt-k & Toggle slow speed forward play. \\
-  &  & 'KP\#-Shift’ & Shift added to KP \#, adds or subtracts audio. \\
-  &  & 'Ctrl-KP\#’ & If [ ] set, “KP2,3,5,6,+,enter” play between ptrs.. \\
+  & (No button) & `KP 5' / Alt-i & Toggle slow speed reverse play. \\
+  & (No button) & `KP 2' / Alt-k & Toggle slow speed forward play. \\
+  &  & `KP\#-Shift' & Shift added to KP \#, adds or subtracts audio. \\
+  &  & `Ctrl-KP\#' & If [ ] set, “KP2,3,5,6,+,enter” play between ptrs.. \\
   &  & + Shift w/Alt & Shift with Alt+x above, adds/remove audio. \\
   &  & + Shift w/Ctrl & Loops play; all or between In/Out. \\
   &  & Left click & Start or stop play forward. \\
@@ -450,21 +474,21 @@ The Main window (also called the program window) consists of pulldown menus, but
   &  & Middle wheel & Play forward or reverse 1 frame. \\
   &  & p & Turns on/off Click to Play button. \\
   \midrule
-  \textcolor{CinBlueText}{Edit} & In point & '[' or ‘<’ & Toggle In point timeline marker\\
-  & Out point & ']' or ‘>’ & Toggle Out point timeline marker. \\
+  \textcolor{CinBlueText}{Edit} & In point & `[' or ‘<’ & Toggle In point timeline marker\\
+  & Out point & `]' or ‘>’ & Toggle Out point timeline marker. \\
   &  & Ctrl-t & Clear both In and Out pointers. \\
   & Splice & v & Create splice. \\
   & Overwrite & b & Overwrite. \\
   & To clip & i & Copy selection and create clip. \\
   & Copy & c & Copy selection to cut buffer. \\
-  & Splice & 'v' + Shift & Create splice of the entire clip. \\
-  & Overwrite & 'b' + Shift & Overwrite using the entire clip. \\
-  & To clip & 'i' + Shift & Copy all and create clip. \\
-  & Copy & 'c' + Shift & Copy entire clip to cut buffer. \\
+  & Splice & `v' + Shift & Create splice of the entire clip. \\
+  & Overwrite & `b' + Shift & Overwrite using the entire clip. \\
+  & To clip & `i' + Shift & Copy all and create clip. \\
+  & Copy & `c' + Shift & Copy entire clip to cut buffer. \\
   & Show meters &  & Toggle show meters. \\
   & Toggle label & l & Toggle label at current position. \\
-  & Previous label & 'Ctrl $\leftarrow$' & Move to label before cursor. \\
-  & Next label & 'Ctrl $\rightarrow$' & Move to label after cursor. \\
+  & Previous label & `Ctrl $\leftarrow$' & Move to label before cursor. \\
+  & Next label & `Ctrl $\rightarrow$' & Move to label after cursor. \\
   & Manual Goto & g & Jump to time selected by popup. \\
   \midrule
   \textcolor{CinBlueText}{Mixer} &  & Double click & On mixer window, pastes into timeline\\
@@ -527,6 +551,7 @@ The Main window (also called the program window) consists of pulldown menus, but
   & F2 & Ctrl+Shift & Use window layout \#2. \\
   & F3 & Ctrl+Shift & Use window layout \#3. \\
   & F4 & Ctrl+Shift & Use window layout \#4. \\
+  & In Labels folder & Double click & On a Label, timeline cursor moves to label. \\
   \bottomrule
 \end{longtable}
 
@@ -565,7 +590,7 @@ The Main window (also called the program window) consists of pulldown menus, but
   \textcolor{CinBlueText}{Remote} & MENU &  & Toggle remote control state (grabs/ungrabs keys). \\
   & KPTV &  & Open or close the record window. \\
   & KPBOOK &  & Start/stop dvb channel scan. \\
-  & KPHAND &  & Quit Cinelerra program. \\
+  & KPHAND &  & Quit \CGG{} program. \\
   \midrule
   \textcolor{CinBlueText}{Commercial} &  & Shift-A & Edit commercial\\
   \bottomrule