Andrea reorganization of manual
[goodguy/cin-manual-latex.git] / parts / Editing.tex
index 0021db70a28701f335ddcf61cbaab001b8e7a24e..0a893628381219050f72ecc002b31e47ebb570a4 100644 (file)
@@ -158,7 +158,7 @@ The 7 \textit{attributes} are described here next followed by the other availabl
   This is often used to adjust audio levels on all the tracks
   simultaneously.  Gang also causes Nudge parameters to synchronize
   across all the ganged tracks.
   This is often used to adjust audio levels on all the tracks
   simultaneously.  Gang also causes Nudge parameters to synchronize
   across all the ganged tracks.
-\item[Master Track] Mark a track as \textit{master} serves when using \textit{Gang Channels} or \textit{Gang Media} mode. See \ref{sub:displaying_tracks_ganged}
+\item[Master Track] Mark a track as \textit{master} serves when using \textit{Gang Channels} or \textit{Gang Media} mode. See \nameref{sub:displaying_tracks_ganged}
 \item[Track Data Height] this up/down toggle symbol to the immediate right
 of the 5 attributes, is used to individually resize each track.  This makes
 it very easy to temporarily expand or contract the size of that track either
 \item[Track Data Height] this up/down toggle symbol to the immediate right
 of the 5 attributes, is used to individually resize each track.  This makes
 it very easy to temporarily expand or contract the size of that track either
@@ -514,7 +514,7 @@ NOTE: for correct operation of this use case, you should have the
 same (or more) number of tracks in the Master project as you do in
 the Sequence.  To avoid having to know how many tracks you need, you
 can use the Nest feature as described in the Nesting section
 same (or more) number of tracks in the Master project as you do in
 the Sequence.  To avoid having to know how many tracks you need, you
 can use the Nest feature as described in the Nesting section
-(\ref{sub:nesting}).
+(\ref{sec:nesting_clips_and_assetts}).
 
 
 \section{Cut and Paste Editing}%
 
 
 \section{Cut and Paste Editing}%
@@ -823,6 +823,8 @@ provided below.
     Clear Select & Ctrl-Shift-A & Deselect all selected edits --
                                   ones that have the red lines
                                   around them.\\
     Clear Select & Ctrl-Shift-A & Deselect all selected edits --
                                   ones that have the red lines
                                   around them.\\
+                                  
+    Select Edits & Ctrl-Alt-a & Select all edits within an highlighted area of the timeline \\
 
     Copy & Ctrl-c & Copy the selected edits into the copy buffer.\\
 
 
     Copy & Ctrl-c & Copy the selected edits into the copy buffer.\\
 
@@ -881,6 +883,72 @@ at the start of the edits, and will replace any existing attached
 transitions.  As a side note, when in drag and drop mode the end
 transition does not drag.
 
 transitions.  As a side note, when in drag and drop mode the end
 transition does not drag.
 
+\subsection{Snapping while Cutting and Dragging}%
+\label{syb:snapping_cutting_dragging}
+
+\paragraph{Cutting/Snapping edits} cuts from an edit handle to the
+insert point.  There are Edit Panel buttons which normally are used
+to move to the previous or next edit handle/label.
+
+\begin{wrapfigure}[3]{r}{0.2\linewidth}
+       \vspace{-2ex}
+       \centering
+       \includegraphics[width=0.7\linewidth]{snap.png}
+\end{wrapfigure}
+
+They look like tags and the letter E on the menu bar and are
+oriented forward/backward.  These same buttons can be used to
+\textit{cut} from the insert pointer to the previous or next
+edit/label when the ctrl+alt keys are both pressed when the buttons
+are used.  They \textit{snap} off the media instead of doing the
+standard re-positioning.  This is useful to minimize the number of
+operations necessary to cut between edits/labels.
+
+Instead of using the edit panel buttons, you can more easily use the
+following keyboard shortcuts to perform the same functions:
+
+\begin{center}
+       \begin{tabular}{lll}
+               \toprule
+               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
+       \end{tabular}
+\end{center}
+
+\paragraph{Drag Snapping} if you hold down the Ctrl + Alt keys while
+dragging using the mouse, once the clip gets near to an edit, a
+label, an in/out pointer or the start/end of the timeline, the
+dragged clip will snap next to that marker.  The 2 will now be
+exactly aligned with no gap and no overlap.  As you drag the clip
+close to one of the markers, when they are within a short distance
+they start to stick and stay that way until you move further away
+from that distance.  Also, the line will turn color from green to
+yellow while in the sticky phase.  In addition, this works for a
+plugin while dragging so that it will be the same length as the edit.
+
+\subsection{Copy/Paste clips/medias across Multiple Instances}%
+\label{sub:copy_paste_multiple_instances}
+
+It is easy to copy/paste clips/media within a single instance of
+\CGG{} or across multiple instances.  The reason this works is
+because there are hidden X cut buffers and these are used to
+transmit EDL from 1 instance to another.
+
+Steps to copy from a source timeline and paste to a target timeline:
+
+\begin{enumerate}
+       \item highlight a selection on the timeline in 1 instance of \CGG{}
+       \item use the Copy icon (shortcut c) on the main menu bar to copy
+       into a buffer
+       \item move the pointer to another instance of \CGG{} and set an
+       insertion point in its timeline
+       \item use the Paste icon (shortcut v) to paste the clip to that
+       other instance selection target
+\end{enumerate}
+
 \subsection{Grouping edits}%
 \label{sub:grouping_edits}
 
 \subsection{Grouping edits}%
 \label{sub:grouping_edits}
 
@@ -1032,6 +1100,17 @@ samples or frames show ) on the main timeline extending between the
 [ and ].  This means that when the highlighted cursor selection is
 empty, the In/Out selection will be used.
 
 [ and ].  This means that when the highlighted cursor selection is
 empty, the In/Out selection will be used.
 
+Summarizing: to select multiple edits/clips on the timeline you can simply use LMB on each edit. Or, if in \texttt{Settings $\rightarrow$ Preferences $\rightarrow$ appearence tab $\rightarrow$ Flags} we have enabled \textit{Clears before toggle}, use CTRL + LMB on each edit.
+
+There is also a faster way:
+
+\begin{enumerate}
+       \item Arm the tracks you want to be used
+       \item Highlight the area as usually you do with \textit{I-beam} mode (or use \textit{In/Out Points}; or position \textit{Insert Point} over the stack of edits). If you miss an edit that you want included, the same method can be used to add it. It is an additive operation. And, it will include the partial edits in the selected area, thus making it easy to disinclude ones you do not want.\r
+       It will include silence also but you can remove that or any other edit with CTRL + LMB.
+       \item Press MMB on a clip inside the highlight area and the PopUp menu is shown with the \textit{Select edits} option on the top.
+       \item Choose the \textit{Select edits} option and the clips inside the highlight area will be selected.
+\end{enumerate}
 
 \section{Inter-View Mode\;/\;Identifying Source Targets Editing}%
 \label{sec:inter-view_identifying_source_target_editing}
 
 \section{Inter-View Mode\;/\;Identifying Source Targets Editing}%
 \label{sec:inter-view_identifying_source_target_editing}
@@ -1120,219 +1199,8 @@ file UNLESS there is an audio track associated with the video.
 Because audio tracks are not proxied, they will show for Media but
 not for Proxy.
 
 Because audio tracks are not proxied, they will show for Media but
 not for Proxy.
 
-
-\section{Some Specific Editing Tools}%
-\label{sec:specific_editing_tools}
-
-This section covers some more detailed editing tools and scenarios
-for edit management.
-
-\subsection{Editing EDLs within a Project}%
-\label{sub:edit-edls}
-
-To edit EDL that is included with your project as Clips, Nested
-Clips, Referenced File, or Xml you can use the option \textit{Open
-  EDL} in the Resources window for the highlighted media.  Then with
-a simple button click you can return to your main timeline project.
-For example, if you have a nested clip that originally had several
-plugins added to it before it was nested, you can edit those plugin
-parameter values. Previously to make any changes to these types of
-EDL you had to remake the whole clip from scratch.
-
-Here is how this works. In the Clip or Media folder or on a timeline
-EDL edit, the option \textit{Open EDL} for the highlighted clip or
-nested clip is available so that when you choose this option, that
-EDL will be brought up on the timeline superseding the current EDL
-that exists on the timeline.  Now, once the clip is open on the
-timeline, you can edit it however you want. The previous timeline
-EDL is \textit{pushed onto a stack} so it can be recalled by
-\textit{popping the stack} with a click of the left mouse button in
-the upper right hand corner of the timeline to the left of the
-\textit{shell cmds} icon.  Initially this button displays a 0 to
-indicate your initial timeline/project.  Then this button will read
-1 if you choose \textit{Open EDL} and then back to 0 and your
-original timeline with the left mouse click.  You can go several
-levels deep so instead of 1, it could be 2, 3, $\dots$ but this
-requires some thought to avoid potential confusion.
-
-An example of a typical set of steps to follow is:
-\begin{enumerate}
-\item Load your media using insertion strategy of \textit{Replace
-    current project}.  There will be \# 0 in the upper right hand corner
-  of the main menu with the tooltip of \textit{Close EDL}.
-\item Highlight a selection on the timeline and press the
-  \textit{To clip} icon and click the green checkmark OK.
-\item In the Resources window, open the Clip folder and you will
-  see that Clip 1 is present.
-\item Highlight Clip1 and right mouse the item to bring up
-  available options and select \textit{Open EDL}.
-\item Now you will see the timeline change from the original
-  media to just the clip content and the \# in the upper right hand
-  corner will change from 0 to 1.
-\item Add a visible effect, like AgingTV to the timeline.
-\item Click on the \# 1 in the main menu bar to see he timeline
-  restored to the original media.
-\item Drag the clip from the Resources Clip folder to the
-  timeline and you will see the AgingTV effect.
-\end{enumerate}
-
-You can follow the same steps as above by first using the option
-\textit{Nest to media} in the Clip folder which nests the clip and
-moves it out of the Clip folder to the Media folder.  Then use
-\textit{Open EDL} on the Nested EDL in the media folder.  When you
-Open EDL and edit the changes, those changes will take affect on any
-and all occurrences of that nested clip on the current and/or
-original timeline. The option to unnest that clip and put that back
-into the Clip folder is the option \textit{EDL to clip}.  The nested
-clip is still in the Media folder.  It will now have a name of the
-next available Clip \# but the comment contains the previous name so
-you can tell where it came from.
-
-Instead of using the \# number on the main menu to close the current
-EDL, both the Media and Clip folders have \textit{Close EDL} options
-with the left mouse button. Clicking on the \# number is quick and
-easy but for infrequent usage it is not obvious, whereas if you use
-\textit{Open EDL} you see \textit{Close EDL} right below that and so
-it is very obvious.  In addition in the case of where you have
-opened a EDL, and you no longer see that clip in the folder, the
-right mouse button where no media is highlighted will also display
-the Close EDL option.
-
-%\pagebreak
-\begin{figure}[h]
-  \centering
-  \includegraphics[width=1\linewidth]{editing-img001.png}
-  \caption{Once you have an Open EDL, the easiest way to close it.}
-  \label{fig:open_edl}
-\end{figure}
-\relax
-
-In addition to the \textit{Open EDL} option in the Resources menu,
-this option is available on the timeline when the cursor is on an
-EDL-type edit. To get to this option, click on the middle mouse
-button on that edit.  If it is not EDL, the option will not be
-shown.  In summary:
-
-\begin{center}
-  \begin{tabular}{ll}
-    \toprule
-    Media folder of Resources window & Open EDL for Nested or Referenced EDLs\\
-    Clip folder of Resources window & Open EDL for clips\\
-    Track timeline & Open EDL for Nested or Referenced EDLs\\
-    \bottomrule
-  \end{tabular}
-\end{center}
-
-An aside -- when nesting and unnesting clips to take advantage of
-this feature, names of the media can lead to some confusion.  For
-example, if you nest a clip, the new name in the Media folder is the
-word \textit{Nested} followed by an underscore with the date and
-timestamp, another underscore, and then the clip name.  Then when
-you unnest this Media folder clip via the \textit{EDL to clip}
-option, the name will be changed in the Clip folder to the next
-available Clip \#.  However the comment field will reflect the
-nested clip name from which it was derived.  To avoid confusion you
-can easily change the name for these clips in either the Clip or
-Media folder because they are not real files at this point. To do
-so, highlight the clip name in Resources, click on Info and type in
-a new name.
-
-For additional safety, the \textit{Open EDL} feature includes
-additional backup capabilities. Automatically \CGG{} saves a backup
-when certain changes are made or you can always use the shortcut `b'
-to do one yourself, although keep in mind it will be overwritten
-whenever \CGG{} wants to do another backup.  Now there is a shortcut
-for the backup shortcut `b' so you can keep your hand on the mouse
-instead of the keyboard.  Just click on the \# in the upper right
-hand corner of the main window.  If \# is at 0, it backs up to
-backup.xml, if at 1, it backs up to \texttt{backup1.xml} and so on
-\dots up to \texttt{backup9.xml}.
-
-When \textit{Open EDL} is invoked, the current EDL and current undo
-stack are both \textit{pushed}, and the active session EDL is
-replaced with the target clip/nested edl.  A new undo stack is
-created, and the active \texttt{backup.xml} file name is decorated
-with the stack level.  So, \texttt{backup.xml} is
-\texttt{backup1.xml} when your edits are at stack level 1,
-\texttt{back\-up2\-.xml} at stack level 2, and so on.  This means
-that if you \textit{load backup} at stack level 1, the session will
-reload from history at stack level 1, not the main session.
-
-See a real-world workflow at appendix \nameref{sec:workflow_openedl_nested_clips}
-
-\subsection{Editing with File by Reference}%
-\label{sub:file-reference}
-
-It is sometimes handy to have EDL assets not as a copy, but as a
-reference that is automatically updated into your project.  Suppose
-you have several short videos that at the end have the same credits
-which include the current year such as 2019.  But now it is 2020 and
-all of the videos would have to be individually updated with the new
-date.  By including a \textit{Referenced File} as the EDL file type
-when you create each of the videos, you can just change the one
-credits xml file and the next time you load one of the videos and
-render it, it will now automatically have the updated information.
-
-The purpose of this feature is to be able to rework a smaller
-section of a global master project at any time, which can be done by
-an "assistant" (i.e. external software like GIMP or Inkscape, $\dots$) and then this work is automatically reflected in the
-global master project.  It is for \textbf{advanced usage only}.
-
-Up until the addition of this feature, \CGG{} has always used copies
-and no direct reference in order to ensure original data is never
-compromised.  In the usual case, subprojects as xmls are copied into
-a master project where subprojects had been inserted, so that if you
-change something in a subproject or delete a subproject, it would
-have no affect on the master project.  But now with \textit{File by
-  Reference}, any project that uses a referenced file will
-automatically include any changes made to the referenced file when
-loaded.  At the same time, if you use the EDL file NOT as a
-referenced file in a project since it is then just a copy, it will
-not be updated.  Because of this difference, the user needs to be
-very aware of what using this feature could do.
-
-\textbf{Use with extreme caution}.  However, there are several
-built-in safety features and a warning that should never be turned
-off even though it gives you the option to do so.  These include:
-
-\begin{enumerate}
-\item When the \texttt{File, Load files} menu is opened, the EDL
-  strategy will always be set to just EDL as default.  Although, if
-  you use Apply and leave the Load Menu open, it will stay changed to
-  what you selected until it is re-opened.
-\item When an EDL is opened as \textit{Reference}, the color of
-  that file name in the Resources Media folder is different in order
-  to serve as a reminder that it is special.
-\item A warning message is displayed in a popup window when you
-  load a \textit{File by Reference} that reads “Other projects can
-  change this project and this can become a broken link”.  Although
-  you can check the warning box to never see this warning again, you
-  would be well advised to not do so.  It is a great reminder of
-  consequences and you will not want to be cavalier about the warning.
-  Instead just use the X to dismiss the warning.
-\end{enumerate}
-
-Here is a step by step example of how you can use \textit{File by
-  Reference}:
-\begin{enumerate}
-\item Start up \CGG{} and use the Title plugin to create a new
-  credits file.  Save as credits.xml.
-\item Start a New project and then load an existing master
-  project to the timeline.
-\item Load the credits file you created in step 1 with a Load
-  Strategy of Create Resources Only and with EDL Strategy as
-  \textit{Reference}.
-\item Note the color change in the credits.xml filename and the
-  reference comment in the Resources Media folder.
-\item Drag the credits file to an empty spot on the timeline.
-  Save this new master project and quit.
-\item Start \CGG{} up again.  Load credits.xml and make a change
-  to the Title and save again.
-\item Exit \CGG{}; restart \CGG{}; load your master project and
-  now you will automatically see on the timeline the changes you just
-  made in the previous step.
-\end{enumerate}
-
+\section{Edit Tools}%
+\label{sec:edit-tools}
 
 \subsection{Edit Length}%
 \label{sub:edit-lenght}
 
 \subsection{Edit Length}%
 \label{sub:edit-lenght}
@@ -1464,414 +1332,24 @@ permutation of the fragments resulting in 0002 now being first, then
   \label{fig:shuffle}
 \end{figure}
 
   \label{fig:shuffle}
 \end{figure}
 
+\section{Multi-Session}%
+\label{sec:multi_session}
 
 
-\subsection{Drag Handle Management / Trimming}%
-\label{sub:drag_handle_management_trimming}
-
-With some edits on the timeline it is possible to do trimming. By
-trimming you shrink or grow the edit boundaries by dragging them. In
-drag and drop mode or cut and paste mode, move the cursor over an
-edit boundary until it changes shape. The drag handle shows as a
-left or right facing fat arrow when you cursor near the clip start
-or end.  If the cursor faces left, the dragging operation affects
-the beginning of the edit. If the cursor faces right, the dragging
-operation affects the end of the edit.
-
-The effect of each drag operation not only depends on the behavior
-button but whether the beginning or end of the edit is being
-dragged. When you release the mouse button, the trimming operation
-is performed.
-
-For all file formats, other than still images, the extent of the
-trimming operation is limited to the source file length. Attempting
-to drag the start of the edit beyond the start of the source, limits
-it to the source start. In all trimming operations, all edits which
-start on the same position as the cursor when the drag operation
-begins are affected. You have to disarm tracks in order to prevent
-edits from being affected.
-
-You have 6 different choices of which mouse button to use for
-specific types of editing while using the drag handle.  You change
-the drag handle mouse effects by using the \texttt{Settings
-  $\rightarrow$ Preferences  $\rightarrow$ Interface} tab and
-modifying the Editing section as shown in the next
-figure~\ref{fig:trim}. The drag handle affects not only the clip you
-are working on but also frequently the entire duration of all clips
-on the timeline.
-
-\begin{figure}[htpb]
-  \centering
-  \includegraphics[width=0.6\linewidth]{trim.png}
-  \caption{Default choices for mouse: Ripple for button 1; Roll
-    for button 2; Slip for button 3}
-  \label{fig:trim}
-\end{figure}
-
-A description of the fundamental/common terminology for choices
-follows.
-
-\begin{description}
-\item[All Edits (ripple)] shorten or lengthen the start or end
-  of a single piece of media while moving all media to the right of
-  that clip up or down on the timeline correspondingly.  Timeline
-  duration is modified.  In a drag \textit{All Edits} operation, the
-  beginning of the edit either cuts data from the edit if you move it
-  forward or pastes new data from before the edit if you move it
-  backward. The end of the edit pastes data into the edit if you move
-  it forward or cuts data from the end of the edit if you move it
-  backward. All the following edits shift. If you drag the end of the
-  edit past the start of the edit, the edit is deleted.
-\item[One Edit (roll)] move the in and out point of a single
-  clip without changing the timeline duration. In a drag \textit{One
-    Edit} operation, nothing is cut or pasted. If you move the beginning
-  or end of the edit forward, the source reference in the edit shifts
-  forward. If you move the beginning or end of the edit backward, the
-  source reference shifts backward. The edit remains in the same spot
-  in the timeline but the source shifts.
-\item[Src Only (slip)] move the in and out point of a single
-  clip without changing the timeline duration. In a drag \textit{Src
-    Only} operation, nothing is cut or pasted. If you move the beginning
-  or end of the edit forward, the source reference in the edit shifts
-  forward. If you move the beginning or end of the edit backward, the
-  source reference shifts backward. The edit remains in the same spot
-  in the timeline but the source shifts.
-\item[Slide] a single clip is moved but retains its current in
-  and out point; however the out point of the clip to the left changes
-  and the in point of the clip to the right also changes.  Timeline
-  duration remains the same.
-\item[Edge Left/Right] moves the edge of the clips.
-\item[No effect] no changes are made.  You might want to use
-  this choice to prevent accidental movements.
-\end{description}
-
-The next table displays the options and results
-with the Key Table here first.
-
-\begin{lstlisting}[style=sh]
-    s = src media start
-    p = proj position
-    l = length
-    c = cut distance
-    rest == p+=c: for rest of clips
-    01 = flags edits_moved, rest_moved
-\end{lstlisting}
-
-\renewcommand{\arraystretch}{1.15}
-\begin{table}[ht]
-  %\caption{}
-  %\label{tab:}
-  % Tell table to adjust font to fix on the page using \resize
-  \resizebox{\textwidth}{!}{%
-    \begin{tabular}{lllll}
-      \toprule
-      &  & \textbf{Drag Left} & \textbf{Drag Right} &\\
-      \midrule
-      \multicolumn{2}{l}{\textit{curr s += c, l -= c; + rest}} & $\leftarrow$ & $\rightarrow$ & \textit{rest}\\
-      abc12345xyz & \textbf{Ripple} left edge 11 $\rightarrow$ & abc012345xyz & abc2345xyz &\\
-      \midrule
-      \multicolumn{2}{l}{\textit{curr l += c; + rest}} & $\leftarrow$ & $\rightarrow$ & \textit{rest}\\
-      abc12345xyz & \textbf{Ripple} right edge 01 $\rightarrow$ & abc1234xyz & abc123456xyz &\\
-      \midrule
-      \multicolumn{2}{l}{\textit{prev l += c; curr ps+= c, l -= c}} & $\leftarrow$ & $\rightarrow$ &\\
-      abc12345xyz & \textbf{Roll} left edge 00 $\rightarrow$ & ab012345xyz & abcd2345xyz &\\
-      \midrule
-      \multicolumn{2}{l}{\textit{curr l += c; next ps+= c, l -= c}} & $\leftarrow$ & $\rightarrow$ &\\
-      abc12345xyz & \textbf{Roll} right edge 00 $\rightarrow$ & abc1234wxyz & abc123456yz &\\
-      \midrule
-      \multicolumn{2}{l}{\textit{s -= c}} & $\leftarrow$ & $\rightarrow$ &\\
-      abc12345xyz & \textbf{Slip} left edge 10 $\rightarrow$ & abc23456xyz & abc01234xyz &\\
-      \midrule
-      \multicolumn{2}{l}{\textit{s -= c}} & $\leftarrow$ & $\rightarrow$ &\\
-      abc12345xyz & \textbf{Slip} right edge 10 $\rightarrow$ & abc23456xyz & abc01234xyz &\\
-      \midrule
-      \multicolumn{2}{l}{\textit{prev l += c; curr p+= c; next ps += c, l -= c}} & $\leftarrow$ & $\rightarrow$ &\\
-      abc12345xyz & \textbf{Slide} left edge 10 $\rightarrow$ & ab012345wxyz & abcd12345yz &\\
-      \midrule
-      \multicolumn{2}{l}{\textit{prev l += c; curr p+= c; next ps += c, l -= c}} & $\leftarrow$ & $\rightarrow$ &\\
-      abc12345xyz & \textbf{Slide} right edge 10 $\rightarrow$ & ab12345wxyz & abcd12345yz &\\
-      \midrule
-      \multicolumn{2}{l}{\textit{curr s -+= c, l += c; + rest}} & $\leftarrow$ & $\rightarrow$ & \textit{rest}\\
-      abc12345xyz & \textbf{Edge} left edge 11 $\rightarrow$ & abc2345xyz & abc0123456xyz &\\
-      \midrule
-      \multicolumn{2}{l}{\textit{curr l -+= c; + rest}} & $\leftarrow$ & $\rightarrow$ & \textit{rest}\\
-      abc12345xyz & \textbf{Edge} right edge 01 $\rightarrow$ & abc1234xyz & abc123456xyz &\\
-      \bottomrule
-    \end{tabular}
-  }
-\end{table}
-\renewcommand{\arraystretch}{1}
-
-Next, a more immediate and colorful view shows these trimming
-options (figure~\ref{fig:trim-color}).
-
-\begin{figure}[htpb]
-    \centering
-    \includegraphics[width=0.8\linewidth]{trim-color.png}
-    \caption{The 5 types of Trim: note the different lengths of the results.}
-    \label{fig:trim-color}
-\end{figure}
-
-\paragraph{How to do a J-cut or L-cut} A J-cut is a split edit film
-editing technique in which the audio from a following scene overlaps
-the picture from the preceding scene, so that the audio portion of
-the later scene starts playing before its picture as a lead-in to
-the visual cut.  An L-cut is a different split edit film editing
-technique in which the audio from preceding scene overlaps the
-picture from the following scene, so that the audio cuts after the
-picture, and continues playing over the beginning of the next scene
-(figure~\ref{fig:j-cut}). To do either a J-cut or an L-cut, you
-first shorten the first or second video a little.  Then you block
-the audio tracks from changing by disarming the appropriate tracks.
-Finally use \textit{One Edit (roll)} the cutting edge off the
-videos.  Moving to the right creates a J-cut and moving to the left
-creates an L-cut.
-
-\begin{figure}[htpb]
-    \centering
-    \includegraphics[width=0.8\linewidth]{j-cut.png}
-    \caption{J-cut to left and L-cut to right}
-    \label{fig:j-cut}
-\end{figure}
-
-
-\subsection{Split View in Compositor Using the Drag Handle with Trim}%
-\label{sub:split_view_compositor_using_drag_trim}
-
-The Trim Feature using the drag handle provides some good ways to
-view your video while editing.  The playback position in the
-compositor is updated live and the view in the compositor can be
-split so that in the left half of the compositor you can see the
-last frame of the left clip and in the right half the first frame of
-the right clip.  Dragging edits can not be extended past the
-beginning or the end.
+You can run as many sessions of \CGG{} as your computer resources allow.  However, if you are using the same \texttt{\$HOME/.bcast5}, changes you make for one may impact the others. You can always create and rename a new \texttt{.bcast5} from:\\
+\texttt{Settings $\rightarrow$ Preferences $\rightarrow$ Interface $\rightarrow$ Index files:} and press \textit{Index files go here}
 
 
-First familiarize yourself with button operation; check your setup
-by executing the following step.  In the \texttt{Settings
-  $\rightarrow$ Preferences $\rightarrow$ Interface} tab, Editing
-section, clicking on the edit boundaries can be set for Button 1, 2,
-3 as one of the following:
+\section{Multi-Viewer Window Support}%
+\label{sec:multi_viewer_window_support}
 
 
-\textit{Ripple}; \textit{Roll}; \textit{Slip}; \textit{Slide};
-\textit{Edge} or \textit{No effect}
-
-Now to use this feature, create a track with edits that have trims
-on the left and/or the right. The edit boundary can be modified
-using \textit{drag handles} at the boundary between the edits
-(figure~\ref{fig:trim-display}).
+You can create as many Viewer windows as you want in \CGG{}.  These are handy for users who are adept at working with a lot of different clips simultaneously.  By bringing up multiple Viewer windows, each clip can be edited in its own area, making it easy to see all of the separate pieces.  After you have loaded some media files, to start another Viewer window, right click on one of the pieces of media in the Resources window.  This brings up a menu of several options, one of which is \textit{view in new window}.  Choose this option and that media will come up in a new Viewer window for you to work (figure~\ref{fig:multi-view01}).
 
 \begin{figure}[htpb]
 
 \begin{figure}[htpb]
-  \centering
-  \includegraphics[width=1\linewidth]{trim-display.png}
-  \caption{Split compositor screen showing the result of the Trim feature}
-  \label{fig:trim-display}
-\end{figure}
-
-\begin{description}
-\item[Left Mouse Button (LMB) usage:] If you grab the edit
-  handle from the right side, you will see a left arrow and dragging
-  the boundary will modify the right edit playback starting time. If
-  you grab the edit handle from the left side, you will see a right
-  arrow and dragging the boundary will modify the left edit playback
-  ending time. In both cases, the composer will show the edit endpoint
-  of the changed edit.
-\item[Shift LMB usage:] The effect on the edits is the same as
-  described above, but the composer will show a split screen of the
-  left and right edits as they appear at the drag handle
-  boundary. Dragging will only change one of the two images, since
-  only one edit is being changed.
-\item[Middle Mouse Button (MMB) usage:] Both the left and the
-  right edit ending/starting times are updated.  The image shown in
-  the compositor will be drawn from the side of the drag grab, that is
-  the left if it is grabbed from the left, and the right if it is
-  grabbed from the right.
-\item[Shift MMB usage:] The effect on the edits is the same as
-  described above, but the composer will show a split screen of the
-  left and right edits as they appear at the drag handle boundary.
-  Dragging will change both of the two images, since both edits are
-  being changed.
-\item[Right Mouse Button (RMB) usage:] The start/end point of
-  the current edit is moved, but the edit length is unchanged only one
-  image changes since only one edit endpoint is view is updated.
-\item[Shift RMB usage:] The effect on the edits is the same as
-  described above, but the composer will show a split screen of the
-  left and right edits as they appear at the drag handle boundary.
-  Dragging will only change one of the two images, since only one edit
-  is being changed.
-\end{description}
-
-
-\subsection{Snapping while Cutting and Dragging}%
-\label{sub:snapping_cutting_dragging}
-
-\paragraph{Cutting/Snapping edits} cuts from an edit handle to the
-insert point.  There are Edit Panel buttons which normally are used
-to move to the previous or next edit handle/label.
-
-\begin{wrapfigure}[3]{r}{0.2\linewidth}
-  \vspace{-2ex}
-  \centering
-  \includegraphics[width=0.7\linewidth]{snap.png}
-\end{wrapfigure}
-
-They look like tags and the letter E on the menu bar and are
-oriented forward/backward.  These same buttons can be used to
-\textit{cut} from the insert pointer to the previous or next
-edit/label when the ctrl+alt keys are both pressed when the buttons
-are used.  They \textit{snap} off the media instead of doing the
-standard re-positioning.  This is useful to minimize the number of
-operations necessary to cut between edits/labels.
-
-Instead of using the edit panel buttons, you can more easily use the
-following keyboard shortcuts to perform the same functions:
-
-\begin{center}
-  \begin{tabular}{lll}
-    \toprule
-    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
-  \end{tabular}
-\end{center}
-
-\paragraph{Drag Snapping} if you hold down the Ctrl + Alt keys while
-dragging using the mouse, once the clip gets near to an edit, a
-label, an in/out pointer or the start/end of the timeline, the
-dragged clip will snap next to that marker.  The 2 will now be
-exactly aligned with no gap and no overlap.  As you drag the clip
-close to one of the markers, when they are within a short distance
-they start to stick and stay that way until you move further away
-from that distance.  Also, the line will turn color from green to
-yellow while in the sticky phase.  In addition, this works for a
-plugin while dragging so that it will be the same length as the edit.
-
-
-\subsection{Nesting}%
-\label{sub:nesting}
-
-\paragraph{Nested Assets} A nested asset is an EDL session that
-embeds an existing EDL session, all tracks, all plugins, editing,
-and effects into a media object that appears as one audio/video
-media object, no plugins, editing, or effects.  It is as if the
-existing EDL was rendered, and loaded in its place.  This has
-several interesting side effects.  First, you don’t have to render
-the entire media file to see any portion.  Second, it requires no
-rendering compute time or storage.  Third, it changes the precedence
-of the composer so that you get more control over the projection and
-automation, so that the results can be sent into another rendering
-step, not simply part of the current stack.  It groups the plugin
-stack in much the same way that an arithmetic expression is grouped
-by parenthesis.
-
-The EDL session and the rendered output are visually equivalent.
-Nested assets allow for complex grouping and stacking of effects,
-and makes media access much more flexible.  This feature can be used
-recursively, that is, any number of sessions may be stacked and
-referenced as an asset, as long as all of the rendering resources
-are available.  Nested assets are added to the timeline by using the
-pulldown \texttt{File $\rightarrow$ Load files}\dots on the main
-menu and selecting the \textit{Insertion strategy} of \textit{Nest
-  asset}. The file will be pasted into the timeline over the current
-selection or at the insertion point.
-
-It is somewhat important to note that nested assets and nested clips
-will have index files automatically created.  These index files can
-start to clutter up your \texttt{\$HOME/.bcast5} directory with
-files named \texttt{Nested\_\#\#\#.idx} and you may want to
-periodically delete any index files which are no longer in use.
-
-\paragraph{Nested Clips} It is also possible to create
-\textit{clips} and convert them to \textit{nested edl}.  This is
-done by first creating a clip using the standard cut, clipboard,
-paste, and/or edit panel buttons.  Now, using the resources
-\textit{clip} folder, select a clip to be nested, and use the right
-mouse button to select a clip.  This activates the clip popup menu.
-Select the \textit{Nest to media} menu item, and the clip will be
-converted to a \textit{Nested: Clip} and put in Media
-folder. Conversely, you can select a \textit{Nested: Clip}, use the
-\textit{EDL to clip} menu item, and the clip will be reverted to a
-\textit{Clip}.  This works similarly to the group / un-group editing
-features of many graphic design editing programs, but in this case
-the groups are rendered compositions (figure~\ref{fig:nesting}).
-
-Nested clips can be proxied and when they are, the resulting files
-are placed in the user's \$HOME/Videos directory by default.  This
-can be modified by changing
-
-\texttt{Settings $\rightarrow$ Preferences $\rightarrow$ Interface}
-tab, Nested Proxy Path.
-
-\begin{figure}[htpb]
-  \centering
-  \includegraphics[width=1.0\linewidth]{nesting.png}
-  \caption{Nested clips in Timeline and Resources window}
-  \label{fig:nesting}
+       \centering
+       \includegraphics[width=1.0\linewidth]{multi-view01.png}
+       \caption{Shown here are 3 Viewer windows and the \textit{View in new window} popup}
+       \label{fig:multi-view01}
 \end{figure}
 
 \end{figure}
 
-\paragraph{Notes:} creating nested clips is a complicated internal process for \CGG{}, especially for managing audio tracks. Therefore you need to make sure you have your project set up as you expect before you start nesting with the \texttt{Nest to Media} command.  Below are several things to remember.
-
-\begin{itemize}
-       \item The creation of the nested clip is based on the settings in \texttt{Settings $\rightarrow$ Format}. Be sure that the number of audio tracks and channels is the same as we want to have in the nested clip. In addition, it is better to make each audio track independent from the others (which could be linked in more than one channel) using the option: \texttt{Audio $\rightarrow$ Map 1:1}
-       \item You can do any editing on the nested clip once it is loaded to the timeline. For example we can start an OpenEDL session to make the changes. Once out of the OpenEDL session it may be that the changes made are not visible in the original nested clip. You can fix this by doing RMB on the nested clip in the \textit{Resources/Media} window and choosing \texttt{Rebuild index}. This process may take some time depending on the size of
-the media; because of the additional time required to do this, it is not done automatically in order to allow
-the user to make the decision as to when they are done editing enough and need to see the exact results
-in order to save time.
-       \item Because of the way the timeline thumbnails are displayed, after editing using OpenEDL of a
-nested clip, the thumbnails of the video track may be redrawn and may look different and out of sync with the
-way they did originally with respect to the audio waveforms. This is simply a result of the redrawing of the
- video track which is independent from the redrawing of the audio tracks. The playback is still synchronized.
-\end{itemize}
-
-\paragraph{Usage Examples of Nested Clips}
-
-\begin{description}
-\item[Example 1:] You want to make a flashback/rewind at the end
-  of your video that represents a quick summary of the entire video in
-  black and white. On he timeline, you have 60 seconds of edits with
-  clips, cuts, zoom in, zoom out and any other edits. Now you want to
-  get this 60 seconds \textit{compressed} to 10 seconds, play in
-  reverse, and in black and white at the end of your video.  You would
-  copy the 60 seconds in a clip, nest the clip in the Clip folder of
-  the Resources window and drag it to the timeline. You will see only
-  a clean clip without all of the edits that were used to create it
-  because nesting display a clip without having to actually use the
-  Render menu.  Now you can add a Reverse effect, Color3way plugin for
-  black and white, and use the Speed auto to get the 60 seconds down
-  to only 10 seconds.
-\item[Example 2:] You are working on a complex project with a
-  team in a separate location. You create some sub projects, i.e.\
-  sequences, that you or the team will use in the Master project to
-  merge the sequences in the right order and to make the final color
-  correction steps.
-\end{description}
-
-In each of the examples you can see the benefit of nesting to create
-clean looking timelines because of the automatic rendering
-capability of nesting.
-
-
-\subsection{Copy/Paste clips/medias across Multiple Instances}%
-\label{sub:copy_paste_multiple_instances}
-
-It is easy to copy/paste clips/media within a single instance of
-\CGG{} or across multiple instances.  The reason this works is
-because there are hidden X cut buffers and these are used to
-transmit EDL from 1 instance to another.
-
-Steps to copy from a source timeline and paste to a target timeline:
-
-\begin{enumerate}
-\item highlight a selection on the timeline in 1 instance of \CGG{}
-\item use the Copy icon (shortcut c) on the main menu bar to copy
-  into a buffer
-\item move the pointer to another instance of \CGG{} and set an
-  insertion point in its timeline
-\item use the Paste icon (shortcut v) to paste the clip to that
-  other instance selection target
-\end{enumerate}
-
-
 \section[ShuttlePROv2 and ShuttleXpress Jog Wheels for Editing]{ShuttlePROv2 and ShuttleXpress Jog Wheels for Editing\protect\footnote{programmatic specifications from Eric Messick}}%
 \label{sec:shuttle_jog_wheels_editing}
 
 \section[ShuttlePROv2 and ShuttleXpress Jog Wheels for Editing]{ShuttlePROv2 and ShuttleXpress Jog Wheels for Editing\protect\footnote{programmatic specifications from Eric Messick}}%
 \label{sec:shuttle_jog_wheels_editing}