X-Git-Url: https://git.cinelerra-gg.org/git/?p=goodguy%2Fcin-manual-latex.git;a=blobdiff_plain;f=parts%2FShortcuts.tex;h=617495dd08c095ac0b950ecf02b45b93fc5de403;hp=308caaae40a6cf2c1d0f9aa00760127ccd64324a;hb=5f7eb23c66c85a2566498a073568bbad95004c31;hpb=7f4d0800b12798dc35f912da5a8655c7812496f7

diff --git a/parts/Shortcuts.tex b/parts/Shortcuts.tex
index 308caaa..617495d 100644
--- a/parts/Shortcuts.tex
+++ b/parts/Shortcuts.tex
@@ -1,19 +1,36 @@
 \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.
+\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.
 
 \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.
 
@@ -91,8 +108,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. \\
@@ -111,6 +130,7 @@ The Main window (also called the program window) consists of pulldown menus, but
   & -- Typeless keyfrs &  & Toggle typeless keyframes mode. \\
   & 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. \\
@@ -138,7 +158,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. \\
@@ -151,6 +171,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
@@ -218,7 +239,9 @@ 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-a & Add highlight to 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. \\
@@ -245,6 +268,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
@@ -298,6 +322,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. \\
@@ -329,9 +355,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
@@ -375,6 +403,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
@@ -423,9 +452,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
@@ -478,6 +509,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
@@ -504,6 +536,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
@@ -531,15 +564,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
@@ -578,6 +614,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