X-Git-Url: https://git.cinelerra-gg.org/git/?p=goodguy%2Fcin-manual-latex.git;a=blobdiff_plain;f=parts%2FShortcuts.tex;h=42437e81b017b5ef7e4ae78565f4d14316895a5b;hp=80732f89c7189d30dba6d940667aed73fb70071e;hb=6a56a51c1ff6969d4f9e311af6faf76b9cc57f6f;hpb=ead564c30650c96009cfe0a12f86b307d136458e

diff --git a/parts/Shortcuts.tex b/parts/Shortcuts.tex
index 80732f8..42437e8 100644
--- a/parts/Shortcuts.tex
+++ b/parts/Shortcuts.tex
@@ -1,19 +1,42 @@
 \chapter{Shortcuts}%
 \label{cha:shortcuts}
+\index{shortcuts}
+
+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.  In addition to this
+manual, you can view the shortcuts in html format via the \textit{shell cmds} icon
+on the top, right corner of the main program window.  There is also a \textbf{hotkey
+Alt/h}, that can be used just about anywhere to get help on a specific window, menu,
+item, tooltip, button, and other elements (see \ref{sec:help_context_help}).
+
 
-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.
 
 \section{Main window }%
 \label{sec:main_window}
+\index{shortcuts!main window}
 
 The Main window (also called the program window) consists of pulldown menus, buttons and keys.
 
 \subsection*{Main menu pulldowns}% Without numbering.
 \label{sub:main_menu_pulldowns}
+\index{shortcuts!main window pulldowns}
 
 \renewcommand{\arraystretch}{1.15}% Increase line spacing slightly.
 
@@ -29,13 +52,14 @@ 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. \\
   & Scan\dots & Ctrl-Alt-s & Open dvb scan window. \\
   & SubTitle\dots & Alt-y & Open subtitle script window. \\
   & Render\dots & Shift-R & Open render window. \\
-  & Export EDL\dots & Shift-E & Open export EDL window. \\
+  & Export EDL\dots & Shift-E & Export to CMX3600 format. \\
   & Batch Render\dots & Shift-B & Open batch render window. \\
   & BD Render\dots & Ctrl-Shift-D & Open create bluray disk window. \\
   & DVD Render\dots & Alt-D & Open create dvd disk window. \\
@@ -46,6 +70,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 +114,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,8 +134,9 @@ 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. \\
+  & Guide on timeline & Shift-L & Create a guide on timeline. \\
   & Set bkg render & Shift-G & Toggle background rendering. \\
   \midrule
   \textcolor{CinBlueText}{View} & -- Show assets & 0 & Toggle show asset data. \\
@@ -136,7 +164,7 @@ The Main window (also called the program window) consists of pulldown menus, but
   & -- Split X pane & Ctrl-1 & Toggle $\frac{1}{2}$ horiz track timeline window panes. \\
   & -- Split Y pane & Ctrl-2 & Toggle $\frac{1}{2}$ vert track timeline window panes. \\
   & Mixer Viewer & Shift-M & Bring up a Mixer Viewer window. \\
-  & Tile mixers & Alt-t & Tile mixer windows to original position/size. \\
+  & Drag Tile mixers & Alt-t & Create a drag box to be used to tile mixers. \\
   & Default Positions & Ctrl-p & Reset window positions/size to defaults. \\
   & Tile Left &  & Set window positions/sizes to tile left screen. \\
   & Tile Right &  & Set window positions/size to tile right screen. \\
@@ -149,6 +177,7 @@ The Main window (also called the program window) consists of pulldown menus, but
 
 \subsection*{Main menu buttons}%
 \label{sub:main_menu_buttons}
+\index{shortcuts!main window buttons}
 
 \begin{longtable}[h]{>{\bfseries}p{0.15\textwidth-2\tabcolsep}p{0.25\textwidth-2\tabcolsep}p{0.2\textwidth-2\tabcolsep}p{0.4\textwidth-2\tabcolsep}}
   \toprule
@@ -216,12 +245,15 @@ The Main window (also called the program window) consists of pulldown menus, but
   & Manual Goto & g & Jump to time selected by popup. \\
   \midrule
   \textcolor{CinBlueText}{Drag/Drop Edits} & Clear Select & Ctrl-Shift-A & Deselect all selected edits. \\
+  & Select Edits & Ctrl-Alt-' & 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. \\
@@ -242,6 +274,7 @@ The Main window (also called the program window) consists of pulldown menus, but
 
 \subsection*{Main menu Keys}%
 \label{sub:main_menu_keys}
+\index{shortcuts!main window keys}
 
 \begin{longtable}[h]{>{\bfseries}p{0.15\textwidth-2\tabcolsep}p{0.25\textwidth-2\tabcolsep}p{0.2\textwidth-2\tabcolsep}p{0.4\textwidth-2\tabcolsep}}
   \toprule
@@ -295,6 +328,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. \\
@@ -326,9 +361,11 @@ The Main window (also called the program window) consists of pulldown menus, but
 
 \section{Compositor window}%
 \label{sec:compositor_window_shortcuts}
+\index{shortcuts!compositor window}
 
 \subsection*{Compositor buttons}%
 \label{ssec:compositor_buttons}
+\index{shortcuts!compositor buttons}
 
 \begin{longtable}[h]{>{\bfseries}p{0.15\textwidth-2\tabcolsep}p{0.25\textwidth-2\tabcolsep}p{0.2\textwidth-2\tabcolsep}p{0.4\textwidth-2\tabcolsep}}
   \toprule
@@ -372,6 +409,7 @@ The Main window (also called the program window) consists of pulldown menus, but
 
 \subsection*{Compositor keys }%
 \label{ssec:compositor_keys}
+\index{shortcuts!compositor keys}
 
 \begin{longtable}[h]{>{\bfseries}p{0.15\textwidth-2\tabcolsep}p{0.25\textwidth-2\tabcolsep}p{0.2\textwidth-2\tabcolsep}p{0.4\textwidth-2\tabcolsep}}
   \toprule
@@ -420,9 +458,11 @@ The Main window (also called the program window) consists of pulldown menus, but
 
 \section{Viewer window }%
 \label{sec:viewer_window_shortcuts}
+\index{shortcuts!viewer window}
 
 \subsection*{Viewer buttons }%
 \label{ssec:viewer_buttons}
+\index{shortcuts!viewer window buttons}
 
 \begin{longtable}[h]{>{\bfseries}p{0.15\textwidth-2\tabcolsep}p{0.25\textwidth-2\tabcolsep}p{0.2\textwidth-2\tabcolsep}p{0.4\textwidth-2\tabcolsep}}
   \toprule
@@ -475,6 +515,7 @@ The Main window (also called the program window) consists of pulldown menus, but
 
 \subsection*{Viewer Keys }%
 \label{ssec:viewer_keys}
+\index{shortcuts!viewer keys}
 
 \begin{longtable}[h]{>{\bfseries}p{0.15\textwidth-2\tabcolsep}p{0.25\textwidth-2\tabcolsep}p{0.2\textwidth-2\tabcolsep}p{0.4\textwidth-2\tabcolsep}}
   \toprule
@@ -501,6 +542,7 @@ The Main window (also called the program window) consists of pulldown menus, but
 
 \section{Resources window Keys }%
 \label{sec:resources_window_keys}
+\index{shortcuts!resources window}
 
 \begin{longtable}[h]{>{\bfseries}p{0.15\textwidth-2\tabcolsep}p{0.25\textwidth-2\tabcolsep}p{0.2\textwidth-2\tabcolsep}p{0.4\textwidth-2\tabcolsep}}
   \toprule
@@ -528,15 +570,18 @@ 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}
 
 
 \section{Other windows }%
 \label{sec:other_windows}
+\index{shortcuts!other windows}
 
 \subsection*{Other Buttons }%
 \label{ssec:other_buttons}
+\index{shortcuts!other windows buttons}
 
 \begin{longtable}[h]{>{\bfseries}p{0.15\textwidth-2\tabcolsep}p{0.25\textwidth-2\tabcolsep}p{0.2\textwidth-2\tabcolsep}p{0.4\textwidth-2\tabcolsep}}
   \toprule
@@ -575,6 +620,7 @@ The Main window (also called the program window) consists of pulldown menus, but
 
 \subsection*{Other Keys }%
 \label{ssec:other_keys}
+\index{shortcuts!other windows keys}
 
 \begin{longtable}[h]{>{\bfseries}p{0.15\textwidth-2\tabcolsep}p{0.25\textwidth-2\tabcolsep}p{0.2\textwidth-2\tabcolsep}p{0.4\textwidth-2\tabcolsep}}
   \toprule