\label{fig:Fenstergrundposition-en}
\end{figure}
-First it is important to know what an EDL is. When \CGG{} saves a file, it saves the EDL,
+First, it is important to know what an EDL is. When \CGG{} saves a file, it saves the EDL,
Edit Decision List, of your project which contains all the settings and locations of edits
-and pointers to the media so that the media is not modified. The EDL is described in \nameref{sec:edl_edit_decision_list}.
+and pointers to the media so that the media is not modified. The EDL is described
+in \nameref{sec:edl_edit_decision_list}.
+
+Second, for those users who would like to keep all 4 windows together for a better workflow,
+see \nameref{sec:focus_group}.
\section{Program Window}%
\label{sec:program_window}
\index{program window}
-The main window is called the \textit{Program} window and is often just referred to as the \textit{timeline} \index{timeline}. Here is where you enter the main menu operations.
+The main window is called the \textit{Program} window and is often just referred to as the \textit{timeline}\index{timeline}. Here is where you enter the main menu operations.
This timeline consists of a vertical stack of tracks with time represented horizontally on the track.
It is the output of the rendering operations and this is what is saved when you run the \textit{File} pulldown, Save command.
-Immediately to the left of the timeline is the patchbay \index{patchbay}. The patchbay contains options that affect each track.
+Immediately to the left of the timeline is the patchbay\index{patchbay}. The patchbay contains options that affect each track.
These options are described in great detail in \nameref{sec:patchbay}.
The \textit{Window} pulldown on the main window contains options
several is described in a little more detail in other areas of this manual.
\vspace{2ex}
-\begin{tabular}{ll}
+\begin{longtable}{ll}
\hline
First set of 3 symbols & Move in the reverse direction on the timeline \\
4th symbol & Stop play \\
Set Timecode & Explained in \ref{sub:align_timecodes} \\
Gang Modes & Explained in \ref{sub:displaying_tracks_ganged} \\
\hline
-\end{tabular}
+\end{longtable}
The \textit{Manual Go To} \index{goto} menu is quite versatile as you can see in figure~\ref{fig:goto_menu}. The
options of \textit{=} represents goto the position indicated in the textbox; \textit{+} indicates
Use the pulldown \texttt{Settings$\rightarrow$Align cursor on frames} to change the alignment by
checking the box on for video and off for audio.
-\begin{figure}[htpb]
- \centering
- %\includegraphics[width=0.8\linewidth]{name.ext}
- \begin{tikzpicture}[scale=1, transform shape]
- \node (img1) [yshift=0cm, xshift=0cm, rotate=0]
- {\includegraphics[width=0.6\linewidth]{insertion-point.png}};
- \node [yshift=-5mm, xshift=-1cm,anchor=east] at (img1.north west) (Pulldowns) {Pulldowns};
- \node [yshift=-10mm, xshift=-1cm,anchor=east] at (img1.north west) (Transport) {Transport \& Buttons Bar};
- \node [yshift=-15mm, xshift=-1cm,anchor=east] at (img1.north west) (Timebar) {Timebar};
- \node [yshift=-20mm, xshift=-1cm,anchor=east] at (img1.north west) (Title) {Media Title };
- \node [yshift=-28mm, xshift=-1cm,anchor=east] at (img1.north west) (Video) {Video Track};
- \node [yshift=-46mm, xshift=-1cm,anchor=east] at (img1.north west) (Audio) {Audio Track};
- \draw [->, line width=1mm] (Pulldowns) edge ([yshift=-5mm] img1.north west);
- \draw [->, line width=1mm] (Transport) edge ([yshift=-10mm] img1.north west);
- \draw [->, line width=1mm] (Timebar) edge ([yshift=-15mm] img1.north west);
- \draw [->, line width=1mm] (Title) edge ([yshift=-20mm] img1.north west);
- \draw [->, line width=1mm] (Video) edge ([yshift=-28mm] img1.north west);
- \draw [->, line width=1mm] (Audio) edge ([yshift=-46mm] img1.north west);
- \end{tikzpicture}
-
- \caption{Insertion point is at 0:00:25:10 in Hr:Mn:Sec:Frames}
- \label{fig:insertion-points}
-\end{figure}
-
\subsection{Editing Modes}%
\label{sub:editing_modes}
on the timeline operate.
There is: \emph{drag and drop mode} and \emph{cut and paste mode}.
The editing mode is determined by selecting the \texttt{arrow} \index{arrow}, or immediately to the right of the arrow,
-the \texttt{I-beam} \index{i-beam} in the Transport and Buttons bar. In figure~\ref{fig:insertion-points} you can see
-the green colored highlight \protect\footnote{green is used in the default Cakewalk theme, but the highlight color will be different in other themes} on the arrow icon indicating that you are currently in
-\emph{drag and drop mode}.
+the \texttt{I-beam} \index{i-beam} in the Transport and Buttons bar. In figure~\ref{fig:insertion-points} you can see the green colored highlight \protect\footnote{green is used in the default Cakewalk theme, but the highlight color will be different in other themes} on the arrow icon indicating that you are currently in \emph{drag and drop mode}.
+
+\begin{figure}[htpb]
+ \centering
+ %\includegraphics[width=0.8\linewidth]{name.ext}
+ \begin{tikzpicture}[scale=1, transform shape]
+ \node (img1) [yshift=0cm, xshift=0cm, rotate=0]
+ {\includegraphics[width=0.6\linewidth]{insertion-point.png}};
+ \node [yshift=-5mm, xshift=-1cm,anchor=east] at (img1.north west) (Pulldowns) {Pulldowns};
+ \node [yshift=-10mm, xshift=-1cm,anchor=east] at (img1.north west) (Transport) {Transport \& Buttons Bar};
+ \node [yshift=-15mm, xshift=-1cm,anchor=east] at (img1.north west) (Timebar) {Timebar};
+ \node [yshift=-20mm, xshift=-1cm,anchor=east] at (img1.north west) (Title) {Media Title };
+ \node [yshift=-28mm, xshift=-1cm,anchor=east] at (img1.north west) (Video) {Video Track};
+ \node [yshift=-46mm, xshift=-1cm,anchor=east] at (img1.north west) (Audio) {Audio Track};
+ \draw [->, line width=1mm] (Pulldowns) edge ([yshift=-5mm] img1.north west);
+ \draw [->, line width=1mm] (Transport) edge ([yshift=-10mm] img1.north west);
+ \draw [->, line width=1mm] (Timebar) edge ([yshift=-15mm] img1.north west);
+ \draw [->, line width=1mm] (Title) edge ([yshift=-20mm] img1.north west);
+ \draw [->, line width=1mm] (Video) edge ([yshift=-28mm] img1.north west);
+ \draw [->, line width=1mm] (Audio) edge ([yshift=-46mm] img1.north west);
+ \end{tikzpicture}
+
+ \caption{Insertion point is at 0:00:25:10 in Hr:Mn:Sec:Frames}
+ \label{fig:insertion-points}
+\end{figure}
With the arrow highlighted for \emph{drag and drop mode}, a double click with the left mouse button in the timeline selects the edit the mouse pointer is over.
Then dragging in the timeline repositions that edit and this can be used for moving effects,
The main window pulldowns as pointed out in figure~\ref{fig:insertion-points} are quite obvious in their meaning and usage, so here is only a summary.
-%TODO Figure 3 shows an example of the pulldowns as displayed in the main window.Appearance
-
-
\begin{description}
\item[File] \index{file} options for loading, saving, and rendering as described in other sections (\ref{cha:load_save_and_the_EDL}).
\item[Edit] \index{edit} edit functions; most of which have shortcuts that you will quickly learn (\ref{cha:editing}).
\label{fig:compositor_window}
\end{figure}
-The Compositor window (figure~\ref{fig:compositor_window}) is used to display the timeline
-output. Playing and moving along the timeline video in the Program window shows in the
-Compositor window what the current image is. Here is where many compositing operations are
-performed that can change
-what the timeline will look like. When enabled, you can simply click the LMB in the Compositor
-window to start and stop play.
- You can zoom in and out to
-see small details, pan with the scrollbars, lock the window to prevent changes, add masks,
-and make changes with the Projector and Camera function operators. These will be explained
-in more detail in the following sections.
+The Compositor window (figure~\ref{fig:compositor_window}) is used to display the timeline output. Playing and moving along the timeline video in the Program window shows in the Compositor window what the current image is. Here is where many compositing operations are performed that can change what the timeline will look like and that is why it is called \textit{canvas}. The canvas dimesions correspond, by default, to the W/H values set in the project (\textit{Set Format} window). Canvas size = output size = project size.
+
+When enabled, you can simply click the LMB in the Compositor window to start and stop play. You can zoom in and out to see small details, pan with the scrollbars, lock the window to prevent changes, add masks, and make changes with the Projector and Camera function operators. These will be explained in more detail in the following sections.
\subsection{Compositor Controls}%
\label{sub:compositor_controls}
Much of the editing in \CGG{} involves \textit{compositing} which is the combining of visual
elements from different sources into single images. This includes such things as
speeding up and slowing down the video, changing the resolution, creating a split screen, and fading in and out.
-Compositing operations are done on the timeline and in the Compositor window using various
+Compositing operations are done on the timeline and in the Compositor window (canvas) using various
operations and other compositing attributes that are available in the Resources window.
When \CGG{} is performing a compositing operation it plays back through the
compositing engine, but when not, it uses the fastest decoder that it has.
\label{ssub:output_size}
\index{temporary}
-\CGG{}'s compositing routines use a \textit{temporary} which is a single frame of video in
-memory where graphics processing takes place. The size of the temporary and of the output in
-the compositing pipeline are different and vary for any particular frame. Effects are processed in
-the temporary and as such are affected by the temporary size. In the case of the camera, its
-viewport is the temporary size. However, projectors are rendered to the output and so are affected
-by the output size. When the temporary is smaller than the output, the temporary will have blank
-borders around the region in the output. When the temporary is larger than the output, it will be
-cropped.
+\CGG{}'s compositing routines use a \textit{temporary} which is a single frame of video in memory where graphics processing takes place. By default the size of the temporary is that of the project ($W \times H$); i.e., the output size; i.e, the canvas size. But if the tracks on the timeline have various sizes different from those of the project, then the temporary will take the size of the active track (viewport = green border). We can also change the size of the viewport using the Camera tool, as well as pans and zooms the temporary displayed in it. Effects are processed in the temporary and as such are affected by the temporary size. In the case of the camera, its viewport is the temporary size. The size of the temporary and of the output in the compositing pipeline can be different and vary for any particular frame. However, projectors are rendered to the output and so are affected by the output size. The temporary is the basis on which the Projector tool acts to display the canvas on the Compositor window. The canvas always has the size of the project, although with the projector we can make pans and resizes of the red border inside it. When the temporary is smaller than the output, the temporary will have blank borders around the region in the output. When the temporary is larger than the output, it will be cropped.
\subsubsection*{Track and Output size}%
\label{ssub:track_size}
a video asset and choosing \texttt{Match $\rightarrow$ Match project size}. When you \emph{Match project size}, you
are conforming the output to the asset. To change the size and aspect ratio of the output (Projector) we have to change the whole project, which will alter all the tracks in the timeline. Once you have set the output size in 1 of these 3 ways,
any newly created tracks will conform to the specified output size. When rendering, the project's
-output size is the final video track size where the temporary pipeline is rendered into.
+output size is the final video track size where the temporary pipeline is rendered into.
+
+To clarify, let's take an example.
+
+If we load a media (M) into Resources and adjust the size of the project to the size of M, we will get the canvas size of the media $W_{M} \times H_{M}$). We can see in the Set Format window that the project's default values ($W \times H$) have changed to those of M ($W_{M} \times H_{M}$). The tracks on the timeline can have different sizes, but what we will see on the canvas, that is, in the Compositor window, is always the output size i.e. the size of the project. Tracks with smaller sizes will be seen with black bands; tracks with larger sizes will be cropped. Each track has its own size but we will see it inserted in the output size. If we change the output size the tracks will not change, remaining in their original size. We can only change the size of the tracks by manually acting on each one in the ways seen before. Finally, if we create a new track in a project of size $W \times H$, it will assume the size of the project automatically.
\subsubsection*{Aspect Ratio (Theory)}%
\label{ssub:aspect_ratio_theory}
\index{aspect ratio}
\index{PAR, DAR, SAR}
-The aspect ratio is the ratio of the sides of the frame (\textit{Width} and \textit{Height}). For example, classically broadcast TV was 4:3 (= 1.33), whereas today it has changed to 16:9 (= 1.85); in cinema we use the 35 mm aspect ratio of 1.37 (Academic aperture), but even more so the super 35 mm (2.35). There are also anamorphic formats, i.e. that have no square pixels, like Cinemascope (2.35). The projection must be \textit{normalized} to have an undistorted view.
-
-
-From the film or digital sensors of the cameras, we can extract any frame size we want. We are talking about \textit{viewports}, which we will examine shortly. Also important is the output of the film that will be rendered, because it is what we will see at the cinema, or on TV, or on the monitor of the PC, tablet or smartphone. Referring to figure~\ref{fig:temporary-01}, you can see these two possibilities: with the Camera you choose the size and aspect ratio of the source file (regardless of the original size); while with the Projector you choose the size and aspect ratio of the output.
+The aspect ratio is the ratio of the sides of the frame (\textit{Width} and \textit{Height}). For example, classically broadcast TV was 4:3 (= 1.33), whereas today it has changed to 16:9 (= 1.78); in cinema we use the 35 mm aspect ratio of 1.375 (Academy aperture), academy flat (1.85 or widescreen) but even more so the super 35 mm (from 1.33 to 2.39). There are also anamorphic formats, i.e. that have no square pixels, like Cinemascope (2.39). The projection must be normalized to have an undistorted view.
-The following formula is used to vary the aspect ratio:
+From the film or digital sensors of the cameras, we can extract any frame size we want. We are talking about \textit{viewports}, which we will examine shortly. Also important is the output of the video that will be rendered, because it is what we will see at the cinema, or on TV, or on the monitor of the PC, tablet or smartphone. Referring to figure~\ref{fig:temporary-01}, you can see these two possibilities: with the \textit{Camera} tool you choose the size and aspect ratio of the source file (regardless of the original size); while with the \textit{Projector} tool you choose the size and aspect ratio of the output. Other ways of changing the aspect ratio of assets or tracks we have seen previously (\texttt{Resize track}; \texttt{Match Output Size}; \texttt{Resize asset}). A method of changing the size of the entire project (canvas) is via the \texttt{Set Format} window. The following formula is used to vary the aspect ratio:
-\qquad $\frac{W}{H} =$ aspect ratio ($\frac{pixels}{pixels}$)
+\qquad $\frac{W}{H} =$ frame aspect ratio ($\frac{pixels}{pixels}$)
-For example to obtain an aspect ratio of Super 35 mmm (2.35) starting from a FullHD file (1920x1080) whose base extension (1920) we want to keep:
+For example to obtain an aspect ratio of Super 35 mm (2.35) starting from a FullHD file (1920x1080) whose base extension (1920) we want to keep:
\qquad $\frac{1920}{H} = 2.35$
-from which: $H = 817$ pixels
-
-\CGG{} allows you to vary the input and output aspect ratio in the ways indicated in the previous section: by varying the pixels of the sides or by setting a multiplication coefficient.
-
-In \texttt{Settings $\rightarrow$ Format} there is the additional possibility to vary the shape of the pixels from 1:1 (square) to handle anamorphic formats. In such cases we use:
-
-\qquad $PAR=\frac{DAR}{SAR}$
-
-where:
-
-\textit{DAR}= Display Aspect Ratio
-
-\textit{PAR}= Pixel Aspect Ratio (1 or 1:1 is square)
+from which: $H = 816$ pixels
-\textit{SAR}= Storage Aspect Ratio (i.e media file aspect ratio)
+At the same time as changing the \textit{Height} parameter we also need to set \texttt{Display Aspect rati}o to 2.35. In fact, the parameters in Canvas Size are not related to those in Display Aspect ratio, unless we keep the \texttt{Auto} option checked, and we need to set both before we click on the \texttt{Apply} button. To set the aspect ratio to 2.35:1 we can choose from the drop-down menu the value 2.35 or set the value directly in the two input fields. Or again, it can be done automatically via the Auto option. Finally we can click on the Apply button to complete the calculations. Now we have arrived at the desired result: typical Super 35 mm dimensions and aspect ratio, although starting from a 16:9 FullHD. The new canvas, however, lost the pixels of a part of the initial video (crop), to be precise $1080 - 816 = 264$ lines of pixels from top and bottom.
+\CGG{} allows you to vary the input and output aspect ratio in the ways indicated in the previous section: by varying the pixels of the sides (Width/Height) or by setting a multiplication coefficient (W/H Ratio; in this example: placing $H Ratio = 816 : 1080 = 0.7556$) which performs the calculation automatically. If you set \textit{W Ratio} and \textit{H Ratio} at the same time with the same values, they work as multipliers and you get a resizing of the canvas, without altering the initial aspect ratio. If you change them to two different values or change only one of the two parameters, leaving the other at 1, you get an anamorphic video, with the pixels no longer being square (1:1) but becoming rectangular, deforming the image. If you use a non-standard aspect ratio, this has impact on other areas like titles, included stills and included non-anamorphotic footage. To avoid anamorphosis, the \texttt{Display Aspect ratio} must also be adjusted at the same time, for example, with the Auto option. \textit{Anamorphic} format is a complex field that is discussed
+in Andrea's paper: {\small \url{https://cinelerra-gg.org/download/Anamorphic.pdf}}.
+as well as in the Raffaella Traniello's guide: {\small \url{http://www.g-raffa.eu/Cinelerra/HOWTO/anamorphic.html}}.
\subsection{Camera and Projector}%
\label{sub:camera_and_projector}
Select the camera button to enable camera editing mode.
In this mode, the guide box shows where the camera position is in relation to past and future camera positions but not where it is in relation to the source video.
-The green box is the Viewport; at the beginning it coincides with the size of the source frame. If we move the viewport by dragging it with LMB (moving it in $x/y$), the green box remains fixed to the original size but the frame is moved to the new position. A yellow frame will appear along the edges of the frame to indicate the displacement with respect to the green box; this behavior differs from that seen for the Projector. Even if we act on the $z-axis$ (SHIFT + Drag, equivalent to the zoom), the frame narrows or widens, moving behind the yellow frame.
+The green box is the Viewport; at the beginning it coincides with the size of the source frame. If we move the viewport by dragging it with LMB (moving it in $x/y$), the green box remains fixed to the original size but the frame is moved to the new position. A yellow frame will appear along the edges of the frame to indicate the displacement with respect to the green box; this behavior differs from that seen for the Projector. Even if we click on the $z-axis$ (SHIFT + Drag, equivalent to the zoom), the frame narrows or widens, moving behind the yellow frame.
\subsubsection*{Camera and Projector Menu}%
\label{ssub:camera_and_projector_menu}
\label{fig:camera_tool}
\end{figure}
-In the \textit{Position} section you can act on the $X$, $Y$ and $Z$ coordinates. By either tumbling or entering text directly or by using the slider, the camera and projector can be precisely positioned. There is also a reference to the color of the curve as we see it on the timeline. You can also define the \textit{range} of action which by default is [-100 to 100]. By pressing the Reset button for each coordinate, or the global Reset button, the range is automatically brought to the project size value (HD; 4k; etc), which are usually the most useful limits. Note that the range can also be changed in the \textit{Program} window, in the \textit{zoom bar}, where there are similar input fields to enter the chosen limits.
+In the \textit{Position} section you can change the $X$, $Y$ and $Z$ coordinates. By either tumbling or entering text directly or by using the slider, the camera and projector can be precisely positioned. There is also a reference to the color of the curve as we see it on the timeline. You can also define the \textit{range} of action which by default is [-100 to 100]. By pressing the Reset button for each coordinate, or the global Reset button, the range is automatically brought to the project size value (HD; 4k; etc), which are usually the most useful limits. Note that the range can also be changed in the \textit{Program} window, in the \textit{zoom bar}, where there are similar input fields to enter the chosen limits.
In the \textit{Justify} section we can use automatic positioning in the 6 standard coordinates: Left, Horizontal, Right, Top, Center and Bottom.
\textit{Reset Projector}: causes the projector to return to the center.
-\subsubsection*{Use Case: Interaction Between Camera And Projector \protect\footnote{Example provided by Sam. The relative video is located at: \url{https://streamable.com/iq08i}}}%
+\subsubsection*{Use Case: Interaction Between Camera And Projector \protect\footnote{Example provided by Sam. The relative video is located at: \url{https://youtu.be/ZQaLZiYY1lg}}}%
\label{ssub:use_case_interaction_camera_projector}
\index{camera}
\index{projector}
The Mask popup menu can be overwhelming upon first encounter. However, if you follow the next
few steps you can create a single simple mask without having to understand every possible parameter.
+Be sure you are working in a Format that includes the Alpha channel, YUVA or RGBA, because you need
+to have transparency for masking to show or will end up with only a black area.
\begin{enumerate}
\item To define a mask, in the Compositor window click on the \textit{Edit mask} icon to get the popup Mask menu. If the menu does not come up, click on the \textit{Show tool info}.
\item On the video, LMB click on the place where you want to start a mask.
Other options you will see if you \textit{right mouse click in the folder} which brings up the menu are described next \index{folders!RMB options}.
\begin{description}
- \item[ Load files ] for convenience to load files same as from the main window so you do not have to move the mouse so far in case you have multiple monitors.
+ \item[Load files ] for convenience to load files same as from the main window so you do not have to move the mouse so far in case you have multiple monitors.
\item[Display text/icons] as described previously for format variations preference.
\item[Select] options are All, Used, Unused, and None. This gives you the capability to have a set of the
contents highlighted for ease of use so you can see what is or is not loaded, or unset the highlight.
\index{folder add filter/search}
Creating folders that are more specific to a particular project is helpful in better organizing your work.
-This can be done by utilizing the files already loaded to the \textit{master} Media or Clips folders in the Resources window. The general rule is you can only drag clips to a ClipUserBin and you can only drag media to a MediaUserBin.
+This can be done by utilizing the files already loaded to the \textit{master} Media or Clips folders in the Resources window. The general rule is you can only drag clips to a ClipUserBin and you can only drag media to a MediaUserBin. No subfolders can be created within the new folders. Further below, after we populate the new folder, we will see how to use logical operators or other filters to automatically sort the media.
-Below are steps illustrating an easy way to set up a folder.
+Below are steps illustrating an easy way to set up a new folder.
-%TODO Below part need to be rewriten
\begin{enumerate}
- \item In the Resources window (figure~\ref{fig:folder_resources}), in the location of the Video/Audio effects and Media folders, bring up the \textit{Folder}$\dots$ popup by clicking the right mouse button.
- Highlight, then click \textit{New Media or Clips}.
- \begin{figure}[htpb]
- \begin{minipage}{.6\linewidth}
- \centering
- \includegraphics[width=0.9\linewidth]{folder_resources.png}
- \caption{Highlight, then click “New Media or Clips”.
- “Modify folder” can be used to change the name of a folder.
- “Delete folder” in the popup can be used to delete a folder.
- }
- \label{fig:folder_resources}
- \end{minipage}
- \hfill
- \begin{minipage}{.37\linewidth}
- \centering
-%begin{latexonly}
- \vspace{18ex}
-%end{latexonly}
-
- \includegraphics[width=0.9\linewidth]{folder_new.png}
- \caption{Type in your folder name in the textbox. Click OK.}
- \label{fig:folder_new}
- \end{minipage}
- \end{figure}
+ \item In the Resources window (figure~\ref{fig:folder_resources}), in the location of the Video/Audio effects and Media folders, bring up the \textit{Folder...} popup by clicking the right mouse button. Highlight, then click \textit{New Media} or \textit{New Clips}. \textit{Modify folder} can be used to change the name of a folder. \textit{Delete folder} can be used to delete a folder.
\item In the \textit{New folder} popup as shown below (figure~\ref{fig:folder_new}), type in your folder name in the textbox. Click OK.
- \begin{figure}[htbp]
- \centering
- \includegraphics[width=0.9\linewidth]{folder_master.png}
- \caption{The “master” Media folder}
- \label{fig:folder_master}
- \end{figure}
- \item Select the \textit{master} Media folder to see which files are currently loaded, figure~\ref{fig:folder_master}.
- Highlight the files there that you want to copy to your new folder (named Photos of Garden).
- Drag the files to the left and when you see the Photos of Garden folder become highlighted, then drop there.
- You can drag and drop any of the media from the \textit{master} Media at any time.
- It flashes when the drop is successful.
+ \item Select the \textit{master} Media folder to see which files are currently loaded, figure~\ref{fig:folder_master}. Highlight the files there that you want to copy to your new folder (named \textit{Photos of Garden}). Drag the files to the left and when you see the \textit{Photos of Garden} folder become highlighted, then drop there. You can drag and drop any of the media from the \textit{master} Media at any time. It flashes when the drop is successful.
\end{enumerate}
-Adding the Shift key before the actual drop, will allow for relative path filenames instead of full path.
-But you might want to include or eliminate some of the media that exists in one of the folders that you have set up already.
-In this case you will want to click on the \textit{Modify folder} in the popup.
-When you bring up the Modify folder window, if you already have files in that folder, you will see filters that were generated automatically when you did a Drag and Drop.
+\begin{figure}[htpb]
+ \centering
+ \includegraphics[width=0.5\linewidth]{folder_resources.png}
+ \caption{New folder menu}
+ \label{fig:folder_resources}
+\end{figure}
+
+\begin{figure}[htpb]
+ \centering
+ \includegraphics[width=0.4\linewidth]{folder_new.png}
+ \caption{Folder name}
+ \label{fig:folder_new}
+\end{figure}
+
+ \begin{figure}[htbp]
+ \centering
+ \includegraphics[width=0.8\linewidth]{folder_master.png}
+ \caption{The “master” Media folder}
+ \label{fig:folder_master}
+\end{figure}
+\subsection{Modify Folder: sorting the media}%
+\label{sub:sorting_media}
+\index{folder modify}
+
+In \CGG{} all the virtual mediafiles loaded in the \textit{Resources} window are collected in the \texttt{Media} folder without any kind of organization and sorting other than alphabetical. The Media folder is considered a \textit{master} folder because it is the basis for every other new folder we create. Another \textit{master} folder is \texttt{Clips}, and in fact we can create new clips folders as well. If we do editing of large projects containing numerous mediafiles, a rational and selective organization of the source material becomes necessary. In fact, having the sources organized in folders, where they can be found and used easily, makes subsequent editing much faster, as well as minimizing confusion and the possibility of errors. This step, which is fundamental in the pro environment, is called \textit{Logging} and also includes \textit{screening} individual mediafiles in the Viewer window; \textit{renaming} them rationally; and adding labels and descriptions in the \textit{metadata}.
+
+We start by creating one or more new folders (MediaUserBin). These will be empty and we should populate them with the mediafiles contained in the master Media folder. There are two options: manual \textit{Drag and Drop} or automatic populating by setting \textit{filters} (Smart Bins).
+
+\paragraph{Drag and Drop:} you drag mediafiles into the new folder one by one or in selected groups. The starting master folder can only be \texttt{Media} (or \texttt{Clips}, if we have created a new clip folder). Dragging is done by preserving the absolute path of the sources. If you open Modify Folder window you will notice that each imported mediafile occupies a different row characterized by its own path and name. See figure~\ref{fig:modify-target}. The \texttt{Value} field containing paths can contain only 63 characters, and it may happen to find the names cut off. The full path and name can be found by right-clicking on the row, but this is inconvenient and time-consuming. The best solution is to drag the mediafiles while holding down the \texttt{Shift} key; this will return the relative path instead of the absolute path, with space gain.
\begin{figure}[htpb]
- \centering
- %\includegraphics[width=0.8\linewidth]{name.ext}
- \begin{tikzpicture}[scale=1, transform shape]
- \node (img1) [yshift=0cm, xshift=0cm, rotate=0] {\includegraphics[width=0.7\linewidth]{folder_modify.png}};
- \node [yshift=-20mm, xshift=-1cm,anchor=east] at (img1.north west) (Arrow1) {\parbox{8em}{Here is the filter that was generated with the original drop }};
- \node [yshift=-65mm, xshift=0cm,anchor=east] at (img1.north west) (Arrow2) {\parbox{10em}{When you click on the Value portion of that filter, the entire set of files that are covered by the filter rules pops up. Now you can highlight a target filename that you would like to remove, and just erase that line and check the green checkmark for OK.}};
- \draw [->, line width=1mm] (Arrow1) edge ([yshift=-20mm] img1.north west);
- \end{tikzpicture}
-
- \caption{Modify target}
- \label{fig:modify-target}
+ \centering
+ %\includegraphics[width=0.8\linewidth]{name.ext}
+ \begin{tikzpicture}[scale=1, transform shape]
+ \node (img1) [yshift=0cm, xshift=0cm, rotate=0] {\includegraphics[width=0.7\linewidth]{folder_modify.png}};
+ \node [yshift=-20mm, xshift=-1cm,anchor=east] at (img1.north west) (Arrow1) {\parbox{8em}{Here is the filter that was generated with the original drop }};
+ \draw [->, line width=1mm] (Arrow1) edge ([yshift=-20mm] img1.north west);
+ \end{tikzpicture}
+
+ \caption{Modify Folder}
+ \label{fig:modify-target}
+\end{figure}
+
+\paragraph{Filters:} you do automatic populating using filters (Smart Bins mode). You set the values of the \texttt{Enabled}; \texttt{Target}; \texttt{Op} and \texttt{Value} fields to make up the required filtering. The folder will populate automatically by pulling from the \texttt{Media} master folder. The filter is the result of one row, but we can do more sophisticated filtering by adding more rows. The process will start from the first row propagating to subsequent rows always following the pattern from top to bottom. See figure~\ref{fig:modify_folder}.
+
+\begin{figure}[htpb]
+ \centering
+ %\includegraphics[width=0.8\linewidth]{name.ext}
+ \begin{tikzpicture}[scale=1, transform shape]
+ \node (img1) [yshift=0cm, xshift=0cm, rotate=0] {\includegraphics[width=0.8\linewidth]{modify_folder1.png}};
+ \node (img2) [yshift=-1cm, xshift=3.5cm, rotate=0] at (img1) {\includegraphics[width=0.8\linewidth]{modify_folder2.png}};
+ \node (img3) [yshift=-1cm, xshift=3cm, rotate=0] at (img2){\includegraphics[width=0.5\linewidth]{modify_folder3.png}};
+ \end{tikzpicture}
+ \caption{The available choices for each field. Value field missing.}
+ \label{fig:modify_folder}
\end{figure}
-To delete the entire set of files listed on the filter rule, highlight the rule line and hit the \textit{Del} button.
+Let's look in detail at all the options of Modify Folder.
+
+When you bring up the Modify folder window, if you already have files in that folder, you will see filters that were generated automatically when you did a Drag and Drop. See figure~\ref{fig:modify-target}.
+
+When you click on the \textit{Value} portion of that filter, the entire set of files that are covered by the filter rules pops up. Now you can highlight a target filename that you would like to remove, and just erase that line and check the green checkmark for OK.
+
+To delete the entire set of files listed on the filter rule, highlight the rule line and hit the \textit{Del} button.
+
To add a new filter rule, click on the \textit{Add} button which will automatically add a default line after any current lines.
-The default line will be a line that matches everything in the \textit{master} Media folder which is \textit{Or Patterns Matches *}.
+The default line will be a line that matches everything in the master Media folder which is \textit{Or Patterns Matches *}.
Click the right mouse button on the current field underneath the column header to see the choices available for each column.
-Modifications will not be in effect until you click on the green arrow OK button or click on the Apply button.
+Modifications will not be in effect until you click on the green arrow \textit{OK} button or click on the \textit{Apply} button.
But once you hit Apply, clicking on the red X button will not undo your changes.
The filter/search rules are applied in the order listed in the Modify folder window.
You can change the order of the filter rules by highlighting the rule you want to move and then drag and drop to a new location.
-The figure~\ref{fig:modify_folder} below displays the available choices for each field.
-
-\begin{figure}[htpb]
- \centering
- %\includegraphics[width=0.8\linewidth]{name.ext}
- \begin{tikzpicture}[scale=1, transform shape]
- \node (img1) [yshift=0cm, xshift=0cm, rotate=0] {\includegraphics[width=0.8\linewidth]{modify_folder1.png}};
- \node (img2) [yshift=-1cm, xshift=3.5cm, rotate=0] at (img1) {\includegraphics[width=0.8\linewidth]{modify_folder2.png}};
- \node (img3) [yshift=-1cm, xshift=3cm, rotate=0] at (img2){\includegraphics[width=0.5\linewidth]{modify_folder3.png}};
- \end{tikzpicture}
- \caption{The available choices for each field}
- \label{fig:modify_folder}
-\end{figure}
-
Information about the columns and rules for the search filters in the Modify folder window follows \index{folder add filter/search}.
Column headers:
\begin{description}
-\item[ Enable] this column is used to designate the state of that filter rule
+\item[\textcolor{CinBlueText}{Enable}] – this column is used to designate the state of that filter rule
\begin{description}
- \item[ Off] disable the filter
+ \item[Off] disable the filter
\item[And] narrow your search; all of your search terms must be present
\item[Or] broaden your search to include more values
\item[And Not] exclude terms that do not contain the given value from your search results
\item[Or Not] include terms that do not contain the given value from your search results
\end{description}
-\item [Target] – this column designates which media asset attribute to look at
+\item [\textcolor{CinBlueText}{Target}] – this column designates which media asset attribute to look at
\begin{description}
- \item[ Patterns] each line contains a filename filter, matches the file path
+ \item[Patterns] each line contains a filename filter, matches the file path
\item[Filesize] number of bytes in a file
\item[Time] date file was created
\item[Track Type] track type of video, audio, or audio video (for both)
\item[Channels] Number of audio channels
\item[Duration] Playback time in seconds -- it uses the largest of audio or video if contains both
\end{description}
-\item[Op] – boolean operators used to narrow or broaden the relationship between your search terms
+\item[\textcolor{CinBlueText}{Op}] – boolean operators used to narrow or broaden the relationship between your search terms
\begin{description}
\item[Around] about this value; use \textit{+radius} for a search range: [target–radius$\dots$ target+radius]
\item[Eq ] equal to
\end{description}
\end{description}
-\textbf{Value} --- the characteristic you are looking for with expressions that can be written with the following:
+\textbf{\textcolor{CinBlueText}{Value}} --- the characteristic you are looking for with expressions that can be written with the following:
-\begin{description}
-\item[Number] (decimal points are allowed and will be converted to a standard form):
- \begin{description}
- \item[inf] representing infinity
- \item[\#[TtGgMmKk]] --- where \# represents a number and the characters mean:
- \end{description}
+ \begin{description}
+ \item[Number] (decimal points are allowed and will be converted to a standard form):
+ \begin{description}
+ \item[inf] representing infinity
+ \item[\#[TtGgMmKk]] --- where \# represents a number and the characters mean:
+ \end{description}
\begin{tabular}{rcl}
inf&=& infinity\\
Table showing the allowed usage:
-%TODO create table for below code
\begin{lstlisting}[numbers=none]
target: | eq ge gt ne le lt matches around
++++++++++++++++++++++++++++++++++++++++++++++++++++++++
\item Sort is by filename base name (directory path not included automatically) except when the \textit{Around} operation is used and then it is sorted by that Target distance first and then filename.
\end{enumerate}
-\begin{table}[htpb]
- \centering
- \caption{Examples}
- \label{tab:label}
- \small
- \begin{tabular}{lllm{10em}m{10em}} \toprule
- Enable& Target& Op& Value& meaning\\\midrule
-Or &Patterns &Matches &*& all files from the Media folder are included\\
-And Not&Filesize&Lt &160000000& no files that are less than 160MB in size \\
-Or Not& Time &Ge &2018/07/30 06:13:00 & files not greater than or equal date\\
-And &Duration&Eq &01:00 & files included must have 60 secs. Duration\\
-Off &Samplerate&Ne &44000 & off for now, but may want to include later\\
-And &Framerate&Around&24+1 & files included all have 24 to 25 framerate\\
-Or &Patterns&Matches&[*.mp4] & all files with the extension of mp4\\
-Or &Time& Around&2018/08/02 06:00:00 + 02:00:00 & files at 4AM to 8 AM\\\bottomrule
- \end{tabular}
-\end{table}
-
+\begin{longtable}{lllm{10em}m{10em}}
+ \caption{Examples}
+ \label{tab:label}\\
+ \toprule
+ \textbf{Enable} & \textbf{Target} & \textbf{OP} & \textbf{Value} & \textbf{meaning} \\
+ \hline
+ %begin{latexonly}
+ \endhead
+ %end{latexonly}
+ Or & Patterns & Matches & * & all files from the Media Folder are included \\
+ And Not & Filesize & Lt & 160000000 & no files that are less than 160MB in size \\
+ Or Not & Time & Ge & 2018/07/30 06:13:00 & files not greater than or equal date \\
+ And & Duration & Eq & 01:00 & files included must have 60 secs. Duration \\
+ Off & Samplerate & Ne & 44000 & off for now, but may want to include later \\
+ And & Framerate & Around & 24+1 & files included all have 24 to 25 framerate \\
+ Or & Patterns & Matches & [*.mp4] & all files with the extension of mp4 \\
+ Or & Time & Around & 2018/08/02 06:00:00 + 02:00:00 & files at 4 AM to 8 AM \\
+ \bottomrule
+\end{longtable}
\subsection{Vicons \& Aicons – aka Video Icons / Audio Icons}%
\label{sub:vicons_aicons_aka_video_icons_audio_icons}
In other words, a lot of media does not begin at the \textit{beginning} point and will not be properly rendered until enough data has been read to assemble a picture.
You can increase the thumbnail size, clarity of pixels (memory size) and color mode but it takes a lot more memory.
Change these values in \texttt{Settings $\rightarrow$ Preferences}, Appearance tab, right hand side of the Layout section -- be aware that when you click OK, your session will re-initialize.
-You can also temporarily increase the preview mini-window by use of the mouse wheel up or down.
+You can also temporarily increase the preview mini-window by use of the mouse wheel up or down for media but not for clips.
There are 4 options for the preview mode.
projects / goodguy / cin-manual-latex.git / blobdiff