Credit Andrea - new color wheel image and explanation for ChromaKeyHSV
[goodguy/cin-manual-latex.git] / parts / Editing.tex
index edd7203d4d6cacd118a15017babbe76deceebc98..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.
@@ -549,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.
@@ -669,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}
@@ -687,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}.
 
@@ -809,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}\\
@@ -822,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.\\
 
@@ -882,9 +885,10 @@ provided below.
                                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
@@ -923,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}
 
@@ -1131,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. 
@@ -1170,6 +1176,7 @@ 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}
@@ -1428,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