-
-\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.
-
-
-\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" 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}
-