single character fix in Plugins for corrected punctuation of subsampling
[goodguy/cin-manual-latex.git] / parts / Editing.tex
index a8dc4150237b255eecf8cf53db2b6d947ae0c55a..95bcb10ab76301ae12578bb287d1cbf8ce23df73 100644 (file)
@@ -11,6 +11,8 @@ but not often considered editing method is called \textit{two-screen
   editing} \index{two-screen} (or 3 point editing) where the Viewer is used to view media and then the
 desired clip from the media is transferred to the timeline.
 
+In the timeline, Audio tracks are different from Video tracks so a media including both audio and video will be split into 2 or more independent tracks. There is no \textit{Link/Unlink}-like function present in other programs, although there are workarounds.
+
 The timeline \index{timeline} is where all editing decisions are made
 (figure~\ref{fig:timeline}).  This is a stack of tracks in the
 center of the main window.  It can be scrolled up, down, left and
@@ -54,6 +56,8 @@ represents the editing decisions, you need to render it.  Saving and
 loading your edit decisions is explained in the Load, Save and the
 EDL \index{EDL} section and rendering is explained in the section on Rendering.
 
+\textbf{Nomenclature:} media loaded in the timeline, in whole or in part, are called \textit{edits}, unlike other programs that call them \textit{clips}. Clips in \CGG{} are those that are created in the Viewer window or in the timeline via the \texttt{to clip} command and brought into the Resources window, inside the \texttt{Clips folder}, where they can be renamed and a description added. These, once brought into the timeline, are renamed edits. In \CGG{} the difference edits/clips is not important and you can use them as synonyms; however, the difference of clips as it is intended in other NLEs is important. These are media (or parts of it) complete in themselves and indipendent from other clips and the timeline. Edits in \CGG{} on the other hand, can be a media (or part of it) but can also be any region of the timeline between In/Out Points or from a highlighted, on which we can do editing operations. This leads to some advantages (e.g. putting an effect only in a part of the active region) but one must always keep in mind that the edit remains dependent on the track and the entire timeline.
+
 In the following editing sections, references to common operations
 are scattered within any of the modes where they seem pertinent.
 However, many of the editing operations work in different modes.
@@ -129,7 +133,9 @@ The 7 \textit{attributes} are described here next followed by the other availabl
   combination with the active region determine where material is
   inserted when loading files.  If the files are loaded with one of
   the insertion strategies which do not delete the existing project,
-  the armed tracks will be used as destination tracks.
+  the armed tracks will be used as destination tracks.  Note that disarming
+  a track does not prevent you from dragging or attaching an Effect/Plugin
+  onto a disarmed track - this is not considered an edit in this case.
 \end{description}
 
 \begin{description}
@@ -317,11 +323,10 @@ on top of old tracks.
 
 Often users working on media where Audio is the main focus, want all of a media's audio channels, whether stereo or 5:1 channels, to be treated as a single unit. They are more familiar with working with a DAW (Digital Audio Workstation software) and find that it takes extra work and a lot more care to have to individually manage audio tracks rather than have them automatically edited as a ganged group.
 
-To get this capability, there is a \textit{Gang Tracks} \index{gang tracks toggle} toggle button on the main timeline controls to switch between 3 modes of working with multiple channels so that the tracks are automatically edited as a single unit. Operations affected include edits such as cuts, moving sections, and adding plugins. Group masters are marked by the \textit{Master Track} \index{master track} toggle in the patchbays \index{patchbay}. A track gang group begins on a master track, and extends to, but not including, the next master track. The 3 \textit{Gang Tracks} modes are:
+To get this capability, there is a \textit{Gang Tracks} \index{gang tracks toggle} toggle button on the main timeline controls to switch between 3 modes of working with multiple channels so that the tracks are automatically edited as a single unit. Operations affected include edits such as cuts, moving sections, and adding plugins. In addition to letting you work on the tracks of a group as one, you also get a saving of space on the timeline that makes it easier to view and edit the tracks. Group masters are marked by the \textit{Master Track} \index{master track} toggle in the patchbays \index{patchbay}. A track gang group begins on a master track, and extends to, but not including, the next master track. The 3 \textit{Gang Tracks} modes are:
 
 \begin{enumerate}
        \item \textbf{Gang None:} this is the default mode and is the traditional way Cinelerra operates. If you never toggle the "Gang Tracks" button, everything operates normally as it always has. In this mode, the button icon looks like 3 tracks with $\dots$ on the end and all tracks are visible on the timeline. See figure~\ref{fig:gang-track-01}
-\end{enumerate}
 
 \begin{figure}[htpb]
        \centering
@@ -329,15 +334,7 @@ To get this capability, there is a \textit{Gang Tracks} \index{gang tracks toggl
        \caption{Gang None: only the video track is master. We see all tracks both master and non-master (default)}
        \label{fig:gang-track-01}
 \end{figure}
-
-\begin{enumerate}[start=2]
-       \item \textbf{Gang Channels:} in this mode, all \textit{Master Tracks}
-are shown. The exception is when there is no
-Master video, no Master audio or no Master subtitle track, in which case for
-each the first track of video, audio, and subtitle will be shown.  For users who
-routinely switch the track order frequently, the patchbay has the \textit{Master Track} icon to set your own preference.
-Stereo tracks, or 5:1 channels/any number of audio tracks, are drawn as 1 audio track for the purpose of making changes on that single track which are propagated to all of its other channel tracks automatically. This is the DAW-like mode. The \textit{Gang Tracks} button icon looks like 2 tracks and only the first video and first audio tracks will be shown. See figure~\ref{fig:gang-track-02}
-\end{enumerate}
+       \item \textbf{Gang Channels:} in this mode, all \textit{Master Tracks} are shown. The exception is when there is no Master video, no Master audio or no Master subtitle track, in which case for each the first track of video, audio, and subtitle will be shown. For users who routinely switch the track order frequently, the patchbay has the \textit{Master Track} icon to set your own preference. Stereo tracks, or 5:1 channels/any number of audio tracks, are drawn as 1 audio track for the purpose of making changes on that single track which are propagated to all of its other channel tracks automatically. This is the DAW-like mode. The \textit{Gang Tracks} button icon looks like 2 tracks and only the first video and first audio tracks will be shown. See figure~\ref{fig:gang-track-02}
 
 \begin{figure}[htpb]
        \centering
@@ -346,7 +343,6 @@ Stereo tracks, or 5:1 channels/any number of audio tracks, are drawn as 1 audio
        \label{fig:gang-track-02}
 \end{figure}
 
-\begin{enumerate}[start=3]
        \item \textbf{Gang Media:} this mode only shows the \textit{Master Tracks} of the media but changes are propagated to the appropriate other related tracks (even if they are not visible). The \textit{Gang Tracks} button icon looks like a single track. See figure~\ref{fig:gang-track-03}
 \end{enumerate}
 
@@ -359,7 +355,7 @@ Stereo tracks, or 5:1 channels/any number of audio tracks, are drawn as 1 audio
 
 The current \textit{Gang Tracks} mode is saved across sessions and will be saved in your project. Although most likely users will work in the \textit{Gang None} mode, users more familiar with DAW software will tend to use the \textit{Gang Channel}s mode.
 
-More details ares described next about master tracks. Each patchbay has a \textit{Master Track} button on the extreme right of the patchbay. These mark which tracks of the media are master tracks. The span of tracks between the gang group masters are the gang track group. The master track toggles can be disabled/enabled as the user wishes to create the desired track groups. Normal file loads will mark the first stream of each file loaded as a master, if the media is loaded with insertion strategy of\textit{ Replace current project}, \textit{Replace current project and concatenate tracks} or \textit{Append in new tracks}. Frequently, editing is done on video, audio, or audio/video groups to maintain timeline synchronization. By grouping related tracks, this procedure is much more automatic.
+More details are described next about master tracks. Each patchbay has a \textit{Master Track} button on the right of the patchbay. These mark which tracks of the media are master tracks. The span of tracks between the gang group masters are the gang track group. The master track toggles can be disabled/enabled as the user wishes to create the desired track groups. Normal file loads will mark the first stream of each file loaded as a master, if the media is loaded with insertion strategy of\textit{ Replace current project}, \textit{Replace current project and concatenate tracks} or \textit{Append in new tracks}. Frequently, editing is done on video, audio, or audio/video groups to maintain timeline synchronization. By grouping related tracks, this procedure is much more automatic.
 
 Previously existing projects created before the addition of ganged tracks, will have ALL tracks marked as master tracks and changing the \textit{Gang Tracks} button mode will have no effect. The user will have to properly designate which track is the master track and disabling the others in order to make use of the toggle modes.
 
@@ -367,11 +363,12 @@ There are no restrictions on how you use this feature and there may be variation
 
 NOTES:
 \begin{itemize}
-       \item When in \textit{Gang Channels} or \textit{Gang Media} mode, if the first audio track is not disarmed, but         any of its connected channel tracks are, the disarm of those channels are ignored and all channels are treated as being armed. This is to be consistent with the purpose of using this mode; the purpose being that any edits to the first master track are automatically propagated to all other channels.
+       \item When in \textit{Gang Channels} or \textit{Gang Media} mode, if the first audio track is not disarmed, but         any of its connected channel tracks are, the disarm of those channels are ignored and all channels are treated as being armed. This is to be consistent with the purpose of using this mode; the purpose being that any edits to the first master track are automatically propagated to all other channels. \textit{Warning}: this behavior is contrary to the default of \CGG{} whereby an unarmed track never undergoes any alteration. This exception was made to mimic the behavior of DAWs, where the various channels of an audio track are combined into a single "line", and it makes no sense to talk about armed or unarmed channels.
        \item It may be better when using the \textit{Gang Channels} or \textit{Gang Media} mode to make any changes
        to the first audio channel to be automatically duplicated before reverting to the \textit{Gang None} mode to make other changes. Once you start changing individual channels (that is, audio tracks) so that they are no longer coordinated in their edits/plugins, it may be more difficult to switch back to \textit{Gang Channels} mode and get the desired results since the channels may no longer be lined up.
-       \item Gang modes should not be used with Multi-camera/Mixers because they have very specific
-operational capabilities which are not compatible with the way that Ganging works.
+       \item Gang modes should not be used with Multi-camera/Mixers because they have very specific operational capabilities which are not compatible with the way that Ganging works.
+       \item Gang flags in the patchbay specifically when in \textit{Gang Channels} or \textit{Gang Media} modes will operate as set in the Master Track. For example, if when in \textit{Gang Channels} mode, you turn off “Play track” on the visible audio track, none of the associated channels (i.e. the other stereo or other 5 channels) will play. And if in \textit{Gang Media} mode, if you turn on “Play track” for the Master Track, all associated video and audio tracks will play unless you turned off “Play track” for some of the associated audio/video slave tracks which will not play. 
+       \item When adding a Plugin/Effect in \textit{Gang Channels} or \textit{Gang Media} mode to the track, highlighted selected region, or In/Out pointers area via dragging the plugin from the Resources Window the plugin will be added on the master and all slave tracks.  If using the Audio or Video pulldown, \textit{Attach Effect} option and you want to propagate the effect to all slave tracks, make sure that the checkbox for "Attach single standalone and share others" in the Dialog window is checked.  However, currently when using the right mouse button (RMB) on the master track to \textit{Attach effect}, the effect will only be inserted on that track.
 \end{itemize}
 
 \section{Two Screen Editing}%
@@ -556,7 +553,7 @@ keyboard shortcut.  The keyboard shortcut is in parenthesis here.
 
 \begin{description}
 \item [Split | Cut] (x) Delete the selected area and put it in
-  the cut buffer for future pasting.
+  the cut buffer for future pasting. If a cut is made on the \textit{Insertion Point} only, without selecting a region, \textit{hard edges} are created.
 \item[Copy] (c) Copy the selected area and put it in the cut
   buffer for future pasting.
 \item[Paste] (v) Paste the material that is in the cut buffer.
@@ -676,6 +673,7 @@ you can see an arrow pointing to the corner.  Use Shift-left mouse
 button 1 to toggle off/on the hard edge marker on all tracks
 simultaneously.
 
+\paragraph{NOTE:} Hard Edges do not allow trim operations. For more details see: \nameref{sec:trimming}.
 
 \section{Drag and Drop Editing}%
 \label{sec:drag_drop_editing}
@@ -694,7 +692,7 @@ on the timeline.
 To simply get started, perform the following operations which are
 useful for working in a drag and drop editing session.  First load
 your media by using the main menu \textit{File} pulldown \index{file pulldown} and choose
-\textit{Load files} \index{load media files}; make sure the insertion mode is set to
+\textit{Load files}\index{load media files}; make sure the insertion mode is set to
 \textit{Create new resources only} \index{insertion strategy}.  This loads the files into the
 Resources window \index{resources window}.
 
@@ -816,7 +814,6 @@ you click on the middle mouse button.  An expanded explanation is
 provided below.
 
 \renewcommand{\arraystretch}{1.15}
-\begin{center}
   \begin{longtable}{p{0.3\textwidth-2\tabcolsep} p{0.7\textwidth-2\tabcolsep}}
     \toprule
     \textbf{Key} & \textbf{Operations}\\
@@ -829,22 +826,21 @@ provided below.
                         off if it is on.\\
     \bottomrule
   \end{longtable}
-\end{center}
 
-\begin{center}
   \begin{longtable}{p{0.2\textwidth-2\tabcolsep}
-    p{0.2\textwidth-2\tabcolsep} p{0.6\textwidth-2\tabcolsep}
-    }
+    p{0.2\textwidth-2\tabcolsep} p{0.6\textwidth-2\tabcolsep}}
     \toprule
     \textbf{Popup Label} & \textbf{Key} & \textbf{Operation}\\ \midrule
+    %begin{latexonly}
     \endhead
+    %end{latexonly}
     Clear Select & Ctrl-Shift-A & Deselect all selected edits --
                                   ones that have the red lines
                                   around them.\\
                                   
-    Select Edits & Ctrl-Alt-' & Select all edits within a highlighted area of the timeline \\
+    Select Edits & Ctrl-Alt-' & Select all edits within a highlighted area of the timeline * (see note below) \\
     
-    Deselect Edits & & Deselect all edits within a highlighted area of the timeline \\
+    Deselect Edits & & Deselect all edits within a highlighted area of the timeline * (see note below) \\
 
     Copy & Ctrl-c & Copy the selected edits into the copy buffer.\\
 
@@ -884,14 +880,15 @@ provided below.
                          of the hairline cursor. This destroys the
                          current edits in that space.\\
 
-    Overwrite & Ctrl-Shift-P & Pastes plugins that are in the Copy
+    Overwrite plugins & Ctrl-Shift-P & Pastes plugins that are in the Copy
                                buffer to current location but no
                                clip. Plugins.\\
     \bottomrule
   \end{longtable}
-\end{center}
 \renewcommand{\arraystretch}{1}
 
+* \textit{If the selection area created is larger than the edits we want to act on and includes additional edits, those edits will be involved if "Select Edits" or "Deselect Edits" is used. Indeed, these options act on both the selected edits and those that are not selected but are included in the selection area created. In practice, edits that were selected are deselected, while unselected edits are selected}.
+
 The copy/paste behavior respects the armed/disarmed tracks
 state.  A paste of audio on a video track will fail and vice versa.
 In addition if you attempt to paste edits consisting of more tracks
@@ -930,12 +927,12 @@ following keyboard shortcuts to perform the same functions:
 
 \begin{center}
        \begin{tabular}{lll}
-               \toprule
+               \hline
                snap\_right\_edit & ctrl+alt+ '.' &\\
                snap\_left\_edit & ctrl+alt+ ',' &\\
                snap\_right\_label & ctrl+alt +shift '.' & shift+period is the > sign on US keyboards\\
                snap\_left\_label &  ctrl+alt +shift',' & shift+comma is the < sign on US keyboards\\
-               \bottomrule
+               \hline
        \end{tabular}
 \end{center}
 
@@ -1138,7 +1135,9 @@ There is also a faster way:
        \item Choose the \textit{Select or Deselect edits} option and the clips inside the highlight area will be selected or deselected.
 \end{enumerate}
 
-And there is a Drag mouse way (this requires that the cursor be on the first
+NOTE: \textit{Select Edits/Deselect Edits} option toggle between select and deselect edits. If you have selected an edit and you want to deselect it but select the edits near to it, you can highlight the area and using \textit{Deselect Edits} (or \textit{Select Edits}) the edits near to it will be selected while the edit selected before will be deselected. Of course it works for more edits selected before too. In practice, edits that were selected are deselected, while unselected edits (included in the selection area we created) are selected. If you want to deselect all the selected edits you must use \textit{Clear Select} option by MMB.
+
+There is a Drag mouse way (this requires that the cursor be on the first
 clip and from there you start the drag):
 \begin{enumerate}
        \item To Drag Select edits, hold down Alt+Left Mouse Button (LMB) and drag over the selection area. Releasing the mouse results in selecting. 
@@ -1154,7 +1153,7 @@ If using certain operating systems (for example Ubuntu and Arch) that might fiel
        \item Release the Alt key
 \end{enumerate}
 
-\section{Inter-View Mode\;/\;Identifying Source Targets}%
+\section{Inter-View Mode -- Identifying Source Targets}%
 \label{sec:inter-view_identifying_source_target}
 \index{inter-view}
 
@@ -1177,12 +1176,18 @@ another 2 minutes. This feature provides the following capabilities:
 \end{itemize} Figure~\ref{fig:inter-view01} shows an example of the
 Inter-View mode mapping preview mini-window.
 \begin{figure}[ht]
+  \centering
   \includegraphics[width=0.8\linewidth]{inter-view01.png}
   \caption{Inter-View mode: white bar$\rightarrow$source; red
     bar$\rightarrow$timeline}
   \label{fig:inter-view01}
 \end{figure}
 
+There is a second usage of Inter-View mode that can be helpful if
+some tracks have become misaligned, such as in the case of 2 audio
+channels no longer being in sync.  You can use this mode to get them
+back in alignment.
+
 Explanation of how to use Inter-View mode will be described here
 next.
 
@@ -1400,11 +1405,11 @@ You can create as many Viewer windows as you want in \CGG{}.  These are handy fo
        \label{fig:multi-view01}
 \end{figure}
 
-\section[ShuttlePROv2 and ShuttleXpress Jog Wheels for Editing]{ShuttlePROv2 and ShuttleXpress Jog Wheels for Editing\protect\footnote{programmatic specifications from Eric Messick}}%
+\section[ShuttlePROv2 and ShuttleXpress Jog Wheels for Editing]{ShuttlePROv2 and ShuttleXpress Jog Wheels for Editing}%
 \label{sec:shuttle_jog_wheels_editing}
 \index{shuttle pro v2 and shuttlexpress}
 
-The ShuttlePROv2 and ShuttleXpress are affordable jog wheels which
+The ShuttlePROv2 and ShuttleXpress are affordable jog wheels\protect\footnote{programmatic specifications from Eric Messick} which
 can be useful for working with Cin, especially if you do a lot of
 playing forward/backward, fast/slow/normal, and single frames
 (figure~\ref{fig:shuttle}).
@@ -1430,11 +1435,14 @@ $4\times4$\,inches.
 \end{figure}
 
 The vendor supplied \textit{string} device names for the shuttles
-are currently:
+are currently (with the mouse duplication for in at least 1 case:
 
 \texttt{/dev/input/by-id/usb-Contour\_Design\_ShuttlePRO\_v2-event-if00}\\
 \texttt{/dev/input/by-id/usb-Contour\_Design\_ShuttleXpress-event-if00}\\
-\texttt{/dev/input/by-id/usb-Contour\_Design\_ShuttlePro-event-if00}
+\texttt{/dev/input/by-id/usb-Contour\_Design\_ShuttlePro-event-if00} \\
+\texttt{/dev/input/by-id/usb-Contour\_Design\_ShuttlePRO\_v2-event-mouse}\\
+\texttt{/dev/input/by-id/usb-Contour\_Design\_ShuttleXpress-event-mouse}\\
+\texttt{/dev/input/by-id/usb-Contour\_Design\_ShuttlePro-event-mouse}
 
 Only 1 necessary initial setup is required due to permission
 settings for non-root usage. As root, just copy a file that provides
@@ -1811,7 +1819,8 @@ cat "/sys/kernel/debug/hid/0003:0B33.0030.0006/events"  # press keys to see the
 
 The following is the default setting for the ShuttlePROv2 and
 ShuttleXpress (table~\ref{tab:shuttleprov2} and
-table~\ref{tab:xpress}):
+table~\ref{tab:xpress}).  This page can be quickly requested from \CGG{} by
+simultaeneously pressing the \texttt{Alt} key on the keyboard and any button on the Shuttle.
 
 \renewcommand{\arraystretch}{1.15}
 \begin{table}[ht]