\begin{figure}[htpb]
\centering
- \includegraphics[width=\linewidth,keepaspectratio]{images/Fenstergrundposition-en.png}
+ \includegraphics[width=\linewidth,keepaspectratio]{Fenstergrundposition-en.png}
\captionsetup{labelformat=empty, textformat=empty}
\caption[The four windows (cc-by-sa Olaf)]{No text}
\label{fig:Fenstergrundposition-en}
Immediately to the left of the timeline is the patchbay. The patchbay contains options that affect each track.
These options are described in great detail in the Editing section (\ref{sec:patchbay}).
-The \textit{Window} pulldown on the main window contains options that affect the 4 main windows. The first 3 options are used to display each of the windows in case one is accidentally closed. You can
-move or resize the windows as needed, save that particular layout, and revert to the default positions
-to reposition all 4 windows to the original screen configuration.
-On dual headed displays, the \textit{Default positions} operation only uses the one monitor to display the windows, but as you
-can see in the \textit{Window} pulldown you have more options to change that. Usage with dual monitors is
-explained in \ref{sec:multiscreen_playback_configuration}.
+The \textit{Window} pulldown on the main window contains options
+that affect the 4 main windows. The first 3 options are used to
+display each of the windows in case one was accidentally closed.
+You can move or resize the windows as needed, save that particular
+layout, and revert to the default positions to reposition all 4
+windows to the original screen configuration. On dual headed
+displays, the \textit{Default positions} operation only uses the one
+monitor to display the windows, but as you can see in the
+\textit{Window} pulldown you have more options to change that. Usage
+with dual monitors is explained
+in~\ref{sec:multiscreen_playback_configuration}.
\subsection{Video and Audio Tracks and Navigation}%
\label{sub:video_and_audio_tracks_and_navigation}
\begin{figure}[htpb]
\centering
- \includegraphics[width=0.8\linewidth]{images/patchbay.png}
+ \includegraphics[width=1.0\linewidth]{patchbay.png}
\caption{Patchbay | Timeline with pulldowns, navigation icons, Video/Audio tracks | bottom Zoom Panel}
\label{fig:patchbay}
\end{figure}
Then more details are provided in the next paragraphs.
\vspace{2ex}
-\begin{tabular}{ l l }
+\begin{tabular}{ll}
\hline
Sample zoom & Duration visible on the timeline \\
Amplitude & Audio waveform scale \\
It has no function without that flag set.
There are 3 additional pieces of information in the line immediately below the \textit{zoom panel}.
-In the lower left hand corner there could be messages such as "Welcome to Cinelerra" when there is no
+In the lower left hand corner there could be messages such as "Welcome to \CGG{}" when there is no
need to display a red-colored error message or a line that reads "Rendering took H:MM:SS" after a render
has just been completed. Or when working with an auto, a small square the color of that auto line, will be
present along with its keyframe type, location on the timeline, and its current value. This is simply
\item[Move down] moves the selected track one step down in the stack of its corresponding type - audio or video.
\item[Delete track] removes the track from the timeline.
\item[Add Track] adds a track of the same media type as the one selected, audio or video, above the selected track.
- \item[Find in Resources] that media file will be highlighted in the media folder in the Resources window.
+ \item[Find in Resources] that media file will be highlighted in the media folder in the Resources window. If the
+ Resources window is closed, media is found and highlighted but the Resources window is not displayed.
\item[Show edit] will point out the exact start and stop points along with the length of the current edit on
that track as well as the media name, track name and number, and edit number.
\item[User title] is used to change the title name. This is really handy for files that have very long and
In cut and paste editing mode, you can also change the position of the insertion point with a simple
left mouse click in the timeline itself.
When moving the insertion point, the position is either aligned to frames or aligned to samples.
-For best results, "Align cursor on frames" when editing a video track and "Align to samples" when editing audio.
+For best results, \textit{Align cursor on frames} when editing a video track and \textit{Align to samples} when editing audio.
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.
\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]{images/insertion-point.png}};
- \node [yshift=-13mm, xshift=-1cm,anchor=east] at (img1.north west) (Pulldowns) {Pulldowns};
- \node [yshift=-20mm, xshift=-1cm,anchor=east] at (img1.north west) (Transport) {Transport \& Buttons Bar};
- \node [yshift=-27mm, xshift=-1cm,anchor=east] at (img1.north west) (Timebar) {Timebar};
- \node [yshift=-33mm, xshift=-1cm,anchor=east] at (img1.north west) (Title) {Media Title };
- \node [yshift=-43mm, xshift=-1cm,anchor=east] at (img1.north west) (Video) {Video Track};
- \node [yshift=-63mm, xshift=-1cm,anchor=east] at (img1.north west) (Audio) {Audio Track};
- \draw [->, line width=1mm] (Pulldowns) edge ([yshift=-13mm] img1.north west);
- \draw [->, line width=1mm] (Transport) edge ([yshift=-20mm] img1.north west);
- \draw [->, line width=1mm] (Timebar) edge ([yshift=-27mm] img1.north west);
- \draw [->, line width=1mm] (Title) edge ([yshift=-33mm] img1.north west);
- \draw [->, line width=1mm] (Video) edge ([yshift=-43mm] img1.north west);
- \draw [->, line width=1mm] (Audio) edge ([yshift=-63mm] img1.north west);
+ \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}
Then dragging in the timeline repositions that edit and this can be used for moving effects,
changing the order of playlists, or moving video pieces around.
There are numerous methods to cut and paste in \emph{drag and drop mode} by setting In/Out points to define
-a selected region or using the Copy/Paste Behavior as outlined in \ref{sub:copy_paste_behavior}.
+a selected region or using the Copy/Paste Behavior as outlined in~\ref{sub:copy_paste_behavior}.
In this mode, clicking the LMB in the timeline does not reposition the \textit{Insertion Point}.
When the I-beam is highlighted, you are in \emph{cut and paste mode}.
In cut and paste mode, clicking the LMB in the timeline does reposition the \textit{Insertion Point}.
-Double clicking in the timeline selects the entire edit the cursor is over, i.e. that column.
+Double clicking in the timeline selects the entire edit the cursor is over, i.e.\ that column.
Dragging in the timeline with the LMB pressed down, highlights a selected region and this is the region that is affected by cut
and paste operations. It is also the playback range used for the subsequent playback operation.
Holding down the Shift key while clicking in the timeline extends the highlighted region.
\begin{figure}[htpb]
\centering
- \includegraphics[width=0.4\linewidth]{images/i-beam.png}
+ \includegraphics[width=0.4\linewidth]{i-beam.png}
\caption{I-beam + in/out + labels}
\label{fig:i-beam}
\end{figure}
Holding the Shift key while clicking on an In/Out point, the area between the insertion point and that
In/Out point will be highlighted or extended to that In/Out point if already highlighted.
-An easy way to turn off the In/Out points if both are set, is to double click on the [ icon.
+An easy way to turn off the In/Out points if both are set, is to double click on the [ icon in the toolbar.
If you have already set the In and Out points, and then move the insertion point anywhere to the left of
the Out point, a LMB click on the [ icon will move the In point to the location of the insertion point. In the same
manner if you move the insertion point anywhere to the right of the In point, a LMB click on the ] icon
If you LMB click the label button when an area is highlighted, labels are created at each end of the
highlighted area.
When a label is selected, if you click on the label icon, the label will be deleted.
-To delete multiple labels, highlight that area, then use the \texttt{Edit $\rightarrow$ Clear labels}
+To delete multiple labels, highlight that area, then use the \texttt{Edit $\rightarrow$ Clear $\rightarrow$ Clear labels}
function to delete them all. The same precedence rules apply to this operation as mentioned earlier. That
is, if both In/Out points are set and there is a highlighted area also set, the highlighted area's
labels will be cleared and not those between the In/Out points.
as shown in Figure~\ref{fig:settings}. It is disabled by default.
Each media will have a random muted color and there could easily be close duplicates as generated by the program algorithm. There will be no total black, but some dark shades are possible.
-To change a specific clip to your own chosen color, middle mouse button (MMB) over that clip and an Edits popup will be displayed.
+To change a specific clip to your own chosen color, right mouse button (RMB) over that clip and an Edits popup will be displayed.
Choose the option \textit{Bar Color} to bring up the color picker and choose a color.
You can also change the alpha value in the color picker and this alpha takes precedence over the current alpha slider bar value unless the color picker's alpha value is set to 1.0.
The color will only change after you click on the checkmark.
The \emph{Bar Color} option works in either Drag and Drop or Cut and Paste editing mode and also works if \textit{Autocolor assets} is not set.
-In Drag and Drop editing mode, if you select several clips and then bring up the Edits popup with the middle mouse button over a track, you can use the \emph{Bar Color} option to change all of those selected to the same color.
+In Drag and Drop editing mode, if you select several clips and then bring up the Edits popup with the right mouse button over a track, you can use the \emph{Bar Color} option to change all of those selected to the same color.
To go back to the default colors, uncheck \textit{Autocolor assets} in Preferences, but this does not affect the specially chosen self-colored ones as they are preserved.
To change these individually or selectively, use the Edits popup \emph{Bar Color} option and click on \textit{Default} in the color picker window. Auto-color does not honor armed/disarmed tracks.
\begin{figure}[htpb]
\centering
\begin{minipage}[h]{0.55\linewidth}
- \center{\includegraphics[width=0.99\linewidth]{images/autocolor-assets_alpha0.png}} \\ a)
+ \center{\includegraphics[width=0.99\linewidth]{autocolor-assets_alpha0.png}} \\ a)
\end{minipage}
\begin{minipage}[h]{0.4\linewidth}
- \center{\includegraphics[width=0.99\linewidth]{images/autocolor-assets_alpha1.png}} \\ b)
+ \center{\includegraphics[width=0.99\linewidth]{autocolor-assets_alpha1.png}} \\ b)
\end{minipage}
\caption{An example of the Autocolor assets}
\label{fig:autocolor_assets_alpha}
\label{sub:window_layouts}
If you like to use different window layouts than the default for certain scenarios, you can setup, save, and load 4 variations.
-First, position your Cinelerra windows where you want them to be and then use the Window pulldown and choose \emph{Save layout}. Note the words \emph{Save layout} highlighted in Figure~\ref{fig:window_layouts}a with 4 names shown to the right and below of that highlight.
+First, position your \CGG{} windows where you want them to be and then use the Window pulldown and choose \emph{Save layout}. Note the words \emph{Save layout} highlighted in Figure~\ref{fig:window_layouts}a with 4 names shown to the right and below of that highlight.
To use the default name of \textit{Layout \#}, when the popup comes up, just click the green checkmark OK on the Layout popup menu.
If you would like a specific name for your layout so you can remember what its best use case is,
-keyin 1-8 english characters that are meaningful to you (english characters mean you can not use the German umlaut or the French accent).
+keyin 1-8 english characters that are meaningful to you (english characters mean you can not use the German umlaut, the French accent, or the Spanish ñ).
Legal characters are a-z, A-Z, 0-9, \_ (the underscore character) and a limit of 8 total.
If you keyin more than 8, only the last 8 characters will be used.
To rename a currently existing layout, use the \emph{Save layout} option again on the one to rename, and keyin a different name into the text box or leave blank for the default name (figure~\ref{fig:window_layouts}b).
\begin{figure}[htpb]
\centering
\begin{minipage}{.49\linewidth}
- \center{\includegraphics[width=1\linewidth]{images/window_layout1.png}}\\ a)
+ \center{\includegraphics[width=1\linewidth]{window_layout1.png}}\\ a)
%TODO High res image replace
\end{minipage}
\begin{minipage}{.49\linewidth}
\vspace{13ex}
- \center{\includegraphics[width=1\linewidth]{images/window_layout2.png}}\\ b)
+ \center{\includegraphics[width=1\linewidth]{window_layout2.png}}\\ b)
%TODO Alpha channel
\end{minipage}
\caption{Window Layouts}
\subsection{Just Playing!}%
\label{sub:just_playing_}
-What if you are just using Cinelerra to play media and listen to tunes?
+What if you are just using \CGG{} to play media and listen to tunes?
After loading your media, just hit the space bar to start playing and then again to stop playing.
Other than that, use the transport buttons on the top bar of the Program window.
Other ways to \textit{play around} are described next.
\subsubsection*{Repeat Play / Looping Method}%
\label{ssub:repeat_play_looping_method}
-There are 2 methods for repeat play or looping on the timeline and 1 method for both the Compositor and the Viewer. This works in conjunction with any of the transport buttons or shortcuts in either forward or reverse as usual. The 1 exception is that the Shift button can not be used to either add or subtract audio within the repeat area.
+There are 2 methods for repeat play or looping on the timeline and 1 method for both the Compositor and the Viewer. This works in conjunction with any of the transport buttons or shortcuts in either forward or reverse as usual. The 1 exception is that the Shift key can not be used to either add or subtract audio within the repeat area.
\textit{Method 1:} Shift-L on the Timeline, repeats the selection per the algorithm outlined next.
The speed automation causes the playback sampling rate to increase or decrease to a period controlled by the speed automation curve.
This can make playback speed-up or slow-down according to the scaled sampling rate, as \textit{time is multiplied by speed} (Speed $\times$ Unit\_rate). For more information on changing
-the speed, read the section on Speed Automation \ref{sec:speed_fade_automation_gang}.
+the speed, read the section on Speed Automation~\ref{sec:speed_fade_automation_gang}.
\subsubsection*{Alternative to using Numeric Keypad for Playing}%
\label{ssub:alternative_to_using_numeric_keypad_for_playing}
+ Shift key, results in the reverse of whether audio is included or not.
\vspace{1ex}
-+ Ctrl, results in the transport function operating only between the in/out pointers.
++ Shift + Ctrl, results in the transport function operating only between the in/out pointers.
\end{minipage}
\section{Compositor Window}%
\label{sec:compositor_window}
-The Compositor window (figure~\ref{fig:compositor_window}) displays the output of the timeline.
-It is the interface for most compositing operations or operations that affect the appearance of the timeline output.
-Operations done in the Compositor affect the timeline but do not affect clips.
-
\begin{figure}[htpb]
\centering
- \includegraphics[width=0.99\linewidth]{images/compositor_window.png}
- \caption{Upper right side contains navigation tools / bottom bar has manu control functions}
+ \includegraphics[width=0.99\linewidth]{compositor_window.png}
+ \caption{Left hand side are the toolbar functions / bottom bar has many control functions}
\label{fig:compositor_window}
\end{figure}
-\subsection{Compositor controls}%
+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.
+
+\subsection{Compositor Controls}%
\label{sub:compositor_controls}
-
-Navigating the video output does not affect the rendered output; it just changes the point of view in the compositor window.
-The video output has several navigation functions.
-The video output size is either locked to the window size or unlocked with scrollbars for navigation.
-The video output can be zoomed in and out and panned.
-If it is unlocked from the window size, middle clicking and dragging anywhere in the video pans the point of view. Hitting the + and -- keys zooms in and out of the video output.
-
-Underneath the video output are copies of many of the functions available in the main window.
-In addition there is a zoom menu and a tally light.
-The zoom menu jumps to all the possible zoom settings and, through the Auto option, locks the video to the window size.
-The zoom menu does not affect the window size.
-The tally light turns red when rendering is happening. This is useful for knowing if the output is current.
-Right clicking anywhere in the video output brings up a menu with all the zoom levels, zoom auto mode, and some other options.
-In this particular case the zoom levels resize the entire window and not just the video.
-The \emph{Reset camera} and \emph{Reset projector} options center the camera and projector.
-The \emph{Hide controls} option hides everything except the video.
-
-On the left of the video output is a toolbar specific to the compositor window. The toolbar has the following functions:
-
-\emph{Protect video} --- disables changes to the compositor output from clicks in it. It is an extra layer on top of the track arming toggle to prevent unwanted changes.
-
-\emph{Magnifying glass} --- this tool zooms in and out of the compositor output without resizing the window. If the video output is currently locked to the size of the window, clicking in it with the magnifying glass unlocks it and creates scrollbars for navigation.
-
+On the bottom of the window, there are many
+of the same transport buttons and controls that are available in the Program window.
+They work the same as in the Program window and also have tooltips that are visible
+when you mouse over each of the icons so their use is fairly obvious. However,
+of particular note is the button \textit{Click to play} which is described in~\ref{sub:click_to_play_in_viewer_and_compositor}. Next is the \textit{Videoscope} button which is used to enable the scopes window
+without having to apply the filter to the tracks/edits.
+
+Next to all of these controls all the way to the right side, there is a \textit{zoom menu} and a \textit{tally light}. The \textit{zoom menu} has a pulldown with different settings that you can choose from
+or you can just use the tumbler arrows to the right. Generally when just getting started, you
+will be using the default \textit{Auto} option. The window size is not changed, but rather
+the size of the video itself. In addition there are many shortcuts for zooming that you
+will find in the Shortcuts chapter (\ref{cha:shortcuts}).
+
+To resize the entire window instead of just the video, use a RMB click in the compositor
+window which brings up a menu with all the zoom levels, zoom auto mode, and some other options.
+As you would expect, whenever the video is zoomed so that only part of the image is visible
+in the window, scrollbars are automatically added as needed on the bottom, the right hand
+side, or both.
+Other options include \emph{Reset camera} and \emph{Reset projector} which obviously are used
+to reset the camera and the projector.
+The \emph{Hide controls/Show controls} option is great for hiding the left hand toolbar and
+bottom set of controls for a cleaner look.
+
+Next to the zoom tumbler arrows, is a \textit{tally light} that will be filled in with some color
+(often red or blue) when a rendering operation
+is taking place. This is especially helpful when loading a very large video so you know
+when it is finished loading. You should pay attention to this \textit{tally light} when performing
+a particularly time-consuming operation so that you do not keep executing more operations
+that just have to wait until completion of that CPU intensive operation. Also, you should look
+to see if the light is on before assuming that \CGG{} is hung up.
+
+When the window is unlocked, meaning that it is not in \textit{Protect video from changes} mode on the
+toolbar, MMB clicking and dragging anywhere in the video pans the view. Panning can also
+be accomplished with the bottom and right hand side scroll bars when displayed.
+
+\subsection{Compositor Toolbar}%
+\label{sub:compositor_toolbar}
+
+On the left hand side of the Compositor window, there is a toolbar with several icons that
+provide functions for viewing and compositing the video. Each of these operational features
+will be described in more detail next.
\begin{description}
- \item[Left clicking] in the video zooms in;
- \item[Ctrl clicking] in the video zooms out;
- \item[Rotating the wheel] on a wheel mouse zooms in and out.
-\end{description}
-
-In addition, if you enable the Magnifying glass, a zoom slider for fine-viewing appears below these tools.
-It allows you to zoom to most any size.
-A \textit{zoom slider} will pop-up towards the bottom on the left-hand side of the Compositor when you enable \textit{Zoom view} via the magnifying glass or when you click on the icons for \textit{Adjust camera automation} or \textit{Adjust projector automation}.
-This will allow for adjusting the amount of zoom at any level between 0.01 and 100 based on a logarithmic scale.
-When using the zoom slider, the number by which the view is zoomed can be seen in the textbox where the original-also-working \% zoom is located.
-The zoom slider size is in the form of \textit{times}, such as $\times$0.82 which indicates that the picture is zoomed to $\frac{82}{100}^{th}$ of the original size as seen in \texttt{Settings $\rightarrow$ Format}.
+ \item[Protect video from changes] this option makes it possible to disable changes to the
+compositor output when clicking on the Compositor window. It allows for using the
+\textit{Click to play} button (when enabled) for simply starting and stopping play. It helps
+to prevent an accidental click from making unwanted changes. When you enable this option, any
+of the other enabled tools will automatically be disabled.
+
+ \item[Zoom view / magnifying glass] when enabled, the \textit{Zoom view} immediately results
+in the addition of a zoom slider for fine viewing.
+The vertically oriented \textit{zoom slider} will be displayed underneath the last icon of the toolbar and extends
+to almost the end of the toolbar.
+The slider allows for adjusting the amount of zoom at any level between 0.01 and 100 based on a logarithmic scale.
+
+When using the zoom slider, the number by which the view is zoomed can be seen in the textbox
+on the bottom controls where the \% zoom is located.
+The zoom slider size is in the form of \textit{times}, such as $\times$0.82 which indicates that the picture is zoomed to $\frac{82}{100}^{th}$ of the original size as seen in the \texttt{Settings $\rightarrow$ Format} menu.
Once you have set the zoom to the desired size, use the vertical and horizontal scroll bars to position the view as needed.
-
-Screencast (figure~\ref{fig:zoom_slider}) shows below at a zoom slider bar with the diamond shaped slider in the middle. Note
-that the magnifying glass is enabled which automatically pops-up the slider.
+As mentioned earlier, this
+variety of zoom only affects the video and not the resizing of the Compositor window. After
+utilizing this slider bar for zooming around, you may want to switch back to \textit{Auto}
+using the Controls on the bottom of the window.
+This slider bar is also displayed
+when you click on the icons for \textit{Adjust camera automation} or \textit{Adjust projector automation}.
+
+The Compositor window image in figure~\ref{fig:zoom_slider} shows the zoom slider bar with rectangular shaped slider about in the middle. Note that the magnifying glass is enabled which
+automatically pops-up the slider and the Protect video from changes is disabled. Also note that
+there is a scroll bar on the bottom and right side of the image since the image at this magnification
+does not fit in the window.
+The Controls zoom textbox shows $\times0.82$ size.
+\end{description}
\begin{figure}[htpb]
\centering
- \includegraphics[width=0.99\linewidth]{images/zoom_slider.png}
- \caption{A zoom slider bar with the diamond shaped slider in the middle}
+ \includegraphics[width=0.99\linewidth]{zoom_slider.png}
+ \caption{Compositor window zoom slider bar and scroll bars}
\label{fig:zoom_slider}
\end{figure}
-The Format shows a large $5204\times3468$ video and the box at the arrow shows $\times0.82$ size.
-
\begin{description}
- \item[Masks tool] this tool brings up the mask editing tool. Enable \textit{Show tool info} to see the options.
- \item[Camera] the camera brings up the camera editing tool. Enable \textit{Show tool info} to see options.
- \item[Projector] the projector brings up the projector editing tool. Enable \textit{Show tool info} for options.
- \item[Crop tool] this tool brings up the cropping tool. \textit{Show tool info} must be enabled to use this tool.
- \item[Eyedropper] brings up the eyedropper. The eyedropper detects whatever color is under it and stores it
- in a temporary area. Enabling the \textit{Show tool info} shows the currently selected color. Click
- anywhere in the video output to select the color at that point. The eyedropper not only lets you see
- areas which are clipped, but its value can be applied to many effects. Different effects handle the
- eyedropper differently.
- \item[Show tool info] this tool button works only in conjunction with the other controls on the compositor.
- Based on what compositing control is active, the toggle button will activate or deactivate the
- appropriate control dialog box. Controls with dialog boxes are: Edit mask, Camera and Projector
- automation, Crop control, and Get color.
- \item[Safe regions tool] draws the safe regions in the video output. The largest (external) square is called \textit{action safe overlay}; the smallest internal square is called \textit{title safe overlay}. They are especially useful if the destination is the TV. This does not affect the rendered output
+ \item[Edit mask] brings up a mask editing menu with many versatile options as
+described in great detail later in this section (\ref{sub:masks}). You may also have to click on
+\textit{Show tool info} to popup the menu depending on whether or not you dismissed that window previously.
+ \item[Ruler] this can be a handy tool to get the X,Y coordinates of an exact point or to
+measure the distance between 2 points. To use the \textit{Ruler}, move the mouse on the video to
+get to the desired spot - these X,Y coordinates will be displayed in the \textit{Current} text
+box. Clicking the LMB creates Point 1 and then continue to hold down the LMB so that a ruler line is created between
+this Point 1 and the stopping Point 2. \textit{Deltas} is the X,Y difference between the 2 points;
+\textit{Distance} is the number of pixels between the 2 points; and \textit{Angle} is the angle in degrees of the ruler line.
+In Figure~\ref{fig:safe_regions} you can see the Ruler menu on the right side of the Compositor window.
+
+Holding down the Ctrl key while dragging with the LMB on one of the points, will
+ensure that the line is always at a multiple of a 45 degree angle. Holding down the Alt key while
+dragging with the LMB on any of the points, will translate the ruler line to another place on
+the video while maintaining its length and angle. For some desktop window managers, such as
+\textit{UbuntuStudio 16.4} and \textit{Arch}, the Alt key is already in use by the Operating System
+so you will have to use Alt+Ctrl instead.
+If you dismiss the Ruler menu, click on
+\textit{Show tool info} to get the menu to popup again.
+ \item[Adjust camera automation] the camera brings up the camera editing tool. Enable \textit{Show tool info} if the popup menu does not appear. More detail for usage is provided in the subsequent
+section~\ref{sub:camera_and_projector}.
+ \item[Adjust projector automation] the projector brings up the projector editing tool. Enable \textit{Show tool info} to get the menu to popup again. More detail for usage is provided in the
+subsequent section~\ref{sub:camera_and_projector}.
+ \item[Crop a layer or output] this is a cropping tool used to reduce the visible picture area.
+More detail for usage is provided in a
+subsequent paragraph (\ref{sub:cropping}). There is also a Crop \& Position plugin that provides
+a different set of capabilities~\ref{sub:crop_position}.
+ \item[Get color / eyedropper] brings up the eyedropper used to detect the color at a
+particular spot. Enable the \textit{Show tool info} if the Color popup menu does not come up
+automatically or if that menu was accidentally dismissed. Click on a specific color in the video
+output with the LMB to see the selected color. You can then use that color's
+value to be applied to some effects depending on how the effect handles the eyedropper.
+ \item[Show tool info] this tool button is used in conjunction with the other tools on the
+compositor's toolbar. You only need to click on this if one of these tools popup menu does not
+come up or has been dismissed - Mask, Ruler, Camera, Projector, Crop, or Eyedropper tools.
+You can also use it when highlighted to dismiss the highlighted tool's dialog box.
+It is not needed for Protect video from changes, Zoom view, and Show safe regions since they have
+no dialog popup menus.
+
+\begin{figure}[htpb]
+ \centering
+ \includegraphics[width=0.9\linewidth]{safe_regions.png}
+ \caption{Note the black outlines showing the safe regions. Also note the Ruler menu}
+ \label{fig:safe_regions}
+\end{figure}
+
+ \item[Show safe regions] draws 2 outlines to display the safe regions in the video as you
+can see in Figure~\ref{fig:safe_regions}.
+On some particular TVs/monitors/displays, the borders of the image are cut off and that
+cut off section might not be as square as it appears in the compositor window.
+These are especially useful if the device for the output display is an older model TV\@.
+The outside largest outline is the \textit{action safe overlay}; whereas the inside smallest
+outline is the \textit{title safe overlay}.
+
+Using the \textit{Show safe regions} has no affect on the rendered output.
+The purpose of showing the borders is to make it easy to see where it might be cut off. This
+area outside the safe region can then be used as
+a scratch or vertical blanking space. Enabling the safe regions makes it really
+easy to see these borders so that you can make sure
+titles are inside the inner outline and actions are inside the outer outline.
+
\end{description}
\subsection{Compositing}%
\label{sub:compositing}
-A large amount of Cinelerra's editing is directed towards compositing.
-Changing the resolution of a show, making a split screen, and fading in and out among other things are all compositing operations in Cinelerra.
-Cinelerra detects when it is in a compositing operation and plays back through the compositing engine only then.
-Otherwise, it uses the fastest decoder available in the hardware.
+Much of the editing in \CGG{} involves "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
+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.
-Compositing operations are done on the timeline and in the Compositor window. Shortcuts exist in the Resource window for changing some compositing attributes.
-Once some video files are on the timeline, the compositor window is a good place to try compositing.
+\subsection{The Temporary, Track and Output Sizes}%
+\label{sub:track_and_output_sizes}
+
+This section explains a few things which help to understand Compositing - especially with relation
+to the camera, effects, and the projector.
+
+\subsubsection*{The Temporary}%
+\label{ssub:output_size}
+
+\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.
+
+\subsubsection*{Track and Output size}%
+\label{ssub:track_size}
+
+The \textit{Track size} is used to define the temporary size with each track having a different size.
+You can see or set the track size by RMB click on a track and then select \emph{Resize Track} to resize
+the track to any size. Or select \emph{Match output size} to make the track the same size as the
+output. When a track is resized what it looks like on the compositor changes. The relationship
+between the track and the project's output size makes it possible to magnify or reduce the size of
+a track in regards to the final output. This feature means you cancreate visual effects such as split
+screens, zooms, and pans in the compositor.
+
+The \textit{Output size} can be set in \texttt{File $\rightarrow$ New} when creating a new project,
+or by using \texttt{Settings $\rightarrow$ Format}, or in the Resources window with RMB click on
+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. 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.
\subsection{Camera and Projector}%
\label{sub:camera_and_projector}
-In the compositor window, two of the more important functions are the adjust camera automation and the adjust projector automation which control operation of the camera and projector.
-Cinelerra's compositing routines use a \textit{temporary}, a frame of video in memory where all graphics processing is performed.
-Inside Cinelerra's compositing pipeline, the camera determines where in the source video the \textit{temporary} is copied from.
-The projector determines where in the output the \textit{temporary} is copied to (figure~\ref{fig:temporary-01}).
-Each track has a different \textit{temporary} which is defined by the track size. By resizing the tracks you can create split screens, pans, and zooms.
+In the compositor window, \textit{Adjust camera automation} and \textit{Adjust projector automation}
+are editing tools to control operation of the camera and projector. In \CGG{}'s compositing
+pipeline, the camera determines where in the source the \textit{temporary} is copied from while
+the projector determines where in the output the \textit{temporary} is copied to
+(figure~\ref{fig:temporary-01}).
\begin{figure}[htpb]
\centering
- \includegraphics[width=0.8\linewidth]{images/temporary-01.pdf}
+ \includegraphics[width=0.8\linewidth]{temporary-01.pdf}
\caption{Compositing pipeline}
\label{fig:temporary-01}
\end{figure}
-In compositing, each frame can be digitally altered using various options, such as a color correction plugin (figure~\ref{fig:camera_and_projector}).
-Once the image has been transformed, the finished image is then projected to the compositor thus creating a modified version of the original.
+In compositing, each frame can be changed using various options and plugins, such as
+a color correction plugin (figure~\ref{fig:camera_and_projector}). After the image has been
+modified, the final image is projected to the compositor so that you now have a changed original.
\begin{figure}[htpb]
\centering
- \includegraphics[width=0.8\linewidth]{images/camera_and_projector.png}
- \caption{Color balance on Temporary}
+ \includegraphics[width=0.8\linewidth]{camera_and_projector.pdf}
+ \caption{Color3way on Temporary}
\label{fig:camera_and_projector}
\end{figure}
-When editing the camera and projector in the compositing window, the first track with record enabled is the track affected.
-Even if the track is completely transparent, it is still the affected track.
-If multiple video tracks exist, the easiest way to select one track for editing is to Shift-click on the record icon of the track.
-This solos the track.
-
-The purpose of the projector is to place the contents of the \textit{temporary} into the project's output.
-The intent of the projector is to composite several sources from the various tracks into one final output track.
-The projector alignment frame is identical to the camera's viewport, except that it guides where on the output canvas to put the contents of each temporary.
-
-\subsubsection*{Compositing projector controls}%
-\label{ssub:compositing_projector_controls}
-
-When the projector button is enabled in the compositor window, you are in projector editing mode. A guide box appears in the video window. The red box indicates the size of the frame that will be sent to the Ouput. You can drag the box with LMB, moving the frame in $x$ and $y$ as you like. Even when moving along the $z-axis$ (i.e. the zoom, with SHIFT+Drag) the red box faithfully follows the movement and size of the frame. Once you have positioned the video with the projector, you may want to work with adjusting the camera automation.
-
-\subsubsection*{Viewport sizes}%
-\label{ssub:viewport_sizes}
-
-The viewport is a window on the camera that frames the area of source video to be scanned.
-The initial size of the viewport is defined by the size of the current track. A smaller viewport ($640\times400$) captures a smaller area.
-A larger viewport ($800\times200$) captures an area larger than the source video and fills the empty spaces with blanks.
-Once we have our viewport defined, we still need to place the camera right above the area of source video we are interested on. To control the location of the camera:
+When editing the camera and projector in the compositing window, the affected track will be the
+first track that is armed. If there are multiple video tracks, you can select one specific track
+for editing with a LMB click on the \textit{Arm track} icon of the desired track. This is called
+"solo" the track. To reverse this solo-ing, LMB click on the icon again.
+
+\subsubsection*{Projector Compositing}%
+\label{ssub:projector_compositing}
+
+The purpose of the \textit{projector} is to composite several sources from various tracks into one
+output track. The projector alignment frame is the same as the camera's viewport, except that it
+shows where to put the contents of each temporary on the output canvas. To get into projector
+editing mode, click on the \textit{Adjust projector automation} icon in the Compositor toolbar. You
+will then see red border lines surrounding the image and 2 diagonal lines criss-crossing in the
+middle, displayed in the video window. The red outline indicates the size of the frame that will be
+sent to the Output. You can easily drag the box with LMB, moving the frame in $x$ and $y$ directions.
+When moving along the $z-axis$ (i.e.\ the zoom, with SHIFT+Drag) the box exactly follows the movement
+and the size of the frame. After you position the video with the projector, you may next want to
+\textit{Adjust camera automation}.
+
+\subsubsection*{The Viewport}%
+\label{ssub:viewport}
+
+The \textit{viewport} is a window on the camera that frames the area of source video. The size of
+the current track is used for the initial size of the viewport. A smaller viewport, for example
+($640\times480$), captures a smaller area; whereas a larger viewport of ($800\times600$) captures
+a larger area. If the captured area is larger than the source video, the empty spaces will be
+automatically filled with blanks. After the viewport is defined, the camera needs to be placed
+right above the area of interest in the source video. Operations to control the location of the
+camera are as follows:
\begin{enumerate}
- \item Open the compositor window with a track selected.
- \item Select the camera button to enable camera editing mode.
- \item Drag over the display window.
+ \item In the compositor window you should see the selected track.
+ \item LMB click on the \textit{Adjust camera automation} to bring up the editing menu and the
+green and yellow colored outlines.
+ \item Use the LMB to drag the video over the display in the compositor window to the desired
+placement.
\end{enumerate}
-When we drag over the viewport in the compositor window, the way it looks is as if you \textit{move the camera with the mouse}. The viewport also moves with it.
+When you drag over the viewport in the compositor window, it looks like you are moving the camera
+with the mouse. The viewport moves in the same manner.
-\subsubsection*{Compositing camera controls}%
-\label{ssub:compositing_camera_controls}
+\subsubsection*{Camera Compositing}%
+\label{ssub:camera_compositing}
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.
-\subsubsection*{The camera and projector tool window}%
-\label{ssub:the_camera_and_projector_tool_window}
+\subsubsection*{Camera and Projector Menu}%
+\label{ssub:camera_and_projector_menu}
The camera and projector have shortcut operations that do not appear in the popup menu and are not represented in video overlays.
-These are accessed in the \emph{Show tool info} window .
+These are accessed in the \emph{Show tool info} window.
Most operations in the Compositor window have a tool window which is enabled by activating the question mark icon (figure~\ref{fig:camera_tool}).
-\begin{wrapfigure}[12]{O}{0.3\linewidth}
- \vspace{-2ex}
- \includegraphics[width=0.9\linewidth]{images/camera_tool.png}
+\begin{wrapfigure}[10]{O}{0.45\linewidth}
+ \vspace{1ex}
+ \includegraphics[width=1.0\linewidth]{camera_tool.png}
\caption{Camera and Projector tool}
\label{fig:camera_tool}
\end{wrapfigure}
Justification types are also defined for easy access.
A popular justification operation is upper left projection after image reduction.
This is used when reducing the size of video with aspect ratio adjustment.
-In the last figure you see the choices for justification as the red stripe in the 6 boxes in the order of left, center horizontal, right, top, center vertical, and bottom.
+In the last figure you see the choices for justification as the location of the line in the 6 boxes in the order of left, center horizontal, right, top, center vertical, and bottom.
The translation effect allows simultaneous aspect ratio conversion and reduction but is easier to use if the reduced video is put in the upper left of the \textit{temporary} instead of in the center.
The track size is set to the original size of the video and the camera is centered.
\label{ssub:use_case_interaction_camera_projector}
\begin{enumerate}
- \item Start by shrinking the projector to $z=0,500$ ($\frac{1}{4}$ of the original frame).
- \item The next step is to switch to the camera and note that the green box has assumed the size of the projector, i.e. the red box. The value of $z$ of the camera is always equal to $1,000$ (default) but the frame is $\frac{1}{4}$ of the original frame, i.e. it has the size of the projector that has $z=0,500$. This is the current viewport size.
- \item You enlarge the room bringing $z=2,000$. You can see that the dimensions of the viewport (green box) do not change, remaining the same as those of the projector. However, the frame has been enlarged and this variation is indicated by the enlargement of the yellow box. Let's remember that this follows the changes made with the camera tool.
+ \item Start by shrinking the projector to $z=0.500$ ($\frac{1}{4}$ of the original frame).
+ \item The next step is to switch to the camera and note that the green box has assumed the size of the projector, i.e.\ the red box. The value of $z$ of the camera is always equal to $1.000$ (default) but the frame is $\frac{1}{4}$ of the original frame, i.e.\ it has the size of the projector that has $z=0.500$. This is the current viewport size.
+ \item You enlarge the room bringing $z=2.000$. You can see that the dimensions of the viewport (green box) do not change, remaining the same as those of the projector. However, the frame has been enlarged and this variation is indicated by the enlargement of the yellow box. Let's remember that this follows the changes made with the camera tool.
\item We can drag the room so that we can center the frame to our liking. The movement of the yellow box shows well the variation compared to the green box.
\item Finally, if we want, we can switch to the projector tool to move the output frame to the position we want with respect to the size of the source. Of course, we can also work on the $z$, which in the example is at $z=0.500$, if we have decided to change the size of the output.
\end{enumerate}
\subsection{Masks}%
\label{sub:masks}
-Masks select a region of the video for either displaying or hiding.
-Masks are also used in conjunction with another effect to isolate the effect to a certain region of the frame.
-A copy of one video track may be delayed slightly and unmasked in locations where the one copy has interference but the other copy does not.
-Color correction may be needed in one subsection of a frame but not another.
-A mask can be applied to just a subsection of the color corrected track while the plain track shows through.
-Removal of boom microphones and airplanes are a common kind of mask uses.
+Masks can be used to accomplish various tasks but basically are used to select an area of the
+video to be displayed or hidden.
+They can be used in conjunction with another effect to isolate the effect to a certain region.
+Another usage is where you slightly delay one video track copy and unmask an area where
+the one copy has interference but the other copy does not. Or use a mask when color correction is
+needed in one part of a frame but not another. A mask can be applied to just a small section of
+a color corrected track while a plain track shows through.
+Removal of boom microphones, license plates, people and airplanes via mask is a very common usage.
-The order of the compositing pipeline affects what can be done with masks. Mainly, masks are performed on the temporary after effects and before the projector. This means multiple tracks can be bounced to a masked track and projected with the same mask.
+The order of the compositing pipeline affects how masks are done. Usually masks are operated on the
+temporary, after the effects but before the projector. Because of the way this works, multiple
+tracks can be bounced to a masked track and projected with the same mask.
The compositing pipeline graph has a masking stage (figure~\ref{fig:temporary-02}).
\begin{figure}[htpb]
\centering
- \includegraphics[width=0.7\linewidth]{images/temporary-02.pdf}
- \caption{compositing pipeline with mask}
+ \includegraphics[width=0.7\linewidth]{temporary-02.pdf}
+ \caption{Compositing pipeline with mask}
\label{fig:temporary-02}
\end{figure}
-There are 8 possible masks per track. Each mask is defined separately, although they each perform the same operation, whether it is addition or subtraction.
-
\subsubsection*{Compositing pipeline with masks}%
\label{ssub:compositing_pipeline_with_masks}
+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.
\begin{enumerate}
- \item To define a mask, go into the Compositor window and enable the mask toggle.
- \item Next go over the video and click-drag.
- Note: You have to select automatic keyframes if you wish to move a mask over time.
- If you do not, the mask position will be the same even if you edit at different places on the timeline.
- \item Click-drag again in another part of the image to create each new point of the mask.
- While it is not the conventional Bezier curve behavior, this masking interface performs in realtime what the effect
- of the mask is going to be. Creating each point of the mask expands a rubber band curve.
-
- Once points are defined, they can be moved by Ctrl-dragging in the vicinity of the corner.
- Shift-drag allows you to move existing points to new locations, thus altering the shape of the mask.
- However, this does not smooth out the curve.
- The end points of the Bezier curve are accessed by Ctrl-dragging in the vicinity of the corner.
- Then Ctrl-dragging near the end point causes the point to move.
- Shift-drag activates bezier handles (control points) to create curves between mask points.
-
- \item Finally once you have a mask, the mask can be translated in one piece by Alt-dragging the mask.
- The effect of the mask is always on.
- Ctrl-Alt-drag translates an entire mask to a new location on the
- screen.
+ \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.
+ \item Then LMB click on another spot of the image to create each new point of the mask. Once
+you have at least 3 points, lines will be drawn between them, but you can just create as many
+more points as you need and the lines will be redrawn to cover all points. When you
+create each point of the mask a straight line curve is expanded, altering the shape of the mask.
+The mask position will always be in the same position on each image of the video unless you enable
+\textit{Generate keyframes while tweaking} on the Program window Transport and Buttons bar. Then when
+enabled you can move a mask over time.
+ \item For a mask to be seen or not seen, there must be another video track under the track
+that you are viewing in the compositor. An easy way to see the masked area is to just add an empty track
+below the target track and drag the \textit{Gradient} plugin to a highlighted area on that track.
+ \item You can move existing points to new locations by simply using the LMB at a point to
+drag that point to a different location.
+ \item The mask can be translated as a single entity by Alt-dragging the mask. For some desktop
+window managers, such as \textit{UbuntuStudio 16.4} and \textit{Arch}, the Alt key is already in use
+by the Operating System so you will have to use Alt+Ctrl instead.
+ \item To create curved instead of straight lines between the points, use Ctrl-drag on a
+specific point. Using Ctrl-drag activates bezier handles (control points) to create these curves
+between the points. For example, on a mask with just two points, you can create a romantic heart mask.
\end{enumerate}
-The masks have many more parameters which could not be represented with video overlays.
-These are represented in the tool window for masks.
-Selecting the question mark when the mask toggle is highlighted brings up the mask options window (figure~\ref{fig:mask_window}).
+There are a lot more operations you can do using the Mask menu as shown in
+figure~\ref{fig:mask_window}. Detailed description is provided here next. Note that the Mask
+window is separated into various sections to make it easier to locate the area of interest.
\begin{figure}[htpb]
\centering
- \includegraphics[width=0.5\linewidth]{images/mask_window.png}
+ \includegraphics[width=0.5\linewidth]{mask_window.png}
\caption{Mask options window}
\label{fig:mask_window}
\end{figure}
-Masking has been greatly improved compared to the original tool. Detailed description is provided here. Note that the Mask window is separated into various sections to make it easier to locate the area of interest.
-
\subsubsection*{Masks on Track section}%
\label{ssub:masks_track_section}
-The \textit{Track}: textbox displays the different video tracks for your session which will be initially set to the first armed video track or will be left blank if there are no armed tracks. A pulldown to the right of the box brings up the names of all of the video tracks allowing you to change to which track the masking applies. You can also just use the tumbler to easily mouse up/down to get to the desired track. In the pulldown list, any track that has red colored text is disarmed so that you can not change it. A track that contains masks has yellow colored text for easy identification. Only when there are no masks on the track, do you have the default text color. This textbox is display only and you can not type into it.
+The \textit{Track}: textbox displays the different video tracks for your session which will be initially set to the first armed video track or will be left blank if there are no armed tracks. A pulldown to the right of the box brings up the names of all of the video tracks allowing you to change to which track the masking applies. You can also just use the tumbler to easily mouse up/down to get to the desired track. In the pulldown list, any track that has a red colored text name is disarmed so that you can not change it. A track that contains masks has yellow colored text for easy identification. Only when there are no masks on the track, do you have the default text color. This textbox is display only and you can not type into it.
-The \textit{Solo} button in the Masks on Track section of the Mask window is very handy when working with masks on different tracks. It displays only that track so that you only see the track you choose, as well as the tracks behind it to show the mask part. The Solo button is just a convenience to prevent having to mouse over to the patchbay.
+The \textit{Solo} button in the Masks on Track section of the Mask window is very handy when working with masks on different tracks. It displays just that track so that you see only the track you choose, as well as the tracks behind it to show the mask part. The Solo button is just a convenience to prevent having to mouse over to the patchbay.
\subsubsection*{Masks section}%
\label{ssub:masks_section}
There are 4 shapes that are automatically available for usage as masks – square, circle, triangle, and oval. In addition, the next 3 symbols in this section are for the purpose of loading, saving, and deleting your own customized shapes. The first symbol, \textit{Load} preset, will bring up a list of your previously saved presets. Clicking on \textit{Save} preset brings up a popup window allowing you to provide a name used to identify the preset you want to save, along with a pulldown to see the names of your other saved presets. Clicking on \textit{Delete} preset also brings up a textbox with a pulldown to choose which one to delete. There is a file, called \texttt{mask\_rc}, in \texttt{\$HOME/.bcast5} that records your custom masks.
-When you click \textit{Load} preset, keep in mind that it will write the mask number that you have selected so if you already have a mask at that location, it will write over it – just UNDO to revert to the previous if you made this mistake.
+When you click \textit{Load} preset, keep in mind that it will write the mask number that you have selected so if you already have a mask at that location, it will write over it – just \textit{Undo mask} under the main window Edit pulldown (shortcut `z') to revert to the previous if you made this mistake.
\subsubsection*{Position \& Scale section}%
\label{ssub:position_scale_section}
\textit{Center} mask button allows for quickly centering a mask on the video track.
\textit{Normalize} mask button makes it easy to normalize the size of the mask based on the scale of the video.
-The next 3 symbols concern the direction to \textit{drag translate} a mask using the \texttt{Alt+LMB} thus making it easy to preserve the current $X$ or $Y$ value when desirable.
+The next 3 symbols concern the direction to \textit{drag translate} a mask using the \texttt{Alt+LMB} thus making it easy to preserve the current $X$ or $Y$ value when desirable. For some desktop window managers,
+such as \textit{UbuntuStudio 16.4} and \textit{Arch}, the Alt key is already in use by the Operating System
+so you will have to use Alt+Ctrl instead.
\texttt{xlate/scale x} - drag translate constrained in the $X$ direction
The \texttt{Fade}: textbox is used to type in a fade value; the tumbler to the right of the textbox allows you to increase or decrease that number; and the slider bar makes it quick to adjust the fade value. The fader goes from $-100$ on the left to $+100$ on the right for negative to positive. Default value is $+100$. The fade slider includes a sticky point at 0 so that it is easy to get to 0 without going too far or not quite far enough -- that way you don’t have to keep jiggling to get there.
-In addition there is a \textit{Gang fader} symbol to allow for having all of the masks fade in unison. The symbol is surrounded by a gold colored background when it is in effect. If you have multiple masks with different modes, a decision had to be made on what value to use -- it uses the maximum transparency value of the background to determine the operations results. To understand how this works, here is a summary:
+In addition there is a \textit{Gang fader} symbol to allow for having all of the masks fade in unison. The symbol is surrounded by a green colored background (in the default theme) when it is in effect. If you have multiple masks with different modes, a decision had to be made on what value to use -- it uses the maximum transparency value of the background to determine the operations results. To understand how this works, here is a summary:
Note1: The area outside the mask is referred to as the background.
The \textit{X:} and \textit{Y:} coordinates mark the value of the current \textit{Pivot Point} used for rotation, scaling, and translation. You can either directly key in numerical values or use the tumblers to change the values as long as the \textit{Focus} checkbox is checked.
The \textit{Focus} checkbox is used in case you want to set a different point in the Compositor for pivoting instead. And the \textit{Gang} symbol for rotate/scale/translate means that these operations will be performed on all points of the enabled masks. The gang symbol is surrounded by a gold colored background when it is in effect. When performing a rotate operation on a mask with the mouse wheel, \textit{acceleration} is in effect -- this means the faster you wheel, the more space is covered so that you do not have to wheel dozens of time to make a full rotation. Then when you wheel around slower, you can fine tune the result.
+Note that in order to be able to rotate/scale around pointer, the Focus checkbox must be unchecked.
\subsubsection*{Other sections}%
\label{ssub:other_sections}
Finally there are the \textit{Apply masks before plugins} and \textit{Disable OpenGL masking} self-explanatory checkboxes.
-Note: Not all OpenGL software can support the current masking methods. If your opengl implementation does not support Shader Version 4.3 or has trouble with this (it is relatively new to opengl at the time this was implemented), then this checkbox will allow you to use the software masking to avoid any potential issues. Normally, a OpenGL is probed for the shader version and will automatically use the software implementation if required.
+Note: Not all OpenGL software can support the current masking methods. If your opengl implementation does not support Shader Version 4.3 or has trouble with this (it is relatively new to opengl at the time this was implemented), then this checkbox will allow you to use the software masking to avoid any potential issues. Normally, OpenGL is probed for the shader version and will automatically use the software implementation if required.
The \textit{Help} checkbox can be enabled in order to see a list of the keys used to perform various operations. If you use Masking infrequently, these are a valuable reminder to which key combinations to use. Currently they are as follows:
\vspace{2ex}
-\begin{tabular}{ l l }
+\begin{tabular}{ll}
\hline
Shift+LMB & move an end point \\
Ctrl+LMB & move a control point \\
Alt+LMB & to drag translate the mask \\
Shift+MMB & set Pivot Point at pointer \\
Wheel & rotate around Pivot Point \\
- Ctrl+Shift+Wheel & scale around Pivot Point \\
+ Shift+Wheel & scale around Pivot Point \\
Ctrl+Wheel & rotate/scale around pointer \\
\hline
\end{tabular}
+\subsubsection*{Key Alternatives}%
+\label{ssub:key_alternatives}
+
\vspace{2ex} Note: For some desktop window managers, certain keys may already be in use by the operating system, so you will either have to redefine them in your desktop or use different key combinations. For example, at least some desktops used with \textit{UbuntuStudio 16.04} and \textit{Arch} field the \texttt{Alt} key, thus requiring alternative key combinations to be needed. Below are some of these alternatives.
\vspace{2ex}
-\begin{tabular}{ l p{11cm}}
+\begin{tabular}{lp{11cm}}
\hline
LMB & move/create an end point (to move the end point the pointer must be above the point) \\
Shift+LMB & move an end point (the pointer may be near the point, not above it) \\
Focus checkbox = unchecked:
\vspace{2ex}
-\begin{tabular}{ l l }
+\begin{tabular}{ll}
\hline
Wheel & rotate around Pivot Point \\
Shift+Wheel & scale around Pivot Point \\
Focus checkbox = checked:
\vspace{2ex}
-\begin{tabular}{ l l }
+\begin{tabular}{ll}
\hline
Wheel & rotate around Pivot Point (“Custom focus point”) \\
Shift+Wheel & scale around Pivot Point (“Custom focus point”) \\
\end{tabular}
\vspace{2ex}
-Note: in order to be able to rotate/scale around pointer, the Focus checkbox must be unchecked.
\subsection{Cropping}%
\label{sub:cropping}
-Cropping reduces the visible picture area of the whole project. It changes the values of the output dimensions (width and height in pixels) and the $X, Y$ values of the projector in a single operation. Since it changes project settings it affects all the tracks for their entire duration and it is not keyframable.
+Cropping is used to reduce the visible picture area by changing the output dimensions, width and
+height in pixels, and the $X, Y$ values. An example of cropping and the crop menu is seen in
+figure~\ref{fig:cropped_area}.
+The easiest way to use cropping is to click with the LMB
+at the spot to begin cropping and while holding down the LMB, drag the mouse. This creates a rectangular
+cropping area. To change the size/location of that area, click on any of the 4 corner points
+with the LMB and drag. While dragging, you will see
+the X1, Y1 coordinates and W for width, H for height, in the Crop tool popup menu
+automatically change numerical value to reflect the current position. For precise locations, you
+can keyin exact values into those textboxes instead of using the mouse.
+Once you have the crop area defined as you want it, then click on the \textit{Apply} button to have
+the actual cropping take affect.
+
+There are 3 choices of crop methods to choose in the menu pulldown on the bottom right side.
+\begin{enumerate}
+ \item Reformat - Reformat Session crops and changes the Format for the entire session.
+Because the Format is changed, this is applied to all tracks in the project.
+The part of the image outside the rectangle will be cut off and the projector will make the video fit.
+The \texttt{Settings $\rightarrow$ Format} window will show the new project Width and Height values and
+the projector tool window will show the new $X, Y$ values. Track size remains unchanged.
+You can undo the cropping by entering the original project dimensions in the
+\texttt{Settings $\rightarrow$ Format} window for the Width and Height. You will also have to use the Projector
+tool in the Compositor toolbar to \textit{Ajdust projector automation} by clicking on the Reset icon.
+ \item Resize - Resize Projector; to undo this, enable \textit{Adjust projector automation}
+and do a Reset.
+ \item Shrink - Resize Projector and Camera; to undo this, enable each of the \textit{Adjust
+projector and camera automation} tools, one at a time, and do a Reset in the menus.
+\end{enumerate}
+An important note here is that the original aspect ratio will be maintained so if your frame is
+rectangular (as many are) and you "crop" by surrounding the region of interest with a square,
+the cropped area will be more than you marked in order to keep the aspect rectangular shape.
+The Resize and Shrink options are applicable to all video tracks except the disarmed ones.
+This is in contrast to the Reformat option, as mentioned previously, which applies to all tracks even if disarmed because it changes the Format for the session.
+One last note of interest, this cropping is keyframable.
\begin{figure}[htpb]
\centering
- \includegraphics[width=0.5\linewidth]{images/cropped_area.png}
- \caption{Cropped area is in the top right corner}
+ \includegraphics[width=0.9\linewidth]{cropped_area.png}
+ \caption{Crop menu and outlined crop rectangle on the right side}
\label{fig:cropped_area}
\end{figure}
+An easy to follow step by step usage of the cropping tool is outlined next.
\begin{itemize}
- \item Enable the crop toggle and the tool window in the compositor window to display the Crop control dialog box.
- \item Click-drag anywhere in the video to define the crop area. This draws a rectangle over the video.
- \item Click-drag anywhere in the video to start a new rectangle.
- \item Click-drag over any corner of the rectangle to reposition the corner.
- \item Alt-click in the cropping rectangle to translate the rectangle to any position without resizing it.
- \item The crop control dialog allows text entry of the top left coordinates ($X1,Y1$) and bottom right coordinates ($X2,Y2$) that define the crop rectangle. When the rectangle is positioned, hit the \emph{Do it} button in the crop control dialog to execute the cropping operation: the portion of the image outside the rectangle will be cut off and the projector will make the output fit the canvas.
- \item The \textit{Set Format} window will show the new project Width and Height values.
- \item The projector tool window will show the new $X, Y$ values.
- \item Track size will remain unchanged.
+ \item Enable the crop tool in the compositor window to display the Crop popup menu.
+ \item Click-drag in the video to define the crop area which draws a rectangle on the video.
+ \item Click-drag in the video to start a different rectangle instead.
+ \item Click-drag on a corner of the rectangle to reposition that corner.
+ \item Alt-click in crop rectangle to translate the rectangle to a different position without resizing.
+ \item The crop popup menu allows text entry of the top left coordinates ($X1,Y1$) and width and
+height ($W, H$) that define the crop rectangle.
+ \item Choose one of the 3 options of Reformat, Resize, or Shrink.
+ \item When you have the rectangle where you want it,
+click on the \emph{Apply} button in the menu to actually perform the crop operation.
\end{itemize}
-To undo the cropping enter the original project dimensions in the \textit{Set Format} window and click on \textit{Reset projector} in the popup menu of the compositor.
-
-\subsection{Safe Regions}%
-\label{sub:safe_regions}
-
-On consumer displays the borders of the image are cut off and within the cut-off point is a region which is not always square like it is in the compositor window.
-The borders are intended for scratch room and vertical blanking data.
-You can show where these borders are by enabling the safe regions toggle.
-Keep titles inside the inner rectangle and keep action inside the outer rectangle.
-
-\begin{figure}[htpb]
- \centering
- \includegraphics[width=0.5\linewidth]{images/safe_regions.png}
- \caption{Note the black frames showing the safe regions}
- \label{fig:safe_regions}
-\end{figure}
-
-\subsection{Track and Output Sizes}%
-\label{sub:track_and_output_sizes}
-
-
-The size of the temporary and the size of the output in our compositing pipeline are independent and variable.
-The camera's viewport is the temporary size.
-Effects are processed in the temporary and are affected by the temporary size.
-Projectors are rendered to the output and are affected by the output size.
-If the temporary is smaller than the output, the temporary is bordered by blank regions in the output.
-If the temporary is bigger than the output, the temporary is cropped.
-
-\subsubsection*{Track size}%
-\label{ssub:track_size}
-
-The temporary size is defined as the track size.
-Each track has a different size.
-Right click on a track to bring up the track's menu.
-Select \emph{Resize Track} to resize the track to any arbitrary size.
-Alternatively you can select \emph{Match output size} to make the track the same size as the output.
-If you resize a track, then its appearance on the compositor changes accordingly.
-Using the relationship between the track and the project's output size you can effectively reduce or magnify the size of a particular track with regards to the final output and therefore create visual effects like split screens, pans, and zooms on the compositor.
-
-\subsubsection*{Output size}%
-\label{ssub:output_size}
-
-
-The output size is set in either \texttt{File $\rightarrow$ New} when creating a new project or \texttt{Settings $\rightarrow$ Format}.
-In the Resources window there is another way to change the output size.
-Right click on a video asset and select \emph{Match project size} to conform the output to the asset.
-When new tracks are created, the track size always conforms to the output size specified by these methods.
-
-When rendering, the project's output size is the final video track size where the temporary pipeline is rendered into.
-If the output size is larger than the temporary then the image transferred from the temporary will fit inside the Output Track.
-Any space left on the Output is left blank.
-If the output size is smaller than the temporary then some of the temporary video will be cropped.
\section{Viewer Window}%
\label{sec:viewer_window}
-The viewer window (figure~\ref{fig:viewer_window}) is a place to load and preview your source media and clips.
-Here you can quickly browse through an asset using the slider control, focus on an area of work with the preview region or you use editing controls to cut and paste segments into the project or create a clip for later use.
+The Viewer window (figure~\ref{fig:viewer_window}) is convenient for previewing your media and
+clips. It can also be used for editing with cuts and then paste operations into the timeline or
+to create a clip. There are transport buttons to use in the same manner as in the Program
+and Compositor windows or you can quickly move through the media by dragging with the LMB in
+the timebar above the transport buttons.
\begin{figure}[htpb]
\centering
- \includegraphics[width=0.99\linewidth]{images/viewer_window.png}
- \caption{Viewer Window}
+ \includegraphics[width=0.99\linewidth]{viewer_window.png}
+ \caption{Viewer Window - the red arrow "Play" button is left of the Videoscope button}
\label{fig:viewer_window}
\end{figure}
-To open the viewer window, go to \texttt{Window $\rightarrow$ Show Viewer}.
-The display is the area on the viewer where you actually see media playing.
-Before you can play any media, you must first load it on the viewer.
-To load media into the viewer:
+In order to view media in the window, you have to load it as follows:
\begin{enumerate}
- \item Open the resources manager window and select the Media folder or the Clip folder.
- \item Drag a file from the Media or the Clip folder to the viewer.
+ \item In the Resources window, highlight the Media folder or the Clip folder.
+ \item Drag a file from the folder to the Viewer.
+ \item \textbf{Or} double LMB click on a media asset.
+ \item \textbf{Or} highlight an asset, RMB to bring up choices, and click on \textit{View} or
+\textit{View in new window}.
\end{enumerate}
-You can also load media onto the viewer by right clicking on a file in the asset manager and selecting View from the popup menu or by double clicking on the icon.
-Once your media loads you will see it appear on the display.
-To play, rewind or forward through it use the slider control or the transport controls.
-You can change the media display size by right clicking on the screen to activate the display zoom menu.
-Select zoom levels of 50\%, 100\% or 200\% of the original media size.
+Note that you can have multiple Viewer windows open with different or even the same media asset.
+After the media is loaded you can use the transport buttons to play, rewind, stop, and so on, or
+for fast previewing drag with the LMB anywhere on the timebar slider. There is also the Videoscope
+button which is to used to enable the scopes window without having to apply the filter to the tracks/edits.
+A few more options available in the Viewer window can be accessed with a RMB click on the display.
+These functions are listed next.
+
+\begin{enumerate}
+ \item Switch to a fullscreen display by choosing \textit{Fullscreen}. To switch back, click
+with the RMB on the display again and choose \textit{Windowed}.
+ \item Change the display size by choosing the \textit{Zoom} function to select a zoom level of
+25\%, 33\%, \ldots 300\%, or 400\% of the original media size.
+ \item To remove the current media from being displayed, choose \textit{Close source}.
+\end{enumerate}
-When displaying media, the viewer uses the project's defined output size format settings, not the original assets format.
-You can change the project's output to match the asset's format using the match project size menu option in the asset manager.
-In the Viewer you can move around in the source media or clips and select regions to paste into the project.
-Operations done in the viewer affect a temporary EDL or a clip, but not the timeline.
+The Viewer uses the project's output size format settings to display the media instead of the
+original asset's format. Operations performed in the Viewer affect a temporary EDL or a clip rather
+than the timeline. By default, the Viewer window is automatically available but if it gets
+accidentally closed you can open it again by using the pulldown \texttt{Window $\rightarrow$ Show
+Viewer} to bring it back up. More details for editing in the Viewer window with the Two Screen
+Editing method is explained in~\ref{sec:two_screen_editing}.
\section{Options in both the Compositor and Viewer Windows}%
\label{sec:options_in_both_the_compositor_and_viewer_windows}
\subsection{Click to Play in Viewer and Compositor}%
\label{sub:click_to_play_in_viewer_and_compositor}
-In both the Viewer and Compositor windows, there is an arrow on the right hand side of the other buttons in the edit panel.
-Mouse action can be toggled on/off via this arrow, which has a tooltip of \textit{Click to play} with the letter "\texttt{P}" to be used for a shortcut.
-When enabled there is a gold-colored shadow around the usual green-colored arrow.
-The purpose of enabling this capability is to make it really easy to play the media in the window by just using the left mouse button to start or stop the play.
-The entire main canvas surface becomes a big play button!
-Although the default is initially off, a good reason to enable this, at least temporarily, is so that you can quickly review your video before a render.
+In both the Viewer and Compositor windows, there is an arrow on the right hand side of the other
+buttons in the edit panel as shown in figure~\ref{fig:viewer_window}. The "play" button can be
+toggled on/off via this arrow, which has a tooltip of \textit{Click to play}. When enabled there
+is a green or gold colored shadow around the usual red or green colored arrow.
+The purpose of enabling this capability is to make it really easy to play the media in the window
+by just using the left mouse button to start or stop the play. The entire main canvas surface
+becomes a big play button! Although the default is initially off, a good reason to enable this,
+at least temporarily, is so that you can quickly review your video before a render.
\begin{description}
- \item[left click] forward play or stop forward play if already playing
+ \item[left click] forward play or stop forward play if already playing
\item[middle wheel] single frame forward or back
- \item[middle click] reverse play or stop reverse play if already playing.
+ \item[middle click] reverse play or stop reverse play if already playing.
Note that some 3 button mice do not accommodate a middle click for reverse but you can find out by testing from a terminal window with the command \texttt{xev}.
\end{description}
\subsection{Timebar + Preview Region Usage in the Compositor and Viewer}%
\label{sub:timebar_preview_region_usage_in_the_compositor_and_viewer}
-The navigation features of the Viewer and Compositor behave very similarly.
-Each has a timebar and slider below the video output.
-The timebar represents the entire time covered by the program.
-When you have a file loaded in the main window and then slide around it using the compositor slider. The insertion point in the main window follows the compositor.
+The Viewer and Compositor each have a timebar control area with an indicator line below the video
+output. The \textit{timebar} shows the whole time covered by the program. When a video asset
+is loaded in the main window and you move in the compositor, the insertion pointer in the main
+window will reflect those movements. However, this is not the case with the viewer. In the viewer
+only that specific media is shown and there is no corresponding movement on the timeline.
-Labels and In/Out points are fully supported in the viewer and compositor.
-In the viewer and compositor, labels and in/out points are displayed in the timebar.
-But there is a difference between the viewer and compositor in that the compositor reflects the state of the program while the viewer reflects the state of a clip but not the program.
-When you hit the label button in the compositor, the label appears both in the compositor timebar and the program timebar.
-When you select a label or in/out point in the compositor, the insertion point in the program window jumps to that position.
+Both the Compositor and Viewer support labels and in/out pointer which are displayed in the timebar.
+And as with the movements, when you use the labels or in/out pointer in the compositor timebar,
+the result will also be reflected in the main window timebar. Along with that, of course, when
+you move to a label or in/out pointer in the compositor, the insertion point in the program window
+will go to that position.
The timebar in the compositor and the viewer can be used to define a region known as the \textit{preview region}.
This preview region is the region of the timeline which the slider affects.
\begin{figure}[htpb]
\centering
- \includegraphics[width=0.8\linewidth]{images/timebar1.png}
+ \includegraphics[width=1.0\linewidth]{timebar1.png}
\caption{The arrow above the green colored “play forward” transport button is on the timebar.}
\label{fig:timebar1}
\end{figure}
To create and use a preview region, hold down the right mouse button inside the timebar on either end of the timebar close to the edge until you see the resize pointer.
While continuously holding the right mouse button down, drag the arrow away from the end towards the middle of the timebar until you have the desired area outlined.
-The slider will be a light blue color while the selected preview region will remain the same initial black color.
+The slider will be a dark red color while the selected preview region will remain the same initial black color.
There are either a left or right resize pointer and you can click and drag in either direction to expand or shrink the region.
\begin{figure}[htpb]
\centering
- \includegraphics[width=0.8\linewidth]{images/timebar2.png}
- \caption{ A left-facing arrow on the right side of the blue slider bar is used to drag the bar.}
+ \includegraphics[width=1.0\linewidth]{timebar2.png}
+ \caption{A left-facing arrow on the right side of the reddish slider bar is used to drag the bar.}
\label{fig:timebar2}
\end{figure}
\begin{figure}[htpb]
\centering
- \includegraphics[width=0.8\linewidth]{images/timebar3.png}
+ \includegraphics[width=1.0\linewidth]{timebar3.png}
\caption{Here you can see the right-facing arrow used to drag the other end of the slider bar.
The black area between is the actual preview area.}
\label{fig:timebar3}
\begin{figure}[htpb]
\centering
- \includegraphics[width=0.8\linewidth]{images/timebar4.png}
+ \includegraphics[width=1.0\linewidth]{timebar4.png}
\caption{Note the double-headed fat arrow in the preview area used to move the selection over.}
\label{fig:timebar4}
\end{figure}
preview region may appear to either move, shrink, or grow depending on the new length of the
media on the timeline.
\item To disable the preview region, you will have to drag both the right and the left blue slider bars
- completely to their corresponding end so that there is no longer any visible blue slider.
+ completely to their corresponding end so that there is no longer any visible red slider.
\end{enumerate}
A good method for taking advantage of the preview region is described here.
On the main track canvas, scroll to the beginning of the area of interest.
When you do that, you will see in the compositor the red indicator line of that location.
-Now in the compositor window, right mouse drag from the left side of the edge of the timebar to create the blue slider bar line up to the red indicator.
+Now in the compositor window, right mouse drag from the left side of the edge of the timebar to create the dark red slider bar line up to the red indicator.
Back in the main track canvas, move to the location of the area you want to end looking and again you will see the red indicator line in the compositor.
Use the right mouse drag from the right to stop at that end point. Using this method is often easier than continuous usage of the single frame move which can be tedious.
\begin{figure}[htpb]
\centering
- \includegraphics[width=0.7\linewidth]{images/resource_window.png}
+ \includegraphics[width=0.8\linewidth]{resource_window.png}
\caption{Folders are in the first column with contents of that folder on the right hand side}
\label{fig:resource_window}
\end{figure}
\begin{figure}[htpb]
\centering
- \includegraphics[width=0.99\linewidth]{images/info_asset_details.png}
+ \includegraphics[width=0.99\linewidth]{info_asset_details.png}
\caption{The “Detail” box}
\label{fig:info_asset_details}
\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}$\dots$ popup by clicking the right mouse button.
Highlight, then click \textit{New Media or Clips}.
\begin{figure}[htpb]
- \begin{minipage}{.55\linewidth}
+ \begin{minipage}{.6\linewidth}
\centering
- \includegraphics[width=0.9\linewidth]{images/folder_resources.png}
+ \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}{.35\linewidth}
+ \begin{minipage}{.37\linewidth}
\centering
\vspace{18ex}
- \includegraphics[width=0.9\linewidth]{images/folder_new.png}
+ \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 \textit{New folder} popup as shown below (figure~\ref{fig:folder_new}), type in your folder name in the textbox. Click OK.
- \begin{figure}[htpb]
- \centering
- \end{figure}
+ \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.
It flashes when the drop is successful.
\end{enumerate}
-\begin{wrapfigure}[12]{O}{0.53\linewidth}
- \vspace{-3ex}
- \centering
- \includegraphics[width=0.9\linewidth]{images/folder_master.png}
- \caption{The “master” Media folder}
- \label{fig:folder_master}
-\end{wrapfigure}
-
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.
\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]{images/folder_modify.png}};
- \node [yshift=-31mm, xshift=-1cm,anchor=east] at (img1.north west) (Arrow1) {\parbox{8em}{Here is the filter that was generated with the original drop }};
- \node [yshift=-85mm, 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=-31mm] img1.north west);
+ \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}
\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]{images/modify_folder1.png}};
- \node (img2) [yshift=-1cm, xshift=4cm, rotate=0] at (img1) {\includegraphics[width=0.6\linewidth]{images/modify_folder2.png}};
- \node (img3) [yshift=-1cm, xshift=3cm, rotate=0] at (img2){\includegraphics[width=0.3\linewidth]{images/modify_folder3.png}};
+ \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}
\caption{Examples}
\label{tab:label}
\small
- \begin{tabular}{llllm{10em}} \toprule
+ \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 \\
\begin{figure}[htpb]
\centering
- \includegraphics[width=0.99\linewidth]{images/vicons1.png}
+ \includegraphics[width=0.99\linewidth]{vicons1.png}
\caption{Note "Full Play" mode and Vicons and Aicons in Media folder}
\label{fig:vicons1}
\end{figure}
-The waveform in the figure~\ref{fig:vicons2} is displayed in the Resources window in the color green/yellow for the 2 audio tracks.
+The waveform in the figure~\ref{fig:vicons2} is displayed in the Resources window in the color green for the 3 audio tracks.
There is a colored bar on the top of each a-icon where the color is based on the Color Spectrum -- the smaller the time duration, the redder the color; then as the time duration goes up, the color goes up so that you will go to green, then yellow, then blue, then really dark blue, then purple for the audio files 1 hour and over.
There are various other colors between these colors same as that seen in the color spectrum in the screenshot below.
Colors are utilized from the hue wheel in the counter-clockwise direction.
\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.99\linewidth]{images/vicons2.png}};
- \node (img2) [yshift=0cm, xshift=2.8cm, rotate=0] at (img1.south west) {\includegraphics[width=0.3\linewidth]{images/hue_wheel.png}};
+ \node (img1) [yshift=0cm, xshift=0cm, rotate=0] {\includegraphics[width=0.99\linewidth]{vicons2.png}};
+ \node (img2) [yshift=0cm, xshift=2.8cm, rotate=0] at (img1.south west) {\includegraphics[width=0.3\linewidth]{hue_wheel.png}};
\node [yshift=-5mm, xshift=1cm,anchor=west] at (img2.east) (Arrow1) {\parbox{18em}{Color hue wheel. For illustration only}};
\draw [->, line width=1mm] (Arrow1) edge ([yshift=-5mm] img2.east);
\end{tikzpicture}
Preview mode can be used to pop up a window which draws the vicons/aicons thumbnails in a larger size.
-Preview or \textit{draw vicons} mode is a helpful feature of Cinelerra that lets you see and/or hear the first 5 seconds of the video for identification purposes.
+Preview or \textit{draw vicons} mode is a helpful feature of \CGG{} that lets you see and/or hear the first 5 seconds of the video for identification purposes.
The Preview mode/playback toggle is to the right of the Visibility label as seen in the screenshot above.
Preview mode is available for the Media, Proxy, Media User Bins, and Clips but clips are only 1 image.
\begin{figure}[htpb]
\begin{minipage}{.69\linewidth}
\centering
- \includegraphics[width=0.99\linewidth]{images/preview_icon_mode.png}
+ \includegraphics[width=0.99\linewidth]{preview_icon_mode.png}
\caption{The location of the Preview/Draw Icons mode.}
\label{fig:preview_icon_mode}
\end{minipage}
\begin{minipage}{.29\linewidth}
\vspace{2ex}
\centering
- \includegraphics[width=0.7\linewidth]{images/line_through_mode.png}
+ \includegraphics[width=0.7\linewidth]{line_through_mode.png}
\caption{Note the line through the mode.}
\label{fig:line_through_mode}
\end{minipage}
\subsection{Moving clips/media from/to Resources window}%
\label{sub:moving_clips_media_from_to_resources_window}
-If you have several media files loaded into the Resources window of one instance of Cinelerra and want to load some of the same ones into another instance or just want a listing to save in a file for later use, you can do this with these set of steps:
+If you have several media files loaded into the Resources window of one instance of \CGG{} and want to load some of the same ones into another instance or just want a listing to save in a file for later use, you can do this with these set of steps:
Copy or paste a list of files in the Media Resources window:
\item right click on an unused portion of that window to bring up the popup menu
\item select the \textit{Copy file list} item and a file list box will appear that contains the full path filenames
\item wipe the textbox using your standard copy/paste method to put the list of files in the copy buffer
- \item in another Cinelerra instance, choose the \textit{Paste file list} of the media Resources window
+ \item in another \CGG{} instance, choose the \textit{Paste file list} of the media Resources window
\item paste the list of files, again using your standard paste method, into the new file list box; press OK
\item the status bar of the main window will be updated as the file list is loaded to the media folder (the purpose of displaying the status is simply to show that the load is progressing normally).
\end{enumerate}
-Obviously this \textit{Paste file list} feature means you can create a list of files outside of Cinelerra using an editor, wipe the names, and then use \textit{Paste file list} to load them into the media Resources window.
+Obviously this \textit{Paste file list} feature means you can create a list of files outside of \CGG{} using an editor, wipe the names, and then use \textit{Paste file list} to load them into the media Resources window.
-It is important to note that in the steps above, the Operating System cut and paste capabilities are in use for steps 4 and 6 as opposed to Cinelerra’s c/v shortcuts.
+It is important to note that in the steps above, the Operating System cut and paste capabilities are in use for steps 4 and 6 as opposed to \CGG{}’s c/v shortcuts.
Since the procedure varies among the distros, you will have to adapt to your specific one. For example, a usage for ubuntu consists of:
\begin{enumerate}
\setcounter{enumi}{3}
\begin{figure}[htpb]
\centering
- \begin{minipage}{.49\linewidth}
+ \begin{minipage}{.9\linewidth}
\centering
- \includegraphics[width=0.99\linewidth]{images/copy_files1.png}
+ \includegraphics[width=0.99\linewidth]{copy_files1.png}
\end{minipage}
- \hfill
- \begin{minipage}{.49\linewidth}
+ \vfill
+ \begin{minipage}{.5\linewidth}
\centering
- \includegraphics[width=0.99\linewidth]{images/copy_files2.png}
+ \includegraphics[width=0.99\linewidth]{copy_files2.png}
\end{minipage}
\caption{Example of copy file list}
\label{fig:copy_files1}
\end{figure}
-In the Figure~\ref{fig:copy_files1}, one instance of Cinelerra has 6 items in the Media area highlighted that were copied to the file list.
+In the Figure~\ref{fig:copy_files1}, one instance of \CGG{} has 3 items in the Media area highlighted that were copied to the file list.
Note how it includes the full pathname.
-In this screenshot on another instance of Cinelerra, there are only 2 items in the media but the \textit{Paste file list} box is ready to have the items inserted via the standard text box paste method. When that is done, the additional 6 media files will be available on this other instance too.
+In this screenshot on another instance of \CGG{}, there are only 2 items in the media but the \textit{Paste file list} box is ready to have the items inserted via the standard text box paste method. When that is done, the additional 6 media files will be available on this other instance too.
Another possible usage of this capability:
\centering
\begin{minipage}{.49\linewidth}
\centering
- \includegraphics[width=0.8\linewidth]{images/snapshot.png}
+ \includegraphics[width=0.8\linewidth]{snapshot.png}
\caption{Snapshot menu and choices}
\label{fig:snapshot}
\end{minipage}
\begin{minipage}{.49\linewidth}
\centering
\begin{tikzpicture}[scale=1, transform shape]
- \node (img1) [yshift=0cm, xshift=0cm, rotate=0] {\includegraphics[width=0.65\linewidth]{images/grabshot.png}};
- \node (img2) [yshift=2cm, xshift=-1cm, rotate=0] {\includegraphics[width=0.07\linewidth]{images/reticle.png}};
+ \node (img1) [yshift=0cm, xshift=0cm, rotate=0] {\includegraphics[width=0.65\linewidth]{grabshot.png}};
+ \node (img2) [yshift=2cm, xshift=-1cm, rotate=0] {\includegraphics[width=0.07\linewidth]{reticle.png}};
\end{tikzpicture}
\caption{Grabshot reticle \& orange box}
\label{fig:grabshot_recticle}
Thus, by playing back you change the position of the insertion point.
The keyboard interface of either the numeric pad or alternative keys has more speeds with the addition of \emph{Forward Slow}(2) and \emph{Reverse Slow} (5).
Hitting any key on the keyboard twice pauses it.
-The shortcuts section of this manual as well as a Shell Command available from the Cinelerra main window has a listing of each of the keys.
+The shortcuts section of this manual as well as a Shell Command available from the \CGG{} main window has a listing of each of the keys.
When using frame advance functions the behavior may seem odd.
If you frame advance forward and then frame advance backward, the displayed frame does not change.
In zoom mode, clicking in the video output zooms in while a Ctrl-click in the video output zooms out.
If you have a wheel mouse, rotating the wheel zooms in or out too.
Zooming in or out with the zoom tool does not change the rendered output.
-It is merely for scrutinizing video or fitting it in the desktop. Playing video on the compositor when zoomed to any size other that 100\%, the original size, requires Cinelerra to do extra processing steps.
+It is merely for scrutinizing video or fitting it in the desktop. Playing video on the compositor when zoomed to any size other that 100\%, the original size, requires \CGG{} to do extra processing steps.
This could affect performance on slower systems
\subsection{Show Overlays}%
There is a line separating the first 4 items, which are just non-automation type settable values as opposed to \textit{auto} keyframe types.
The color is not changeable for the 3 items of Mode, Pan, and Mask which simply display their symbol icon.
-Screenshot below displays the Show overlays popup with all of its options and color coded types such as yellow for Speed and blue for Camera Z.
+Figure~\ref{fig:overlays_window} displays the Show overlays popup with all of its options and color coded types such as yellow for Speed and blue for Camera Z.
Upon clicking on the associated \textit{color ball} to the right of any keyframe type, for example \textit{Fade} in this screenshot, the color wheel palette window pops up so that you can manipulate the color as desired.
\begin{figure}[htpb]
\centering
- \includegraphics[width=0.99\linewidth]{images/overlays_window.png}
+ \includegraphics[width=0.85\linewidth]{overlays_window.png}
\caption{Show Overlays window on the left with the Color ball window to the right to set color}
\label{fig:overlays_window}
\end{figure}
-Screenshot below shows several color coded lines for different keyframes along with the Fade slider for manipulation.
+Figure~\ref{fig:overlays1} shows several color coded lines for different keyframes along with the Fade slider for manipulation.
The slider is in the same color as the color coded keyframe type line which is the same color as in the \textit{Show overlays} window.
\begin{figure}[htpb]
\centering
- \includegraphics[width=0.8\linewidth]{images/overlays1.png}
+ \includegraphics[width=1.0\linewidth]{overlays1.png}
\caption{Lines are colored here on the timeline as designated in Show Overlays}
\label{fig:overlays1}
\end{figure}
checkboxes except for the one you are on. Then this named box will have outline for a \textit{hot} spot.
\item Shift+LMB on this \textit{hot} spot will return to \textit{cool} of the previous settings with all of the previous
checkboxes checked again.
+\end{itemize}
+
+\begin{figure}[htpb]
+ \begin{minipage}{.29\linewidth}
+ \centering
+ \includegraphics[width=0.99\linewidth]{overlays_list1.png}
+ \caption{Original Settings --- cool spot}
+ \label{fig:overlays_list1}
+ \end{minipage}
+ \hfill
+ \begin{minipage}{.29\linewidth}
+ \centering
+ \includegraphics[width=0.99\linewidth]{overlays_list2.png}
+ \caption{Note Titles box hot spot }
+ \label{fig:overlays_list2}
+ \end{minipage}
+ \hfill
+ \begin{minipage}{.29\linewidth}
+ \centering
+ \includegraphics[width=0.99\linewidth]{overlays_list3.png}
+ \caption{Cam/Proj XYZ toggle to fine tune}
+ \label{fig:overlays_list3}
+ \end{minipage}
+\end{figure}
+
+\begin{itemize}
\item Shift+LMB on a non-\textit{hot} spot will simply check or uncheck a box and there is no previous state.
\item This all works in conjunction with the View pulldown menu which, of course, has no hot spots.
\item Caveat \#1 - Shift+LMB on the top 4 choices of Assets, Titles, Transitions, Plugin Keyframes will turn
\item Caveat \#3 - XYZ toggle on/off of Camera and Projector are not affected.
\end{itemize}
-\begin{figure}[htpb]
- \begin{minipage}{.29\linewidth}
- \centering
- \includegraphics[width=0.99\linewidth]{images/overlays_list1.png}
- \caption{Original Settings --- cool spot}
- \label{fig:overlays_list1}
- \end{minipage}
- \hfill
- \begin{minipage}{.29\linewidth}
- \centering
- \includegraphics[width=0.99\linewidth]{images/overlays_list2.png}
- \caption{Note Titles box hot spot }
- \label{fig:overlays_list2}
- \end{minipage}
- \hfill
- \begin{minipage}{.29\linewidth}
- \centering
- \includegraphics[width=0.99\linewidth]{images/overlays_list3.png}
- \caption{Cam/Proj XYZ toggle to fine tune}
- \label{fig:overlays_list3}
- \end{minipage}
-\end{figure}
+
\subsection{Sound Level Meters Window}%
The levels window displays the output audio levels after all mixing is done.
The visible range of the sound level meters is configurable in \texttt{Settings $\rightarrow$ Preferences, Interface tab} under the Operations section.
-\begin{wrapfigure}[16]{O}{0.3\linewidth}
- \centering
- %\vspace{-4ex}
- \includegraphics[width=0.5\linewidth]{images/volume_meter.png}
- \caption{Sound Level Meters Window}
- \label{fig:volume_meter}
-\end{wrapfigure}
-
Sound level meters can be toggled in the viewer and compositor windows with the show meters button.
They also appear in the patchbay when the track is expanded and in the recording monitor when audio is being recorded.
In the patchbay they are the sound levels for each track after all effects are processed and before down-mixing for the output.
Most of the time, audio levels have numerical markings in dB but in the patchbay there is not enough room.
-
+\begin{wrapfigure}[15]{O}{0.3\linewidth}
+ \centering
+ \vspace{-4ex}
+ \includegraphics[width=0.5\linewidth]{volume_meter.png}
+ \caption{Sound Level Meters Window}
+ \label{fig:volume_meter}
+\end{wrapfigure}
The sound level is color coded as an extra means of determining the sound level.
Even without numerical markings, the sound level color can distinguish between several ranges and overload.
Look at the color codings in a meter with numerical markings to see what colors correspond to what sound level.
Then for meters in the patchbay in expanded audio tracks, use the color codings to see if it is overloading.
-Be aware that sound levels in Cinelerra can go above 0 dB.
+Be aware that sound levels in \CGG{} can go above 0 dB.
This allows for not only seeing if a track is overloading but how much information is being lost by the overloading.
Overloading by less than 3 dB is usually acceptable.
-While overloading is treated as positive numbers in Cinelerra, it is clipped to 0 when sent to a sound card or file.
-
-
-
-
-
+While overloading is treated as positive numbers in \CGG{}, it is clipped to 0 when sent to a sound card or file.
+%%% Local Variables:
+%%% mode: latex
+%%% TeX-master: "../CinelerraGG_Manual"
+%%% End:
projects / goodguy / cin-manual-latex.git / blobdiff