Andrea/Phyllis plugins, shortcuts, and gang fixes
[goodguy/cin-manual-latex.git] / parts / Shortcuts.tex
index 7711a71e696efb47f8bacd99e488c63ac99bb52f..b96fd5c0857dc420b83c96156becee5081dc3e09 100644 (file)
@@ -1,11 +1,25 @@
 \chapter{Shortcuts}%
 \label{cha:shortcuts}
 
-Almost every \CGGI{} 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 \CGG{}. 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. \\
@@ -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. \\
@@ -107,7 +125,7 @@ The Main window (also called the program window) consists of pulldown menus, but
   & -- Edit effects &  & Toggle plugins follow edits. \\
   & -- Keyfrs fol.\ edits &  & Toggle keyframes follow edits. \\
   & -- Typeless keyfrs &  & Toggle typeless keyframes mode. \\
-  & Save settings & Ctrl-s & Save \CGG{}\_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. \\
@@ -273,10 +294,12 @@ The Main window (also called the program window) consists of pulldown menus, but
   & $\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,7 +384,6 @@ 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 [\;]. \\
   \midrule
   \textcolor{CinBlueText}{Transport} & (plus 3 below) &  & Same as in Main window. \\
@@ -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}