X-Git-Url: https://git.cinelerra-gg.org/git/?p=goodguy%2Fcin-manual-latex.git;a=blobdiff_plain;f=parts%2FShortcuts.tex;h=2f6a0c29b3f2b89bd4182453bb1536ff2c68dc34;hp=ee0298c954f58e15343fdec9c7a053dd53d17d73;hb=c58003dd39554c8f53d77691bc50f1725f9973f9;hpb=b632295809ed092f95117be70324b78d372c772d diff --git a/parts/Shortcuts.tex b/parts/Shortcuts.tex index ee0298c..2f6a0c2 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 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. \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,13 @@ 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. \\ & 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 +69,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 +82,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 +113,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,10 +131,11 @@ 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. \\ + & 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 +163,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 +176,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 @@ -215,13 +243,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-' & 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 +273,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 @@ -266,17 +298,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 +327,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. \\ @@ -324,9 +360,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 @@ -359,8 +397,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 @@ -371,6 +408,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 @@ -379,7 +417,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. \\ @@ -419,9 +457,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 @@ -431,18 +471,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 +490,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\\ @@ -474,6 +514,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 @@ -500,6 +541,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 @@ -527,15 +569,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 @@ -565,7 +610,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 @@ -574,6 +619,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