Updated to correctly reflect Georgy's code fixes and enhancements for ContextHelp
[goodguy/cin-manual-latex.git] / parts / Windows.tex
1 \chapter{Interface (the 4+ Windows)}%
2 \label{cha:the_4_windows}
3 \index{interface}
4
5 \begin{figure}[htpb]
6     \centering
7     \includegraphics[width=\linewidth,keepaspectratio]{Fenstergrundposition-en.png}
8     \captionsetup{labelformat=empty, textformat=empty}
9     \caption[The four windows (cc-by-sa Olaf)]{No text}    
10     \label{fig:Fenstergrundposition-en}
11 \end{figure}
12
13 First, it is important to know what an EDL is. When \CGG{} saves a file, it saves the EDL,
14 Edit Decision List, of your project which contains all the settings and locations of edits
15 and pointers to the media so that the media is not modified. The EDL is described 
16 in \nameref{sec:edl_edit_decision_list}.
17
18 Second, for those users who would like to keep all 4 windows together for a better workflow,
19 see \nameref{sec:focus_group}.
20
21 \section{Program Window}%
22 \label{sec:program_window}
23 \index{program window}
24
25 The main window is called the \textit{Program} window and is often just referred to as the \textit{timeline} \index{timeline}.  Here is where you enter the main menu operations.  
26 This timeline consists of a vertical stack of tracks with time represented horizontally on the track. 
27 It is the output of the rendering operations and this is what is saved when you run the \textit{File} pulldown, Save command.
28 Immediately to the left of the timeline is the patchbay \index{patchbay}. The patchbay contains options that affect each track.  
29 These options are described in great detail in \nameref{sec:patchbay}.
30
31 The \textit{Window} pulldown on the main window contains options
32 that affect the 4 main windows. The first 3 options are used to
33 display each of the windows in case one was accidentally closed.
34 You can move or resize the windows as needed, save that particular
35 layout, and revert to the default positions to reposition all 4
36 windows to the original screen configuration.  On dual headed
37 displays, the \textit{Default positions} operation only uses the one
38 monitor to display the windows, but as you can see in the
39 \textit{Window} pulldown you have more options to change that with the
40 2 \textit{tile} options. Usage with dual monitors is explained
41 in~\nameref{sec:playback_a_b}.
42
43 \subsection{Video and Audio Tracks and Navigation}%
44 \label{sub:video_and_audio_tracks_and_navigation}
45
46 The \textit{Program} window (figure~\ref{fig:patchbay}) has many features for navigation and displays the timeline as it is structured in memory. The tracks are stacked vertically with horizontal movement over time.
47 There is a vertical scroll bar which allows for moving across tracks and a horizontal scroll bar for scanning across time. 
48
49 \begin{figure}[htpb]
50     \centering
51     \includegraphics[width=1.0\linewidth]{patchbay.png}
52     \caption{Patchbay  | Timeline with pulldowns, navigation icons, Video/Audio tracks | bottom Zoom Panel}
53     \label{fig:patchbay}
54 \end{figure}
55
56 Video tracks represent the duration of your media, just as if you placed old-fashioned rolls of photographic
57 film one right after the other on a table.
58 Individual images that are drawn on each track are snapshots of what is located at that place on the timeline.
59
60 Audio tracks represent the sound media as an audio waveform, or if you change a preference setting, a rectified audio waveform. 
61 This too looks like old-fashioned digital magnetic tape laid out horizontally across a table.
62 Using the \textit{Zoom Panel} controls at the bottom of the timeline,
63 you can adjust the horizontal and vertical size of the video and audio waveform displays.
64 Each track on the timeline has a set of attributes on its left side in the patchbay which is used to 
65 control some options of that particular track. 
66
67 Track navigation is performed by selecting a video or audio track and moving to a certain time in the track. 
68 Use the vertical scroll bar to scan across tracks, or even easier you can use the mouse wheel. 
69 And use the horizontal scroll bar to scan across time, or again even easier, you can use the mouse wheel with the Ctrl key.  
70
71 Once you have become familiar with many of the graphical tools and pulldowns, you can switch to using more of
72 the keyboard to navigate.  Many of the key equivalences are listed in each of the pulldowns to the right of the option
73  as a shortcut. All of the shortcuts are listed in a document for keyboard 
74 navigation (\nameref{cha:shortcuts}). This includes, for example, shortcuts like the \texttt{Home} and \texttt{End} keys to go to the beginning or end of the timeline.  
75 Another example is in the default cut and paste mode, hold down \texttt{Shift} while pressing \texttt{Home} or \texttt{End} in order to select the region of the timeline between the insertion point and the key pressed.
76
77 \subsection{Transport and Buttons Bar}%
78 \label{sub:transport_buttons}
79 \index{transport buttons}
80
81 This is a short description of what is contained on the \textit{Transport and Buttons Bar} as seen in
82 figure~\ref{fig:insertion-points}.
83 Each of the symbols has an associated tooltip as an easy reminder of its function.  The usage of
84 several is described in a little more detail in other areas of this manual. 
85
86 \vspace{2ex}
87 \begin{tabular}{ll}
88    \hline
89         First set of 3 symbols & Move in the reverse direction on the timeline \\
90         4th symbol & Stop play \\
91         Third set of 3 symbols & Move in the forward direction on the timeline \\
92         Next 2 symbols & Set editing mode \\
93         Generate keyframes while tweaking & Explained in \ref{sec:generate_keyframe_tweaking}\\
94         Allow keyframe spanning & Explained in \ref{sec:allow_keyframes_spanning}\\
95         Lock labels from moving with edits & Toggle to lock or not lock labels from moving \\
96         Next 2 are In and Out pointers & Set or unset In and Out to define an area \\
97         To Clip & Create a clip of the designated area \\
98         Split / Cut & Split/Cut at insertion or selected area \\
99         Next 2 symbols & Usual Copy and Paste functions \\
100         Next 3 symbols & Label manipulation functions  \\
101         Next 2 symbols & Used to move to other edits  \\
102         Next 2 symbols & Fitting video to the display  \\
103         Next 2 symbols & Undo and Redo last operation  \\
104         Manual Go To & Explanation after this table  \\
105         Set Timecode & Explained in \ref{sub:align_timecodes}  \\
106         Gang Modes & Explained in \ref{sub:displaying_tracks_ganged} \\
107    \hline
108 \end{tabular}
109
110 The \textit{Manual Go To} \index{goto} menu is quite versatile as you can see in figure~\ref{fig:goto_menu}.  The
111 options of \textit{=} represents goto the position indicated in the textbox; \textit{+} indicates
112 to goto forward the additional number in the textbox; and \textit{-} means to go in the reverse
113 direction the number in the textbox.  If you use \textit{Enter} in the textbox, the menu will stay
114 up so that you can use it without having to continuously pop it up.  If you use the OK check instead, 
115 the menu will be taken down.  The pulldown arrow to the right of the textbox sets the
116 \textit{Time Format} \index{time format} for the units to be used for position changing.  This lets you change the units
117 without having to modify your Preference. 
118
119 \begin{figure}[htpb]
120     \centering
121     \includegraphics[width=0.4\linewidth]{goto.png}
122     \caption{Goto position menu}
123     \label{fig:goto_menu}
124 \end{figure}
125
126 \textit{Time Format} options are:
127
128 \begin{tabular}{ll}
129    \hline
130         h:mm:ss.sss & hours minutes seconds milliseconds  \\
131         h:mm:ss:ff & hours minutes seconds frames  \\
132         timecode  \\
133         video frames  \\ 
134         audio samples  \\
135         audio samples (hex)  \\
136         ssss.sss & milliseconds.xx  \\
137         video frames (feet)  \\
138    \hline
139 \end{tabular}
140
141 \subsection{Zoom Panel}%
142 \label{sub:zoom_panel}
143 \index{zoom!panel}
144
145 Below the displayed tracks in the timeline, you will find the zoom panel as seen in figure~\ref{fig:patchbay}.
146 In addition to the scrollbars, these options and their values are another set of tools for positioning the timeline.  
147 In order of appearance in the zoom panel as rectangular boxes and either tumbler arrows or a up/down arrow, this next list shows each option along with its tooltip description if available.
148 Then more details are provided in the next paragraphs.
149
150 \vspace{2ex}
151 \begin{tabular}{ll}
152    \hline
153         Sample zoom & Duration visible on the timeline \\
154         Amplitude & Audio waveform scale \\
155         Track audio zoom & Height of audio tracks \\
156         Track video zoom & Height of video tracks \\
157           (type) & Automation Type \\
158         Curve zoom & Automation range minimum and maximum \\
159         Selection change & 3 boxes with starting point, length, and ending point \\
160         Alpha slider & Slider bar to control alpha value for colored assets \\
161    \hline
162 \end{tabular}
163
164 Changing the \emph{sample zoom} changes the amount of time displayed on the timeline 
165 so you can see your media as individual frames or as the entire length of your media. 
166 To see more frames, use a higher setting. 
167 The sample zoom value is not an absolute time reference because it refers to the duration visible on the timeline. It will change as you modify the length of the program window horizontally.
168 You can either use the $\uparrow$ and $\downarrow$ arrows to change the sample zoom by a power of two, or use the mouse wheel on the tumblers to zoom in and out.
169
170
171 The next option is \emph{amplitude} and it only affects the audio waveform \index{waveform} size. \texttt{Ctrl-$\uparrow$} and \texttt{Ctrl-$\downarrow$} are shortcuts used to change the amplitude zoom as an alternative to the down arrow to the right of the numerical size.
172
173 The \emph{track audio and video zoom} affects all tracks of that type and determines the height of each track. 
174 If you change the audio track zoom, the amplitude zoom will be changed also so that the audio waveforms
175 are proportionally sized.
176 Shortcuts, \texttt{Ctrl-Pgup} and \texttt{Ctrl-Pgdown}, change the track zoom to the next level simultaneously for all of the audio and video tracks.
177
178 \emph{Automation type} \index{autos} is used for selecting one of the following: Audio Fade, Video Fade, Zoom, Speed, X, or Y (X and Y are for the compositor's Camera and Projector).  When an auto line is present on
179 the timeline and is being manipulated, a small square the same color as the line will be shown to 
180 the left of the Automation type when the left mouse button (LMB) is pressed.  This is just an indicator to make it easy to see what is being worked.
181  
182 The \emph{curve zoom} \index{autos!zoom} affects the curves for the selected \emph{automation type} in all the tracks of that type and determines the value range for those curves. 
183 Use the tumbler arrows to the left of the numbers for the minimum value and the tumblers to the right for the maximum value, or manually enter the values in the text box. 
184 Good default values for audio fade are -40.0 to 6.0 and for video fade are 0.0 to 100.0. 
185 The tumbler arrows change curve amplitude, but the only way to curve offset is to use the fit curves button on the curve itself.
186
187 The \emph{selection start time}, \emph{selection length}, and \emph{selection end time} \index{timeline!selection} display the current selected timeline values. When there is no selection, both the start and end time are the current
188 position of the timeline and the selection length is 0.
189 The \emph{alpha slider} \index{alpha slider} allows for varying the alpha value when using colors on the tracks as set in your \texttt{Preferences $\rightarrow$ Appearance} for \texttt{Autocolor assets}.  
190 It has no function without that flag set.
191
192 There are 3 additional pieces of information in the line immediately below the \textit{zoom panel}.
193 In the lower left hand corner there could be messages such as "Welcome to \CGG{}" when there is no 
194 need to display a red-colored error message or a line that reads "Rendering took H:MM:SS" after a render
195 has just been completed. Or when working with an auto, a small square the color of the last changed auto line, will be
196 present along with its keyframe type, location on the timeline, and its current value.  This is simply
197 for easy recognition of what is being worked. The second piece of helpful information is all the way to
198 the right which is a long rectangular box indicating the percentage completion of a render. Finally
199 there is an X with the tooltip of "Cancel operation" \index{cancel operation} used to stop an ongoing render
200 (the cancel operation may seem slow due to the amount of data still in the buffer upon cancellation).
201
202 \subsection{Track Popup Menu}%
203 \label{sub:track_popup_menu}
204 \index{track!popup menu}
205
206 Each Track has a popup menu. 
207 To activate the track popup menu, Right mouse click (RMB) on the track. 
208 The popup menu affects the track whether the track is armed on the patchbay or not. 
209 The Track Menu contains a number of options:
210
211 \begin{description}
212     \item[Attach Effect] \index{attach effect} opens a dialog box of effects applicable to the type of track of audio or video.
213     \item[Move up] allows for changing the order of the tracks up; the actual code refers
214 to this as a swap. Disarmed tracks affect the results.
215     \item[Move down]  allow for changing the order of the tracks down; the actual code refers
216 to this as a swap.  Disarmed tracks affect the results.
217     \item[Roll up] moves the tracks one step up in the stack with the top track going to the bottom.  This is applicable to all armed and disarmed tracks.
218     \item[Roll down]  moves the tracks one step down in the stack with the
219 bottom track going to the top.  This is applicable to all armed and disarmed tracks.
220     \item[Delete track]  removes the track from the timeline.
221     \item[Add Track]  adds a track of the same media type as the one selected, audio or video, above the selected track.
222     \item[Find in Resources] \index{find in resources}  the media file on that track at the location of the insert pointer will be highlighted in the media folder in the Resources window. If the 
223         Resources window is closed, media is found and highlighted but the Resources window is not displayed.
224     \item[Show edit] \index{show edit}  will point out the exact start and stop points along with the length of the current edit on
225         that track as well as the media name, track name and number, and edit number.
226     \item[User title] \index{user title}  is used to change the title name.  This is really handy for files that have very long and
227         similar names that would get cut off during edits.  You can use short names to better differentiate the
228         media. In Drag and Drop editing mode, if you select multiple edits all of those clips will have
229 their title name changed.
230     \item[Bar color] \index{bar color} allows the user to select a specific color for the title bar.  This helps to more easily locate a piece of media.
231     \item[Resize Track] \index{resize track} resizes the track; this is only applicable to video tracks.
232     \item[Match Output Size] \index{match output size} resizes the track to match the current output size; this is only applicable to video tracks.
233 \end{description}
234
235
236 \subsection{Insertion Point}%
237 \label{sub:insertion_point}
238 \index{insertion point}
239
240 The insertion point (figure~\ref{fig:insertion-points}) is the vertical hairline mark that spans the timeline in the program window - it can be a solid line but most of the time it will be flashing. 
241 Like the cursor on a word processor, the insertion point marks the place on the timeline where the next
242 operation will begin. It is the starting point of all play operations and is the point where a paste operation will occur. 
243 In some cases, when rendering it defines the beginning of the region of the timeline to be rendered. 
244
245 To move the insertion point, you move the mouse inside the timebar \index{timebar} area and click with the left mouse button. 
246 You can use any place on the timebar to reposition the insertion point as long as that spot is not blocked
247 by In/Out point \index{in/out point} or a label \index{label}. 
248 In cut and paste editing mode, you can also change the position of the insertion point with a simple 
249 left mouse click in the timeline itself.
250 When moving the insertion point, the position is either aligned to frames or aligned to samples. 
251 For best results, \textit{Align cursor on frames} \index{Align cursor on frames} when editing a video track and \textit{Align to samples} \index{Align to samples} when editing audio. 
252 Use the pulldown \texttt{Settings$\rightarrow$Align cursor on frames} to change the alignment by
253 checking the box on for video and off for audio.
254
255 \begin{figure}[htpb]
256     \centering
257     %\includegraphics[width=0.8\linewidth]{name.ext}
258     \begin{tikzpicture}[scale=1, transform shape]
259         \node (img1) [yshift=0cm, xshift=0cm, rotate=0]
260          {\includegraphics[width=0.6\linewidth]{insertion-point.png}};
261         \node [yshift=-5mm, xshift=-1cm,anchor=east] at (img1.north west) (Pulldowns) {Pulldowns};
262         \node [yshift=-10mm, xshift=-1cm,anchor=east] at (img1.north west) (Transport) {Transport \& Buttons Bar};
263         \node [yshift=-15mm, xshift=-1cm,anchor=east] at (img1.north west) (Timebar) {Timebar};
264         \node [yshift=-20mm, xshift=-1cm,anchor=east] at (img1.north west) (Title) {Media Title };
265         \node [yshift=-28mm, xshift=-1cm,anchor=east] at (img1.north west) (Video) {Video Track};
266         \node [yshift=-46mm, xshift=-1cm,anchor=east] at (img1.north west) (Audio) {Audio Track};
267         \draw [->, line width=1mm] (Pulldowns) edge  ([yshift=-5mm] img1.north west);
268         \draw [->, line width=1mm] (Transport) edge  ([yshift=-10mm] img1.north west);
269         \draw [->, line width=1mm] (Timebar) edge    ([yshift=-15mm] img1.north west);
270         \draw [->, line width=1mm] (Title) edge      ([yshift=-20mm] img1.north west);
271         \draw [->, line width=1mm] (Video) edge      ([yshift=-28mm] img1.north west);
272         \draw [->, line width=1mm] (Audio) edge      ([yshift=-46mm] img1.north west);
273         \end{tikzpicture}
274     
275     \caption{Insertion point is at 0:00:25:10 in Hr:Mn:Sec:Frames}
276     \label{fig:insertion-points}
277 \end{figure}
278
279
280 \subsection{Editing Modes}%
281 \label{sub:editing_modes}
282 \index{drag and drop}
283 \index{cut and paste}
284
285 There are 2 different editing modes for operations which affect how the insertion point and editing
286 on the timeline operate.  
287 There is:  \emph{drag and drop mode} and \emph{cut and paste mode}. 
288 The editing mode is determined by selecting the \texttt{arrow} \index{arrow}, or immediately to the right of the arrow,
289 the \texttt{I-beam} \index{i-beam} in the Transport and Buttons bar. In figure~\ref{fig:insertion-points} you can see
290 the green colored highlight \protect\footnote{green is used in the default Cakewalk theme, but the highlight color will be different in other themes} on the arrow icon indicating that you are currently in 
291 \emph{drag and drop mode}.
292
293 With the arrow highlighted for \emph{drag and drop mode}, a double click with the left mouse button in the timeline selects the edit the mouse pointer is over. 
294 Then dragging in the timeline repositions that edit and this can be used for moving effects,
295 changing the order of playlists, or moving video pieces around. 
296 There are numerous methods to cut and paste in \emph{drag and drop mode} by setting In/Out points to define
297 a selected region or using the Copy/Paste Behavior as outlined in~\ref{sub:copy_paste_behavior}. 
298 In this mode, clicking the LMB in the timeline does not reposition the \textit{Insertion Point}. 
299
300 \begin{figure}[htpb]
301         \centering
302         \includegraphics[width=0.4\linewidth]{i-beam.png}
303         \caption{I-beam + in/out  +  labels}
304         \label{fig:i-beam}
305 \end{figure}
306
307 When the I-beam is highlighted, you are in \emph{cut and paste mode}.
308 In cut and paste mode, clicking the LMB in the timeline does reposition the \textit{Insertion Point}. 
309 Double clicking in the timeline selects the entire edit the cursor is over, i.e.\ that column. 
310 Dragging in the timeline with the LMB pressed down, highlights a selected region and this is the region that is affected by cut
311 and paste operations.  It is also the playback range used for the subsequent playback operation. 
312 Holding down the Shift key while clicking in the timeline extends the highlighted region.
313
314 \subsection{In/Out Points}%
315 \label{sub:in_out_points}
316 \index{in/out point}
317
318 The In/Out points, displayed on the timebar \index{timebar} by [ and ] brackets,  can be set in either of the editing modes to define the selection.
319 In the timebar, a colored bar will show between these 2 brackets to better outline the area selected.
320 In \emph{drag and drop mode} \index{drag and drop}, they are an easy way to define a selected region.
321
322 It is important to remember that a highlighted area overrides the In/Out points. That is, if a highlighted area and In/Out points are both set, the highlighted area is changed by editing operations and the In/Out points are ignored. 
323 But if no region is highlighted, the In/Out points are used. 
324 To avoid confusion, use either highlighting or In/Out points but not both at the same time.
325
326 To set In/Out points, in the timebar move to the position where you want the Insertion point \index{insertion point} and click the In
327 point icon or one of the [ or < keys.
328 Then move the insertion point to a position after the In point and click the ] or > or the Out point icon. 
329 You can use these same icons or keyboard characters to toggle In/Out points on or off.
330
331 If you set the insertion point in another place when In/Out points are already set, that existing point will be
332 repositioned when you click the In/Out icon or keyboard equivalent. 
333 If you click on In/Out points while a region is highlighted, the insertion point will be ignored and In/Out points will be set at the beginning and at the end of the highlighted area.
334
335 When you select either the In or Out point on the timebar, the insertion point will move to that location. Note that when the insertion point is at the exact position of an In or Out point, the bracket will change
336 color making it easy to see that you are exactly at that spot.
337  
338 If only the In point is set, when you click the In point icon the In point will be deleted. 
339 If only the Out point is set, when you click the Out point icon the Out point will be deleted. 
340 Holding the Shift key while clicking on an In/Out point, the area between the insertion point and that
341 In/Out point will be highlighted or extended to that In/Out point if already highlighted. 
342
343 An easy way to turn off the In/Out points if both are set, is to double click on the [ icon in the toolbar. 
344 If you have already set the In and Out points, and then move the insertion point anywhere to the left of
345 the Out point, a LMB click on the [ icon will move the In point to the location of the insertion point.  In the same
346 manner if you move the insertion point anywhere to the right of the In point, a LMB click on the ] icon
347 will move the Out point to that new position.  However, if you move the insertion point for either the
348 In or Out point beyond what makes sense to designate In/Out points, the bracket you clicked on will be
349 moved to the insertion point and the other bracket will be eliminated.  That is obviously because the
350 In point has to come before the Out point on the timeline.
351
352 Some of the useful operations concerning the In/Out pointers are listed next.
353
354 \begin{description}
355     \item[Ctrl-KeyPad\#]  if In/Out set, \texttt{KP 2,3,5,6 + Enter}, play between In/Out points
356     \item[Shift-Ctrl]  loops play between In/Out points
357     \item[Click In/Out] while holding the LMB down, drags In/Out pointer where you drag to
358     \item[Shift-Ctrl] with a transport button (e.g. Fast Forward), loops play between In/Out points
359     \item[Ctrl-t]  clears both In/Out points
360 \end{description}
361
362 \subsection{Guide on timeline}%
363 \label{sub:guide_timeline}
364 \index{guide lines}
365
366 It can be useful to have visual reference points on the timeline to help you position edits relative to other tracks. For example in manual synchronization of audio and video. You can set two points on the timeline with In/Out points or by selecting a range in Cut and Paste mode. Now we use \texttt{Settings $\rightarrow$ Loop Playback} (Shift - L) to make two vertical green lines appear at the edges of the selection. Originally this function is used to limit the playback within this range, but we can take advantage of the fact that the green lines remain even when we move the insertion point or delete the In/Out points or deselect the range. So they can be used as a visual reference when we want to move the edits precisely. To delete these guides press \textit{Shift-L} again.
367
368 \subsection{Labels}%
369 \label{sub:labels}
370 \index{label}
371
372 Labels are used in order to set exact locations on the timeline that you want to be able to easily get to. 
373 To create a label, position the insertion point \index{insertion point} at a location and click on the label icon in the Transport
374 and Buttons bar. The new label is displayed on the timebar \index{timebar} as a down arrow at that location as shown in
375 figure~\ref{fig:i-beam}.  Whenever the insertion point is at the same position as a label, it changes
376 color to emphasize that it is exactly at that spot.
377 Labels make it so you can jump back and forth to exact marked locations on the timeline.
378 Use the lower case letter “\texttt{L}” as a shortcut for the label button.
379
380 You can use labels to reposition the insertion point when that label is selected. They are also
381 especially useful for moving along the timeline to the \textit{Next label} or \textit{Previous label}
382 with the buttons on the Transport and Buttons bar to the right of the Labels button.  
383 When moving along the timeline with the Next or Previous label buttons, if a label is out 
384 out of view the timeline will automatically be repositioned so that the label is visible.
385 If you perform a \textit{Next label} operation and there are no more, the insertion point
386 will go to the End position.  Conversely if you perform a \textit{Previous label} operation
387 and there are no more labels, the insertion point will go to the Home position. 
388 Keyboard shortcuts for label traversal are:
389
390 \begin{description}
391     \item[Ctrl-left] moves the insertion point to the previous label.
392     \item[Ctrl-right] moves the insertion point to the next label.
393 \end{description}
394
395 There is a  Label folder in the Resources window which has a list of every label and its exact location
396 where the label is. The location is based on the timestamp, frame number, or sample number depending on the selected Time Format of your timebar. 
397 You can edit, delete, or goto a label by clicking the RMB on that label in the Resources window which
398 brings up a popup menu with those options.  It can be quite helpful to \textit{edit} the label
399 and add a text string to help identify what the label represents.
400 In addition, RMB clicking the label symbol on the timebar brings up a textbox displaying the current
401 text string and allowing you to change it. If a Label has been given a name, simply mousing over
402 the label symbol on the timebar will display that string.
403
404 With labels you can also select regions:
405
406 \begin{description}
407     \item[Shift-Ctrl-left] highlights the area between the insertion point and the previous label.
408     \item[Shift-Ctrl-right] highlights the area between the insertion point and the next label.
409     \item[Double-clicking] on the timebar between two labels, highlights the area between the labels.      
410     \item[Shift-clicking] on a label, highlights the area between that label and the insertion point.
411         If an area is already highlighted, it extends the highlighted area up to that label.
412 \end{description}
413
414 If you LMB click the label button when an area is highlighted, labels are created at each end of the
415 highlighted area. 
416 When a label is selected, if you click on the label icon, the label will be deleted. 
417 To delete multiple labels, highlight that area, then use the \texttt{Edit $\rightarrow$ Clear $\rightarrow$ Clear labels}
418 function to delete them all. The same precedence rules apply to this operation as mentioned earlier.  That
419 is, if both In/Out points are set and there is a highlighted area also set, the highlighted area's 
420 labels will be cleared and not those between the In/Out points.
421
422 If you enable \emph{Edit labels} in the \textit{Settings} pulldown menu or disable the \emph{Lock labels from moving}
423 button on the Transport and Buttons bar, labels will be cut, copied or pasted along with the selected
424 area of the first armed track. 
425 In the same manner, if a selected area of media is spliced from the viewer to the timeline in a position 
426 before labels, the labels will be moved to the right on the timebar so that the label maintains its 
427 relative position to its edit. 
428 To prevent labels from moving on the timebar, enable the \emph{Lock labels from moving} icon or
429 disable the \emph{Edit labels} option under the \textit{Settings} pulldown.
430
431 \subsection{Color Title Bars and Assets}%
432 \label{sub:color_title_bars_and_assets}
433 \index{bar color}
434 \index{asset!color}
435 In order to visually aid in locating clips on the timeline that are from the same media file, you can have them auto-colored or self-colored.  Auto-color is
436 an automatic system to always color the files on the timeline when loaded. 
437 Self-color is a manual coloring requiring the user to take definitive action.
438 Use of this feature requires additional memory and cpu on every timeline redraw, therefore it is recommended that smaller computers leave it turned off.
439
440 For auto-color the color will be based on a hashed filename so that whenever you load this particular media, it will always have the same color on the title bar even if you use proxy.  
441 To enable auto-color go to \texttt{Settings $\rightarrow$ Preferences, Appearance tab} and check on \texttt{Autocolor assets}. You will see this in the Flags section
442 as shown in Figure~\ref{fig:settings}.  It is disabled by default.  
443 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.  
444
445 To change a specific clip to your own chosen color, right mouse button (RMB) over that clip and an Edits popup will be displayed.  
446 Choose the option \textit{Bar Color} to bring up the color picker and choose a color.   
447 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.   
448 The color will only change after you click on the checkmark.  
449 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.  
450 In Drag and Drop editing mode, if you select several clips (reference "Create a 
451 group" in ~\ref{sub:grouping_edits}) 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.
452
453 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.  
454 To change these individually or selectively, use the Edits popup \emph{Bar Color} option and click on \textit{Default} in the color picker window.  
455
456 And that’s not all!  
457 There is an \emph{alpha fader slider bar} \index{alpha slider} on the bottom of the main window on the right hand side of the Zoom Panel.  
458 With this alpha slider, you can colorize your video and audio tracks to either see only the color at 0.0 or see only the image at 1.0.  
459 This slider bar affects all colored areas of the Autocolor assets and the self-colored ones.  
460 In the case when a specifically changed edit alpha value is set in the color picker
461 to any value except 1, the slider bar will not affect that.  
462 Once you use the slider bar, it is activated so gets first shot at any keystrokes in the main window.  
463 You deactivate this by simply clicking in a different part of the main window.  
464
465 As long as we are on the subject of color, just a note that you can also change the \textit{Highlighting Inversion color} in \texttt{Settings $\rightarrow$ Preferences, Appearance tab}.  You can see this option in Figure~\ref{fig:settings} in the Color section.  
466 That setting defaults to white ($ffffff$) but sometimes this is a little bright so you can put any hex value in that suits you.
467
468 This image (figure~\ref{fig:autocolor_assets_alpha}a) shows an example of the Autocolor assets with alpha set to 0.0 so that you see only the color and no image.
469 In this image (figure~\ref{fig:autocolor_assets_alpha}b), the alpha is set to show the image
470 and waveforms with transluent colors.  The pink media file has been self-colored rather than the autocolor to make it easy to see.
471
472 \begin{figure}[htpb]
473     \centering
474     \begin{minipage}[h]{0.55\linewidth}
475         \center{\includegraphics[width=0.99\linewidth]{autocolor-assets_alpha0.png}} \\ a)
476     \end{minipage}
477     \begin{minipage}[h]{0.4\linewidth}
478         \center{\includegraphics[width=0.99\linewidth]{autocolor-assets_alpha1.png}} \\ b)
479     \end{minipage}
480     \caption{An example of the Autocolor assets}
481     \label{fig:autocolor_assets_alpha}
482 \end{figure}
483
484
485 \subsection{More about Pulldowns}%
486 \label{sub:more_about_pulldowns}
487
488 The main window pulldowns as pointed out in figure~\ref{fig:insertion-points} are quite obvious in their meaning and usage, so here is only a summary.  
489
490 %TODO Figure 3 shows an example of the pulldowns as displayed in the main window.Appearance
491
492
493 \begin{description}
494     \item[File] \index{file} options for loading, saving, and rendering as described in other sections (\ref{cha:load_save_and_the_EDL}).
495     \item[Edit] \index{edit} edit functions; most of which have shortcuts that you will quickly learn (\ref{cha:editing}).
496     \item[Keyframes] keyframe options which are described in the Keyframe section (\ref{cha:keyframes}).
497     \item[Audio] \index{audio} audio functions such as \textit{Add track}, \textit{Attach effect}
498 and \textit{Attach transition}.  The \textit{Attach effect} is especially useful when
499 you need the effect to be applied to all related audio tracks as a \textit{Shared effect}
500 and is described as an alternative method of application in section \ref{sec:shared_effect_tracks}.
501     \item[Video] \index{video} video functions such as \textit{Add track, Default/Attach transition, Render effect}.
502     \item[Tracks] \index{track} move or delete tracks are the most often used plus \textit{Align Timecodes}.
503     \item[Settings] \index{settings} much of this is described elsewhere with the most frequently used to include
504 Preferences (\ref{cha:configuration_settings_preferences}), Format (\ref{cha:project_and_media_attributes}), 
505 Proxy and Transcode (\ref{sec:proxy_settings}), as well as the others.
506     \item[View] \index{view} for display or modifying asset parameters and values to include Fade, Speed, and Cameras.
507     \item[Window] \index{window} window manipulation functions.
508 \end{description}
509
510
511 \subsection{Window Layouts}%
512 \label{sub:window_layouts}
513  \index{window!layout}
514
515 If you like to use different window layouts than the default for certain scenarios, you can setup, save, and load 4 variations.   
516 First, position your \CGG{} windows where you want them to be and then use the \textit{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. 
517 To use the default name of \textit{Layout \#}, when the popup comes up, just click the green checkmark OK on the Layout popup menu.  
518 If you would like a specific name for your layout so you can remember what its best use case is,
519 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 ñ). 
520 Legal characters are a-z, A-Z, 0-9, \_ (the underscore character) and a limit of 8 total.  
521 If you keyin more than 8, only the last 8 characters will be used.  
522 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).
523
524 \begin{figure}[htpb]
525     \centering
526     \begin{minipage}{.49\linewidth}
527         \center{\includegraphics[width=1\linewidth]{window_layout1.png}}\\ a)
528         %TODO High res image replace
529     \end{minipage}
530     \begin{minipage}{.49\linewidth}
531 %begin{latexonly}
532         \vspace{13ex}
533 %end{latexonly}
534         \center{\includegraphics[width=1\linewidth]{window_layout2.png}}\\ b)
535         %TODO Alpha channel
536     \end{minipage}
537     \caption{Window Layouts}
538     \label{fig:window_layouts}
539 \end{figure}
540
541 The files containing the coordinates for your layouts will automatically be saved in the \texttt{\$HOME/.bcast5} directory as \texttt{layout\#\_rc} or \texttt{layout\#\_8chars\_rc}.
542
543 To use the desired layout, keyin the shortcut or use the \textit{Window} pulldown and choose \emph{Load layout} and then make your choice. It is very beneficial to 
544 learn the the associated shortcut layouts (Ctrl+Shift+Fx where x is 1,2,3, or 4)
545 because they can be executed from any of the 4 windows instead of just the main
546 timeline window.
547
548 \subsection{Multi-Pane Support}%
549 \label{sub:multipane_support}
550  \index{multi-pane}
551
552 The main \CGG{} edit window holds the Track Canvas which can be divided into 4 panes of track data: 1 or 2 vertical panes and/or 1 or 2 horizontal panes.  To split the track, use the \textit{Window} pulldown, and then click on \textit{Split X} or \textit{Split Y} depending on how you wish to split the track.  Alternatively, the canvas pane types can be changed using keys \textit{<Ctrl-1>} for toggle split horizontal or \textit{<Ctrl-2>} for toggle split vertical.  Or the track can be split into panes by using the \textit{+ widget} in the lower right hand corner of the track canvas.  Once the track has been divided, you can use the + widget shortcut or the drag bars to change the size of the panes.
553
554 Multi-Pane, or split screen, allows you to look at the first part of a movie at the same time as a part that is a long ways away on the timeline which would have been off the screen.  By having multiple panes, you can see the 2 parts you want to look at simultaneously and drag/drop easily between the 2.  Also, the \textit{X pane split} is extremely convenient for laptop users and computer monitors with small screens since it can be used with horizontal scrolling with the mouse wheel + Ctrl.  The \textit{Y-pane split} makes it easy to see 2 simultaneous drag and drop zones when you have lots of tracks (figure~\ref{fig:multi-pane01}).
555
556 \begin{figure}[htpb]
557         \centering
558         \includegraphics[width=1.0\linewidth]{multi-pane01.png}
559         \caption{Shown are 4 panes that have split in X and Y the main track canvas}
560         \label{fig:multi-pane01}
561 \end{figure}
562
563
564 \subsection{Just Playing!}%
565 \label{sub:just_playing_}
566 What if you are just using \CGG{} to play media and listen to tunes? 
567 After loading your media, just hit the space bar to start playing and then again to stop playing.  
568 Other than that, use the transport buttons on the top bar of the Program window.  
569 Other ways to \textit{play around} are described next. 
570
571 \subsubsection*{Repeat Play / Looping Method}%
572 \label{ssub:repeat_play_looping_method}
573  \index{transport buttons}
574
575 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.
576
577 \textit{Method 1:} Shift-L on the Timeline, repeats the selection per the algorithm outlined next.
578   
579 When setup, long green lines are displayed across the entire set of tracks which shows the start and end of the loop.
580 \begin{enumerate}
581     \item  Highlighted selection repeats loop and takes precedence over all other possibilities.  
582         If the cursor is before the highlighted area, it will play up to the area and then repeat the highlighted section.  
583         If the cursor is after the highlighted section, play will start at the beginning until you get to the
584         highlighted section and then repeat.
585     \item  When both In and Out pointers are set, it repeats the section between [ and ].
586     \item  If only one of the In or Out pointers is set, it loops the whole media.
587 \end{enumerate}
588
589 \textit{Method 2:} Ctrl+Shift+transport button on the Timeline, Viewer, and Compositor
590
591 \begin{enumerate}
592     \item Repeats entire media if no In or Out pointer set.
593     \item  In and Out pointer set, repeats area between pointers.
594     \item  Only In pointer set, repeats from In to end of media.
595 \end{enumerate}
596
597 \subsubsection*{Last Play Position Memory}%
598 \label{ssub:last_play_position_memory}
599
600
601 When you play media, the start/end playback positions are saved as if they had been made into temporary labels.  
602 They appear on the timeline as purple/yellow hairline markers representing the last start/end labels for the last playback. 
603 They can be addressed as if they are label markers using:
604
605 \begin{description}
606     \item[Ctrl$\leftarrow$]   tab to the label before the cursor, that is \textit{play start}
607     \item[Ctrl$\rightarrow$]   tab to the label after the cursor, that is \textit{play stop}
608 \end{description}
609
610
611 You can use these markers for re-selection.  
612 Additionally, the selection region can be expanded by \textit{pushing} the markers using single frame playback.  
613 Use frame reverse (\texttt{keypad 4}) to push the start play marker backward, or use frame forward (\texttt{keypad 1}) to push the end play marker forward.
614
615 Another handy feature is to use the combination of Ctrl-shift-arrow (left or right) to select the media from the cursor position (red hairline) to the start or end marker by \textit{tabbing} to the label markers.  
616 For example, tab to the beginning of the previous play region using Ctrl-left-arrow to move the cursor to the beginning of last play, then press Ctrl-Shift-right-arrow to tab to the end of the playback region. 
617 Now you can clip/play/expand or edit the previous playback selection.
618
619 \begin{description}
620     \item[Ctrl SHIFT$\rightarrow$]        tab cursor to label right of cursor position and expand selection
621     \item[Ctrl SHIFT$\leftarrow$]         tab cursor to label left of cursor position and expand selection
622 \end{description}
623
624
625 \subsubsection*{Playback Speed Automation Support}%
626 \label{ssub:playback_speed_automation_support}
627  \index{autos!speed}
628
629 The speed automation causes the playback sampling rate to increase or decrease to a period controlled by the speed automation curve.  
630 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
631 the speed, read the section on Speed Automation~\ref{sec:speed_fade_automation_gang}.
632
633 \subsubsection*{Alternative to using Numeric Keypad for Playing}%
634 \label{ssub:alternative_to_using_numeric_keypad_for_playing}
635  \index{keypad}
636
637
638 For the keyboards without a numeric keypad or if you prefer to use keys closer to where you normally type, there are alternative keys for the play/transport functions.  These are listed below.
639
640 \begin{tabular}{lcl}
641         Alt + m&=&stop playback\\
642
643         Alt + j&=&forward single frame\\
644
645         Alt + k&=&forward slow playback\\
646
647         Alt + l&=&forward normal playback\\
648
649         Alt + ;&=&forward fast playback\\
650
651         Alt + u&=&reverse single frame\\
652
653         Alt + i&=&reverse slow playback\\
654
655         Alt + o&=&reverse normal playback\\
656
657         Alt + p&=&reverse fast playback\\
658 \end{tabular}
659 \begin{minipage}{.45\linewidth}
660 + Shift key, single frame forward/reverse will include audio; all others
661 will not include audio.
662 \vspace{1ex}
663
664 + Shift + Ctrl, results in the transport function operating only between the in/out pointers.
665 \end{minipage}
666
667 \section{Compositor Window}%
668 \label{sec:compositor_window}
669  \index{compositor!window}
670
671 \begin{figure}[htpb]
672     \centering
673     \includegraphics[width=0.99\linewidth]{compositor_window.png}
674     \caption{Left hand side are the toolbar functions / bottom bar has many control functions}
675     \label{fig:compositor_window}
676 \end{figure}
677
678 The Compositor window (figure~\ref{fig:compositor_window}) is used to display the timeline
679 output.  Playing and moving along the timeline video in the Program window shows in the
680 Compositor window what the current image is.  Here is where many compositing operations are
681 performed that can change 
682 what the timeline will look like.  When enabled, you can simply click the LMB in the Compositor
683 window to start and stop play.
684   You can zoom in and out to 
685 see small details, pan with the scrollbars, lock the window to prevent changes, add masks,
686 and make changes with the Projector and Camera function operators. These will be explained
687 in more detail in the following sections.
688
689 \subsection{Compositor Controls}%
690 \label{sub:compositor_controls}
691 \index{compositor!controls}
692
693 On the bottom of the window, there are many
694 of the same transport buttons \index{transport buttons} and controls that are available in the Program window.
695 They work the same as in the Program window and also have tooltips that are visible 
696 when you mouse over each of the icons so their use is fairly obvious.  However,
697 of particular note is the button \textit{Click to play} \index{click to play} which is described in~\ref{sub:click_to_play_in_viewer_and_compositor}.  Next is the \textit{Videoscope} \index{videoscope} button which is used to enable the scopes window
698 without having to apply the filter to the tracks/edits.
699
700 Next to all of these controls all the way to the right side, there is a \textit{zoom menu} \index{zoom!menu} and a \textit{tally light}.  The \textit{zoom menu} has a pulldown with different settings that you can choose from
701 or you can just use the tumbler arrows to the right. Generally when just getting started, you
702 will be using the default \textit{Auto} option.  The window size is not changed, but rather
703 the size of the video itself. In addition there are many shortcuts for zooming that you
704 will find in the Shortcuts chapter (\ref{cha:shortcuts}).
705
706 Using a RMB click in the compositor window brings up a menu with several options \index{compositor!RMB options}.  One of these
707 is \emph{Resize Window} which allows for resizing the entire window instead of just the video
708 and if you highlight that, you can choose from several variations for the window size. 
709 Other available options include self-explanatory ones of \emph{Fullscreen} with "f" as a toggle
710 to go to fullscreen and to revert to non-fullscreen and \emph{Zoom Auto}. 
711 As you would expect, whenever the video is zoomed so that only part of the image is visible
712 in the window, scrollbars are automatically added as needed on the bottom, the right hand 
713 side, or both.
714 Other options include \emph{Reset camera} and \emph{Reset projector} which obviously are used
715 to reset the camera and the projector (reference~\ref{sub:camera_and_projector}).  And
716 \emph{Camera/Projector keyframe} will create a keyframe at that point on the timeline for
717 X,Y, and Z without the requirement of being in \textit{Automatic Keyframe Mode}.  More 
718 information is described in the section \nameref{sec:compositor_keyframes}.
719 The \emph{Hide controls/Show controls} option is great for hiding the left hand toolbar and
720 bottom set of controls for a cleaner look. 
721
722 Next to the zoom tumbler arrows, is a \textit{tally light} that will be filled in with some color
723 (often red or blue) when a rendering operation
724 is taking place \index{rendering!operation light}. This is especially helpful when loading a very large video so you know
725 when it is finished loading.  You should pay attention to this \textit{tally light} when performing
726 a particularly time-consuming operation so that you do not keep executing more operations
727 that just have to wait until completion of that CPU intensive operation.  Also, you should look
728 to see if the light is on before assuming that \CGG{} is hung up.
729
730 When the window is unlocked, meaning that it is not in \textit{Protect video from changes} mode on the
731 toolbar, MMB clicking and dragging anywhere in the video pans the view.  Panning can also
732 be accomplished with the bottom and right hand side scroll bars when displayed.
733
734 \subsection{Compositor Toolbar}%
735 \label{sub:compositor_toolbar}
736 \index{compositor!toolbar}
737
738 On the left hand side of the Compositor window, there is a toolbar with several icons that
739 provide functions for viewing and compositing the video. Each of these operational features 
740 will be described in more detail next. 
741 \begin{description}
742     \item[Protect video from changes] this option makes it possible to disable changes to the
743 compositor output when clicking on the Compositor window. It allows for using the
744 \textit{Click to play} button (when enabled) for simply starting and stopping play.  It helps
745 to prevent an accidental click from making unwanted changes. When you enable this option, any
746 of the other enabled tools will automatically be disabled.
747
748      \item[Zoom view / magnifying glass] \index{zoom!slider} when enabled, the \textit{Zoom view} immediately results
749 in the addition of a zoom slider for fine viewing.  
750 The vertically oriented \textit{zoom slider} will be displayed underneath the last icon of the toolbar and extends
751 to almost the end of the toolbar.
752 The slider allows for adjusting the amount of zoom at any level between 0.01 and 100 based on a logarithmic scale.  
753
754 When using the zoom slider, the number by which the view is zoomed can be seen in the textbox 
755 on the bottom controls where the \% zoom is located.  
756 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.  
757 Once you have set the zoom to the desired size, use the vertical and horizontal scroll bars to position the view as needed.
758 As mentioned earlier, this
759 variety of zoom only affects the video and not the resizing of the Compositor window.  After
760 utilizing this slider bar for zooming around, you may want to switch back to \textit{Auto} 
761 using the controls on the bottom of the window.
762 This slider bar is also displayed
763 when you click on the icons for \textit{Adjust camera automation} or \textit{Adjust projector automation}.  
764
765 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
766 automatically pops-up the slider and the \textit{Protect video from changes} is disabled.  Also note that
767 there is a scroll bar on the bottom and right side of the image since the image at this magnification
768 does not fit in the window.
769 The Controls zoom textbox shows $\times0.82$ size.  
770 \end{description}
771
772 \begin{figure}[htpb]
773     \centering
774     \includegraphics[width=0.99\linewidth]{zoom_slider.png}
775     \caption{Compositor window zoom slider bar and scroll bars}
776     \label{fig:zoom_slider}
777 \end{figure}
778 \begin{description}
779     \item[Edit mask] \index{mask} brings up a mask editing menu with many versatile options as
780 described in great detail later in this section (\ref{sub:masks}). You may also have to click on
781 \textit{Show tool info} to popup the menu depending on whether or not you dismissed that window previously.
782     \item[Ruler] \index{ruler} this can be a handy tool to get the X,Y coordinates of an exact point or to 
783 measure the distance between 2 points. To use the \textit{Ruler}, move the mouse on the video to
784 get to the desired spot - these X,Y coordinates will be displayed in the \textit{Current} text
785 box.  Clicking the LMB creates Point 1 and then continue to hold down the LMB so that a ruler line is created between
786 this Point 1 and the stopping Point 2.  \textit{Deltas} is the X,Y difference between the 2 points;
787 \textit{Distance} is the number of pixels between the 2 points; and \textit{Angle} is the angle in degrees of the ruler line.  
788 In Figure~\ref{fig:safe_regions} you can see the Ruler menu on the right side of the Compositor window.
789
790 Holding down the Ctrl key while dragging with the LMB on one of the points, will
791 ensure that the line is always at a multiple of a 45 degree angle.  Holding down the Alt key while
792 dragging with the LMB on any of the points, will translate the ruler line to another place on 
793 the video while maintaining its length and angle. For some desktop window managers, such as 
794 \textit{UbuntuStudio 16.4} and \textit{Arch}, the Alt key is already in use by the Operating System
795 so you will have to use Alt+Ctrl instead.
796 If you dismiss the Ruler menu, click on
797 \textit{Show tool info} to get the menu to popup again.  
798     \item[Adjust camera automation] \index{camera} 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
799 section~\ref{sub:camera_and_projector}.
800     \item[Adjust projector automation] \index{projector} 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
801 subsequent section~\ref{sub:camera_and_projector}.
802     \item[Crop a layer or output] \index{crop} this is a cropping tool used to reduce the visible picture area.
803 More detail for usage is provided in a 
804 subsequent paragraph (\ref{sub:cropping}).  There is also a Crop \& Position plugin that provides
805 a different set of capabilities described in~\ref{sub:crop_position}.
806     Enable \textit{Show tool info} to get the menu to popup if it does not come
807 up automatically.
808     \item[Get color / eyedropper] \index{eyedropper} brings up the eyedropper used to detect the color at a
809 particular spot.  Enable the \textit{Show tool info} if the Color popup menu does not come up 
810 automatically or if that menu was accidentally dismissed.  Click on a specific color in the video
811 output with the LMB to see the selected color. You can then use that color's 
812 value to be applied to some effects depending on how the effect handles the eyedropper.  If you set the \textit{Radius} to a larger number, a square appears
813 around the cross cursor and an average value of the color will be the result.
814 If you \textit{Use maximum}, instead of an average value of the color, the result
815 will be the maximum of all values within that square.
816     \item[Show tool info] \index{tool info} this tool button is used in conjunction with the other tools on the
817 compositor's toolbar. You only need to click on this if one of these tools popup menu does not
818 come up or has been dismissed - Mask, Ruler, Camera, Projector, Crop, or Eyedropper tools.
819 You can also use it when highlighted to dismiss the highlighted tool's dialog box.
820 It is not needed for \textit{Protect video from changes}, \textit{Zoom view}, and \textit{Show safe regions} since they have
821 no dialog popup menus.
822
823 \begin{figure}[htpb]
824     \centering
825     \includegraphics[width=0.9\linewidth]{safe_regions.png}
826     \caption{Note the black outlines showing the safe regions. Also note the Ruler menu}
827     \label{fig:safe_regions}
828 \end{figure}
829
830     \item[Show safe regions] \index{safe region} draws 2 outlines to display the safe regions in the video as you
831 can see in Figure~\ref{fig:safe_regions}.
832 On some particular TVs/monitors/displays, the borders of the image are cut off and that
833 cut off section might not be as square as it appears in the compositor window. 
834 These are especially useful if the device for the output display is an older model TV\@.
835 The outside largest outline is the \textit{action safe overlay}; whereas the inside smallest
836 outline is the \textit{title safe overlay}.
837
838 Using the \textit{Show safe regions} has no affect on the rendered output.
839 The purpose of showing the borders is to make it easy to see where it might be cut off.  This
840 area outside the safe region can then be used as
841 a scratch or vertical blanking space.  Enabling the safe regions makes it really
842 easy to see these borders so that you can make sure 
843 titles are inside the inner outline and actions are inside the outer outline.
844
845 \end{description}
846
847 \subsection{Compositing}%
848 \label{sub:compositing}
849 \index{compositing}
850
851 Much of the editing in \CGG{} involves \textit{compositing} which is the combining of visual
852 elements from different sources into single images.  This includes such things as 
853 speeding up and slowing down the video, changing the resolution, creating a split screen, and fading in and out.
854 Compositing operations are done on the timeline and in the Compositor window using various
855 operations and other compositing attributes that are available in the Resources window.
856 When \CGG{} is performing a compositing operation it plays back through the
857 compositing engine, but when not, it uses the fastest decoder that it has.
858
859 \subsection{The Temporary, Track and Output Sizes}%
860 \label{sub:track_and_output_sizes}
861
862 This section explains a few things which help to understand Compositing - especially with relation
863 to the camera, effects, and the projector.
864
865 \subsubsection*{The Temporary}%
866 \label{ssub:output_size}
867 \index{temporary}
868
869 \CGG{}'s compositing routines use a \textit{temporary} which is a single frame of video in
870 memory where graphics processing takes place. The size of the temporary and of the output in
871 the compositing pipeline are different and vary for any particular frame.  Effects are processed in
872 the temporary and as such are affected by the temporary size.  In the case of the camera, its
873 viewport is the temporary size. However, projectors are rendered to the output and so are affected
874 by the output size. When the temporary is smaller than the output, the temporary will have blank
875 borders around the region in the output.  When the temporary is larger than the output, it will be
876 cropped.
877
878 \subsubsection*{Track and Output size}%
879 \label{ssub:track_size}
880 \index{track!size}
881 \index{output size}
882
883 The \textit{Track size} is used to define the temporary size with each track having a different size (viewports). It also serves to conform the input media to a chosen format (aspect ratio). So each track can have a different format (viewport).
884 You can see or set the track size by RMB click on a track and then select \emph{Resize Track} to resize
885 the track to any size. Or select \emph{Match output size} to make the track the same size as the
886 output. Or from the Resources window, RMB on a video media and choose \textit{Info} and then \textit{Resize}. When a track is resized then what it looks like on the compositor changes.  The relationship
887 between the track and the project's output size makes it possible to magnify or reduce the size of
888 a track in regards to the final output. This feature means you can create visual effects such as different aspect ratios, adjust split screens, zooms, and pans in the compositor.
889
890 The \textit{Output size} can be set in \texttt{File $\rightarrow$ New} when creating a new project,
891 or by using \texttt{Settings $\rightarrow$ Format}, or in the Resources window with RMB click on
892 a video asset and choosing \texttt{Match $\rightarrow$ Match project size}. When you \emph{Match project size}, you
893 are conforming the output to the asset. To change the size and aspect ratio of the output (Projector) we have to change the whole project, which will alter all the tracks in the timeline. Once you have set the output size in 1 of these 3 ways,
894 any newly created tracks will conform to the specified output size.  When rendering, the project's
895 output size is the final video track size where the temporary pipeline is rendered into. 
896
897 \subsubsection*{Aspect Ratio (Theory)}%
898 \label{ssub:aspect_ratio_theory}
899 \index{aspect ratio}
900 \index{PAR, DAR, SAR}
901
902 The aspect ratio is the ratio of the sides of the frame (\textit{Width} and \textit{Height}). For example, classically broadcast TV was 4:3 (= 1.33), whereas today it has changed to 16:9 (= 1.85); in cinema we use the 35 mm aspect ratio of 1.37 (Academic aperture), but even more so the super 35 mm (2.35). There are also anamorphic formats, i.e. that have no square pixels, like Cinemascope (2.35). The projection must be \textit{normalized} to have an undistorted view.
903
904
905 From the film or digital sensors of the cameras, we can extract any frame size we want. We are talking about \textit{viewports}, which we will examine shortly. Also important is the output of the film that will be rendered, because it is what we will see at the cinema, or on TV, or on the monitor of the PC, tablet or smartphone. Referring to figure~\ref{fig:temporary-01}, you can see these two possibilities: with the Camera you choose the size and aspect ratio of the source file (regardless of the original size); while with the Projector you choose the size and aspect ratio of the output.
906
907 The following formula is used to vary the aspect ratio:
908
909 \qquad $\frac{W}{H} =$ aspect ratio ($\frac{pixels}{pixels}$)
910
911 For example to obtain an aspect ratio of Super 35 mmm (2.35) starting from a FullHD file (1920x1080) whose base extension (1920) we want to keep:
912
913 \qquad $\frac{1920}{H} = 2.35$
914
915 from which: $H = 817$ pixels
916
917 \CGG{} allows you to vary the input and output aspect ratio in the ways indicated in the previous section: by varying the pixels of the sides or by setting a multiplication coefficient.
918
919 In \texttt{Settings $\rightarrow$ Format} there is the additional possibility to vary the shape of the pixels from 1:1 (square) to handle anamorphic formats. In such cases we use:
920
921 \qquad $PAR=\frac{DAR}{SAR}$
922
923 where:
924
925 \textit{DAR}= Display Aspect Ratio
926
927 \textit{PAR}= Pixel Aspect Ratio (1 or 1:1 is square)
928
929 \textit{SAR}= Storage Aspect Ratio (i.e media file aspect ratio)
930
931
932 \subsection{Camera and Projector}%
933 \label{sub:camera_and_projector}
934 \index{camera}
935 \index{projector}
936
937 In the compositor window, \textit{Adjust camera automation} and \textit{Adjust projector automation}
938 are editing tools to control operation of the camera and projector.  In \CGG{}'s compositing
939 pipeline, the camera determines where in the source the \textit{temporary} is copied from while
940 the projector determines where in the output the \textit{temporary} is copied to
941 (figure~\ref{fig:temporary-01}). 
942
943 \begin{figure}[htpb]
944     \centering
945     \includegraphics[width=0.8\linewidth]{temporary-01.pdf}
946     \caption{Compositing pipeline}
947     \label{fig:temporary-01}
948 \end{figure}
949
950 In compositing, each frame can be changed using various options and plugins, such as
951 a color correction plugin (figure~\ref{fig:camera_and_projector}).  After the image has been
952 modified, the final image is projected to the compositor so that you now have a changed original.
953
954 \begin{figure}[htpb]
955     \centering
956     \includegraphics[width=0.8\linewidth]{camera_and_projector.pdf}
957     \caption{Color3way on Temporary}
958     \label{fig:camera_and_projector}
959 \end{figure}
960
961 When editing the camera and projector in the compositing window, the affected track will be the
962 first track that is armed.  If there are multiple video tracks, you can select one specific track
963 for editing with a LMB click on the \textit{Arm track} icon of the desired track. This is called
964 "solo" the track. To reverse this solo-ing, LMB click on the icon again. 
965
966 \subsubsection*{Projector Compositing}%
967 \label{ssub:projector_compositing}
968 \index{projector}
969
970 The purpose of the \textit{projector} is to composite several sources from various tracks into one
971 output track.  The projector alignment frame is the same as the camera's viewport, except that it
972 shows where to put the contents of each temporary on the output canvas.  To get into projector
973 editing mode, click on the \textit{Adjust projector automation} icon in the Compositor toolbar. You
974 will then see red border lines surrounding the image and 2 diagonal lines criss-crossing in the 
975 middle, displayed in the video window.  The red outline indicates the size of the frame that will be
976 sent to the Output. You can easily drag the box with LMB, moving the frame in $x$ and $y$ directions.
977 When moving along the $z-axis$ (i.e.\ the zoom, with SHIFT+Drag) the box exactly follows the movement
978 and the size of the frame. After you position the video with the projector, you may next want to
979 \textit{Adjust camera automation}.
980
981 \subsubsection*{The Viewport}%
982 \label{ssub:viewport}
983 \index{viewport}
984
985 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.  To change the size and aspect ratio of the viewport (Camera \index{camera}) of a single track, right-click on the track in the timeline and choose Resize Track. Here we can vary the height and base of the viewport in pixels or choose the multiplication coefficient for each side (Scale). With OK we will see the change in the Compositor window with the new dimensions reflected in the green box. We can have different size viewports for each video track on the timeline. To go back, reset the viewport to the original value. 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:
986
987 \begin{enumerate}
988     \item  In the compositor window you should see the selected track.
989     \item  LMB click on the \textit{Adjust camera automation} to bring up the editing menu and the 
990 green and yellow colored outlines.
991     \item  Use the LMB to drag the video over the display in the compositor window to the desired
992 placement.
993 \end{enumerate}
994
995 When you drag over the viewport in the compositor window, it looks like you are moving the camera
996 with the mouse.  The viewport moves in the same manner.
997
998 \subsubsection*{Camera Compositing}%
999 \label{ssub:camera_compositing}
1000 \index{camera}
1001
1002 Select the camera button to enable camera editing mode. 
1003 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. 
1004 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.
1005
1006 \subsubsection*{Camera and Projector Menu}%
1007 \label{ssub:camera_and_projector_menu}
1008 \index{tool info}
1009 \index{camera}
1010 \index{projector}
1011
1012 The camera and projector have shortcut operations that do not appear in the popup menu and are not represented in video overlays. 
1013 These are accessed in the \emph{Show tool info} window.
1014 Most operations in the Compositor window have a tool window which is enabled by activating the question mark icon (figure~\ref{fig:camera_tool}).
1015
1016 \begin{figure}[htpb]
1017         \centering
1018         \includegraphics[width=0.8\linewidth]{camera_tool.png}
1019         \caption{Camera and Projector tool}
1020         \label{fig:camera_tool}
1021 \end{figure}
1022
1023 In the \textit{Position} section you can act on the $X$, $Y$ and $Z$ coordinates. By either tumbling or entering text directly or by using the slider, the camera and projector can be precisely positioned. There is also a reference to the color of the curve as we see it on the timeline. You can also define the \textit{range} of action which by default is [-100 to 100]. By pressing the Reset button for each coordinate, or the global Reset button, the range is automatically brought to the project size value (HD; 4k; etc), which are usually the most useful limits. Note that the range can also be changed in the \textit{Program} window, in the \textit{zoom bar}, where there are similar input fields to enter the chosen limits.
1024
1025 In the \textit{Justify} section we can use automatic positioning in the 6 standard coordinates: Left, Horizontal, Right, Top, Center and Bottom.
1026
1027 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. 
1028 The track size is set to the original size of the video and the camera is centered. 
1029 The output size is set to the reduced size of the video. 
1030 Without any effects, this produces just the cropped center portion of the video in the output.
1031
1032 The translation effect is dropped onto the video track. The input dimensions of the translation effect are set to the original size and the output dimensions are set to the reduced size. 
1033 To put the reduced video in the center subsection that the projector shows would require offsetting out $X$ and out $Y$ by a complicated calculation. 
1034 Instead, we leave out $X$ and out $Y$ at 0 and use the projector's tool window. 
1035 By selecting left justify and top justify, the projector displays the reduced image from the top left corner of the \textit{temporary} in the center of the output.
1036
1037 In the \textit{Curve type} section we can choose between various interpolation algorithms that determine the curve type \index{curve type}:
1038
1039 \begin{description}
1040         \item[smooth:] bezier interpolation which are flat at the endpts
1041         \item[linear:] piecewise linear curve.
1042         \item[tangent:] bezier interpolation with collinear endpts in a specified line.
1043         \item[free:] piecewise bezier, if there is such a thing.
1044         \item[bump:] has 2 values, one viewed from the left/right, discontinuous.
1045 \end{description}
1046
1047 In the \textit{Keyframe} section we can create new keyframes and set them as Bump autos (\textit{Right/Left edges} and \textit{Span} buttons). For further details see \nameref{sec:bump_autos}.
1048
1049 \subsubsection*{Reset to Default}%
1050 \label{ssub:reset_default}
1051
1052 In the compositing window, there is a popup menu of options for the camera and projector. Right click over the video portion of the compositing window to bring up the menu:
1053
1054 \textit{Reset Camera}: causes the camera to return to the center position.
1055         
1056 \textit{Reset Projector}: causes the projector to return to the center.
1057
1058 \subsubsection*{Use Case: Interaction Between Camera And Projector \protect\footnote{Example provided by Sam. The relative video is located at: \url{https://streamable.com/iq08i}}}%
1059 \label{ssub:use_case_interaction_camera_projector}
1060 \index{camera}
1061 \index{projector}
1062
1063 \begin{enumerate}
1064     \item Start by shrinking the projector to $z=0.500$ ($\frac{1}{4}$ of the original frame).
1065     \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.
1066     \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.
1067     \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.
1068     \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.
1069 \end{enumerate}
1070
1071 \subsection{Masks}%
1072 \label{sub:masks}
1073 \index{mask}
1074
1075 Masks can be used to accomplish various tasks but basically are used to select an area of the 
1076 video to be displayed or hidden. 
1077 They can be used in conjunction with another effect to isolate the effect to a certain region.
1078 Another usage is where you slightly delay one video track copy and unmask an area where
1079 the one copy has interference but the other copy does not.  Or use a mask when  color correction is
1080 needed in one part of a frame but not another.  A mask can be applied to just a small section of
1081 a color corrected track while a plain track shows through. 
1082 Removal of boom microphones, license plates, people and airplanes via mask is a very common usage.
1083
1084 The order of the compositing pipeline affects how masks are done. Usually masks are operated on the
1085 temporary, after the effects but before the projector. Because of the way this works, multiple
1086 tracks can be bounced to a masked track and projected with the same mask.
1087
1088 The compositing pipeline graph has a masking stage (figure~\ref{fig:temporary-02}).
1089
1090 \begin{figure}[htpb]
1091     \centering
1092     \includegraphics[width=0.7\linewidth]{temporary-02.pdf}
1093     \caption{Compositing pipeline with mask}
1094     \label{fig:temporary-02}
1095 \end{figure}
1096
1097 \subsubsection*{Compositing pipeline with masks}%
1098 \label{ssub:compositing_pipeline_with_masks}
1099 \index{compositing pipeline}
1100
1101 The Mask popup menu can be overwhelming upon first encounter.  However, if you follow the next
1102 few steps you can create a single simple mask without having to understand every possible parameter.
1103 Be sure you are working in a Format that includes the Alpha channel, YUVA or RGBA, because you need
1104 to have transparency for masking to show or will end up with only a black area.
1105 \begin{enumerate}
1106     \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}.
1107     \item  On the video, LMB click on the place where you want to start a mask.
1108     \item  Then LMB click on another spot of the image to create each new point of the mask. Once
1109 you have at least 3 points, lines will be drawn between them, but you can just create as many
1110 more points as you need and the lines will be redrawn to cover all points. When you 
1111 create each point of the mask a straight line curve is expanded, altering the shape of the mask.
1112 The mask position will always be in the same position on each image of the video unless you enable 
1113 \textit{Generate keyframes while tweaking} on the Program window Transport and Buttons bar. Then when 
1114 enabled you can move a mask over time.
1115      \item For a mask to be seen or not seen, there must be another video track under the track
1116 that you are viewing in the compositor.  An easy way to see the masked area is to just add an empty track
1117 below the target track and drag the \textit{Gradient} plugin to a highlighted area on that track.
1118      \item  You can move existing points to new locations by simply using the LMB at a point to
1119 drag that point to a different location.
1120     \item  The mask can be translated as a single entity by Alt-dragging the mask.  For some desktop
1121 window managers, such as \textit{UbuntuStudio 16.4} and \textit{Arch}, the Alt key is already in use
1122 by the Operating System so you will have to use Alt+Ctrl instead.
1123     \item To create curved instead of straight lines between the points, use  Ctrl-drag on a
1124 specific point. Using Ctrl-drag activates bezier handles (control points) to create these curves
1125 between the points. For example, on a mask with just two points, you can create a romantic heart mask.     
1126 \end{enumerate}
1127
1128 There are a lot more operations you can do using the Mask menu as shown in 
1129 figure~\ref{fig:mask_window}.  Detailed description is provided here next.  Note that the Mask
1130 window is separated into various sections to make it easier to locate the area of interest.
1131
1132 \begin{figure}[htpb]
1133     \centering
1134     \includegraphics[width=0.5\linewidth]{mask_window.png}
1135     \caption{Mask options window}
1136     \label{fig:mask_window}
1137 \end{figure}
1138
1139 \subsubsection*{Masks on Track section}%
1140 \label{ssub:masks_track_section}
1141
1142 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.
1143
1144 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.
1145
1146 \subsubsection*{Masks section}%
1147 \label{ssub:masks_section}
1148
1149 The \textit{Mask}: textbox will show you the mask numbers of $0-7$ or the 8 ascii character name that you have used to designate each mask number.  There is a pulldown on the right side to easily switch to another mask. 
1150
1151 The \textit{Delete} button is used to delete the mask number/name that is selected. The symbol to the right with tooltip of \textit{Delete all masks} can be used to delete all of the current video track masks.
1152
1153 The \textit{Select}: row of checkboxes is used to indicate which mask is currently displayed for that video track in the Compositor.  Numbers that are colored yellow are active masks for that track.  A tumbler to the right allows for quickly changing the mask number displayed.
1154
1155 The \textit{Enable} row of masks makes it so you can enable all or none of the masks, making it possible to look at no masks or at one mask without interference from the other masks. The symbol that looks like an \texttt{eye} can be used to easily check all or none as the tooltip \textit{Show/Hide mask states}.
1156
1157 \subsubsection*{Preset Shapes section}%
1158 \label{ssub:preset_shape_section}
1159
1160 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.  
1161
1162 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 \textit{Edit} pulldown (shortcut `z'or `Ctrl-z') to revert to the previous if you made this mistake.
1163
1164 \subsubsection*{Position \& Scale section}%
1165 \label{ssub:position_scale_section}
1166
1167 \textit{Center} mask button allows for quickly centering a mask on the video track. 
1168 \textit{Normalize} mask button makes it easy to normalize the size of the mask based on the scale of the video - about 1/4 the window size in the X and Y 
1169 directions.  Normalization makes the mask fit in the space to avoid having
1170 it wander off of the window, then you can move it around easily before resizing.
1171 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,
1172 such as \textit{UbuntuStudio 16.4} and \textit{Arch}, the Alt key is already in use by the Operating System
1173 so you will have to use Alt+Ctrl instead.
1174
1175 \texttt{xlate/scale x}  - drag translate constrained in the $X$ direction
1176
1177 \texttt{xlate/scale y}  - drag translate constrained in the $Y$ direction
1178
1179 \texttt{xlate/scale x/y}        - drag translate in both directions; this is the default and after using the other 2 options, you should reset to this to avoid future confusion while dragging.
1180
1181 \subsubsection*{Fade \& Feather section}%
1182 \label{ssub:fade_feather_section}
1183
1184 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. 
1185
1186 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 \protect\footnote{green is used in the default Cakewalk theme, but the background color will be different in other themes} 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:
1187
1188 Note1: The area outside the mask is referred to as the background.
1189
1190 Note2: The operational result is based on the maximum transparency value of that background.
1191
1192 \paragraph{Case 1, Positive Fade:} When the fade for all of the masks is positive, affecting the area inside of the mask, all of the
1193 background colors are at a transparency value of zero. So the largest transparency value is 0,and all masks are drawn with opaque backgrounds, depicted as one would expect.
1194
1195 \paragraph{Case 2, Negative Fade:} When the program computes the background color for any number of masks that includes negative
1196 mask(s), it uses the largest transparency number as the determining factor for the background. Only 1 of the masks can be largest, and wins for the background transparency result.
1197
1198 \vspace{3ex}\textit{Feather}: works in a similar manner to a \textit{gradient Fade} aligned on the mask boundary but is a logical function instead of a mathematical function so will be faster.  The \textit{Gang feather} symbol also works in a similar fashion and is surrounded by a colored background when it is in effect.
1199
1200 \subsubsection*{Mask Points section}%
1201 \label{ssub:masks_points_section}
1202
1203 This section is used to change to a different mask number and manipulate the masks you have created.
1204
1205 The \textit{Point}: textbox provides the ability to change which point number for the current mask that you want to work on.  It has a tumbler to allow for quickly switching the point number.  The \textit{X:} and \textit{Y:} boxes below reflect the current values and allow for modifying the $X/Y$ coordinates and these too have tumblers. The \textit{Delete} button will allow for deleting the selected point number.
1206
1207 The next 6 symbols in 2 columns represent \textit{Smooth} and \textit{Linear} buttons.  Smooth buttons use an algorithm based on the previous point and the next point to create a curved line. The smoothing operation takes three points, A, B, C, and arranges the slope at B to be AC as it moves to the next point for that mask.
1208
1209 \textit{smooth point}   $\rightarrow$ smooth a single point.
1210
1211 \textit{smooth curve}   $\rightarrow$ smooth all points on a mask edge curve.
1212
1213 \textit{smooth all}     $\rightarrow$ smooth all enabled masks on this track.
1214
1215 Linear buttons of \textit{linear point}, \textit{linear curve}, and \textit{linear all}, perform the inverse of the smooth functions.
1216 The control point vectors on the bezier endpoints are set to zero magnitude.
1217
1218 In addition there is a \textit{Markers} and a \textit{Boundary} checkbox which come in handy to turn off the display of the points and the outline of the mask.  Turning off \textit{Markers} is very useful when you have a lot of control points that clutter the display and make it more difficult to see the actual mask.  A helpful feature is available by disabling \textit{Markers} and enabling \textit{Boundary} which results in all masks being displayed in the viewer
1219 even if they are not enabled; for example you can then see mask 0, mask 1 \dots at the same time.
1220
1221 A \textit{gang} symbol on the right hand side of this section, tooltip of \textit{Gang points}, is another useful feature that makes it easy to drag a mask to an exact coordinate using the \textit{X} or \textit{Y} textbox for numerical input or the associated tumblers.  This works like the \texttt{Alt+LMB drag} translate but provides the ability to be precise.
1222
1223 \subsubsection*{Pivot Point section}%
1224 \label{ssub:pivot_point_section}
1225
1226 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.
1227
1228 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 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.
1229 Note that in order to be able to rotate/scale around pointer, the Focus checkbox must be unchecked.
1230
1231 \subsubsection*{Other sections}%
1232 \label{ssub:other_sections}
1233
1234 Finally there are the \textit{Apply masks before plugins} and \textit{Disable OpenGL masking} self-explanatory checkboxes.
1235
1236 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.
1237
1238 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:
1239
1240 \vspace{2ex}
1241 \begin{tabular}{ll}
1242     \hline                      
1243     Shift+LMB & move an end point \\
1244     Ctrl+LMB & move a control point \\
1245     Alt+LMB & to drag translate the mask \\
1246     Shift+MMB & set Pivot Point at pointer \\
1247     Wheel & rotate around Pivot Point \\
1248     Shift+Wheel & scale around Pivot Point \\
1249     Ctrl+Wheel & rotate/scale around pointer \\
1250     \hline  
1251 \end{tabular}
1252
1253 \subsubsection*{Key Alternatives}%
1254 \label{ssub:key_alternatives}
1255
1256 \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.
1257
1258 \vspace{2ex}
1259 \begin{tabular}{lp{11cm}}
1260     \hline                      
1261     LMB & move/create an end point (to move the end point the pointer must be above the point) \\
1262     Shift+LMB & move an end point (the pointer may be near the point, not above it) \\
1263     Ctrl+LMB & move/create a control point \\
1264     Alt+Ctrl+LMB & to drag translate the mask \\
1265     Shift+Key Delete & to delete the mask \\
1266     Shift+MMB & Set Pivot Point at pointer \\
1267     Alt+Wheel & zoom in/out the screen (also available in Ubuntu16 but does not exist in all distros) \\
1268     \hline  
1269 \end{tabular}
1270
1271 \vspace{2ex}
1272 Focus checkbox = unchecked:
1273
1274 \vspace{2ex}
1275 \begin{tabular}{ll}
1276     \hline                      
1277     Wheel & rotate around Pivot Point \\
1278     Shift+Wheel & scale around Pivot Point \\
1279     Ctrl+Wheel & rotate around pointer \\
1280     Ctrl+Shift+Wheel & scale around pointer \\
1281     
1282     \hline  
1283 \end{tabular}
1284
1285 \vspace{2ex}
1286 Focus checkbox = checked:
1287
1288 \vspace{2ex}
1289 \begin{tabular}{ll}
1290     \hline                      
1291     Wheel & rotate around Pivot Point (“Custom focus point”) \\
1292     Shift+Wheel & scale around Pivot Point (“Custom focus point”) \\       
1293     \hline  
1294 \end{tabular}
1295
1296 \vspace{2ex}
1297
1298 \subsection{Cropping}%
1299 \label{sub:cropping}
1300 \index{crop}
1301
1302 Cropping is used to reduce the visible picture area by changing the output dimensions, width and
1303 height in pixels, and the $X, Y$ values. An example of cropping and the crop menu is seen in
1304 figure~\ref{fig:cropped_area}.
1305 The easiest way to use cropping is to click with the LMB 
1306 at the spot to begin cropping and while holding down the LMB, drag the mouse. This creates a rectangular
1307 cropping area.  To change the size/location of that area, click on any of the 4 corner points
1308 with the LMB and drag.  While dragging, you will see 
1309 the X1, Y1 coordinates and W for width, H for height, in the Crop tool popup menu
1310 automatically change numerical value to reflect the current position. For precise locations, you
1311 can keyin exact values into those textboxes instead of using the mouse.
1312 Once you have the crop area defined as you want it, then click on the \textit{Apply} button to have
1313 the actual cropping take affect.
1314
1315 There are 3 choices of crop methods to choose in the menu pulldown on the bottom right side.
1316 \begin{enumerate}
1317      \item Reformat - Reformat Session crops and changes the Format for the entire session. 
1318 Because the Format is changed, this is applied to all tracks in the project. 
1319 The part of the image outside the rectangle will be cut off and the projector will make the video fit.
1320 The  \texttt{Settings $\rightarrow$ Format} window will show the new project Width and Height values and
1321 the projector tool window will show the new $X, Y$ values. Track size remains unchanged.
1322 You can undo the cropping by entering the original project dimensions in the
1323 \texttt{Settings $\rightarrow$ Format} window for the Width and Height.  You will also have to use the Projector
1324 tool in the Compositor toolbar to \textit{Ajdust projector automation} by clicking on the Reset icon.
1325      \item Resize - Resize Projector; to undo this, enable \textit{Adjust projector automation} 
1326 and do a Reset.
1327      \item Shrink - Resize Projector and Camera; to undo this, enable each of the \textit{Adjust
1328 projector and camera automation} tools, one at a time, and do a Reset in the menus.
1329 \end{enumerate}
1330 An important note here is that the original aspect ratio will be maintained so if your frame is
1331 rectangular (as many are) and you "crop" by surrounding the region of interest with a square,
1332 the cropped area will be more than you marked in order to keep the aspect rectangular shape.
1333 The Resize and Shrink options are applicable to all video tracks except the disarmed ones. 
1334 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.
1335 One last note of interest, this cropping is keyframable.
1336
1337 \begin{figure}[htpb]
1338     \centering
1339     \includegraphics[width=0.9\linewidth]{cropped_area.png}
1340     \caption{Crop menu and outlined crop rectangle on the right side}
1341     \label{fig:cropped_area}
1342 \end{figure}
1343
1344 An easy to follow step by step usage of the cropping tool is outlined next.
1345 \begin{itemize}
1346     \item Enable the crop tool in the compositor window to display the Crop popup menu.
1347     \item Click-drag in the video to define the crop area which draws a rectangle on the video.
1348     \item Click-drag in the video to start a different rectangle instead.
1349     \item Click-drag on a corner of the rectangle to reposition that corner.
1350     \item Alt-click in crop rectangle to translate the rectangle to a different position without resizing.
1351     \item The crop popup menu allows text entry of the top left coordinates ($X1,Y1$) and width and
1352 height ($W, H$) that define the crop rectangle. 
1353     \item Choose one of the 3 options of Reformat, Resize, or Shrink.
1354     \item When you have the rectangle where you want it,
1355 click on the \emph{Apply} button in the menu to actually perform the crop operation.
1356 \end{itemize}
1357  
1358
1359 \section{Viewer Window}%
1360 \label{sec:viewer_window}
1361 \index{viewer!window}
1362
1363 The Viewer window (figure~\ref{fig:viewer_window}) is convenient for previewing your media and 
1364 clips. It can also be used for editing with cuts and then paste operations into the timeline or
1365 to create a clip.  There are transport buttons \index{transport buttons} to use in the same manner as in the Program
1366 and Compositor windows or you can quickly move through the media by dragging with the LMB in
1367 the timebar above the transport buttons.  
1368
1369 \begin{figure}[htpb]
1370     \centering
1371     \includegraphics[width=0.99\linewidth]{viewer_window.png}
1372     \caption{Viewer Window - the red arrow "Play" button is left of the Videoscope button}
1373     \label{fig:viewer_window}
1374 \end{figure}
1375
1376 In order to view media in the window, you have to load it as follows:
1377
1378 \begin{enumerate}
1379     \item  In the Resources window, highlight the Media folder or the Clip folder.
1380     \item  Drag a file from the folder to the Viewer.
1381     \item  \textbf{Or} double LMB click on a media asset.
1382     \item  \textbf{Or} highlight an asset, RMB to bring up choices, and click on \textit{View} or
1383 \textit{View in new window}.
1384 \end{enumerate}
1385
1386 Note that you can have multiple Viewer windows open with different or even the same media asset.
1387 After the media is loaded you can use the transport buttons to play, rewind, stop, and so on, or
1388 for fast previewing drag with the LMB anywhere on the timebar slider.  There is also the Videoscope \index{videoscope}
1389 button which is to used to enable the scopes window without having to apply the filter to the tracks/edits.
1390 A few more options available in the Viewer window can be accessed with a RMB click on the display \index{viewer!RMB options}.
1391 These functions are listed next.
1392
1393 \begin{enumerate}
1394     \item  Switch to a fullscreen display by choosing \textit{Fullscreen}.  To switch back, click
1395 with the RMB on the display again and choose \textit{Windowed}.
1396     \item  Change the display size by choosing the \textit{Zoom} function to select a zoom level of
1397 25\%, 33\%, \ldots 300\%, or 400\% of the original media size.
1398     \item  To remove the current media from being displayed, choose \textit{Close source}.
1399 \end{enumerate}
1400
1401 The Viewer uses the project's output size output size{entry} format settings to display the media instead of the
1402 original asset's format. Operations performed in the Viewer affect a temporary EDL or a clip rather
1403 than the timeline.  By default, the Viewer window is automatically available but if it gets
1404 accidentally closed you can open it again by using the pulldown \texttt{Window $\rightarrow$ Show
1405 Viewer} to bring it back up.  More details for editing in the Viewer window with the Two Screen
1406 Editing method is explained in~\ref{sec:two_screen_editing}.
1407
1408
1409 \begin{figure}[htpb]
1410     \centering
1411     \includegraphics[width=1.0\linewidth]{viewer_audio.png}
1412     \caption{Viewer window at the top displaying same 5 seconds as seen in the Resources window thumbnail. At the bottom of the screen is the audio loaded on the timeline.}
1413     \label{fig:vieweraudio}
1414 \end{figure}
1415
1416 You can also use the Viewer to listen to media that consists only of Audio.  This is a quick way
1417 to listen to the audio to see if it is what you would like to add to a timeline audio track for
1418 your project.  To do this, you simply drag the audio file from the Resources window in the same
1419 manner as a video file. The viewer was designed to "view" images rather than play audio so in order
1420 to make it obvious that audio media is loaded to the viewer, a waveform \index{waveform} is displayed that is the
1421 same waveform as shown in the Resources window thumbnail when in the \textit{Display Icons} mode.
1422 This waveform only represents the first 5 seconds of the media and will not change or move while
1423 playing in the Viewer window.  But you can play the entire piece of media in the window
1424 and as you do so, you see the play cursor line move along and the timestamp reflect the actual
1425 position. You can also create clips. The entire waveform can only be seen on an actual audio track
1426 on the timeline. An example of what this looks like is shown in figure~\ref{fig:vieweraudio}.
1427
1428 \section{Options in both the Compositor and Viewer Windows}%
1429 \label{sec:options_in_both_the_compositor_and_viewer_windows}
1430
1431 The next sections describe capabilities that are available in both the Compositor and Viewer windows.
1432
1433 \subsection{Click to Play in Viewer and Compositor}%
1434 \label{sub:click_to_play_in_viewer_and_compositor}
1435
1436 In both the Viewer and Compositor windows, there is an arrow on the right hand side of the other
1437 buttons in the edit panel as shown in figure~\ref{fig:viewer_window}.  The "play" button can be
1438 toggled on/off via this arrow, which has a tooltip of \textit{Click to play} \index{click to play}.  When enabled
1439 the arrow is white surrounded by green and when disabled the arrow is red.\protect\footnote{the color and the look will be different for themes other than the default theme of Cakewalk}
1440 The purpose of enabling this capability is to make it really easy to play the media in the window
1441 by just using the left mouse button to start or stop the play.  The entire main canvas surface
1442 becomes a big play button!  Although the default is initially off, a good reason to enable this,
1443 at least temporarily, is so that you can quickly review your video before a render.
1444  
1445 \begin{description}
1446     \item[left click]  forward play or stop forward play if already playing
1447     \item[middle wheel]  single frame forward or back
1448     \item[middle click]  reverse play or stop reverse play if already playing. 
1449         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}.
1450 \end{description}
1451
1452 \subsection{Timebar + Preview Region Usage in the Compositor and Viewer}%
1453 \label{sub:timebar_preview_region_usage_in_the_compositor_and_viewer}
1454 \index{preview region}
1455
1456 The Viewer and Compositor each have a timebar \index{timebar} control area with a red indicator
1457 line below the video output. The timebar shows the whole time covered by the
1458 resource. When a video resource is loaded in the main window and you move in the
1459 compositor, the insertion pointer in the main window will reflect those movements.
1460 But in the viewer only that specific media is shown and there is no corresponding movement on the timeline.
1461
1462 \begin{figure}[htpb]
1463         \centering
1464         \includegraphics[width=1.0\linewidth]{timebar1.png}
1465         \caption{The mouse cursor, above the green colored “play forward” transport button, is on the timebar. Further to the right we see the red "indicator line".}
1466         \label{fig:timebar1}
1467 \end{figure}
1468
1469 Both the Compositor and Viewer support labels and in/out pointer which are dis-
1470 played in the timebar. And as with the movements, when you use the labels or
1471 in/out pointer in the compositor timebar, the result will also be reflected in the
1472 main window timebar. Along with that, of course, when you move to a label or
1473 in/out pointer in the compositor, the insertion point in the program window will
1474 go to that position.
1475
1476 The timebar in the compositor and the viewer covers the whole length of the resource
1477 loaded in there. Moving the mouse with the LMB pressed moves the position in the resources as indicated by the indicator line. A complete mouse movement between left and right edges of the window moves the indicator line by default along the whole timebar. With long resources it can be difficult to precisely locate sections in the resource. To make this easier, you can limit the effect of the same window-wide mouse movement to a smaller area of the timebar, this area is defined as the preview region. This region can also be moved along the timebar.
1478
1479 For instance, if you need to get a few 10 second clips from an 60 minute video, you could define a one-minute preview region, move it approximately to a place where a clip needs to be taken, and easily select with the mouse in and out points within the region, because the whole window mouse movement now covers 1 minute instead of 60 minutes.
1480
1481 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.  
1482 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.  
1483 The slider will be a dark red color while the selected preview region will remain the same initial black color.  
1484 There are either a left or right resize pointer and you can click and drag in either direction to expand or shrink the region.
1485
1486 \begin{figure}[htpb]
1487     \centering
1488     \includegraphics[width=1.0\linewidth]{timebar2.png}
1489     \caption{A left-facing arrow on the right side of the reddish slider bar is used to drag the bar.}
1490     \label{fig:timebar2}
1491 \end{figure}
1492
1493 \begin{figure}[htpb]
1494     \centering
1495     \includegraphics[width=1.0\linewidth]{timebar3.png}
1496     \caption{Here you can see the right-facing arrow used to drag the other end of the slider bar. The black area is the actual preview area.}
1497     \label{fig:timebar3}
1498 \end{figure}
1499
1500 You can slide the preview zone left or right by holding the right mouse button over the preview zone where you will see a fat double headed arrow.  
1501 The selected area will move left or right as you drag and still retains the same size.
1502
1503 \begin{figure}[htpb]
1504         \centering
1505         \includegraphics[width=1.0\linewidth]{timebar4.png}
1506         \caption{Note the double-headed fat arrow in the black preview area used to move the selection over.}
1507         \label{fig:timebar4}
1508 \end{figure}
1509
1510 Settings:
1511
1512 \begin{enumerate}
1513     \item  If no preview region is set, increasing the length of the media on the timeline by inserting media or appending, has no effect on the non-selected preview region.  That is, you will not see the reddish slider bar suddenly mysteriously appear.
1514     \item  If the preview region is set, when you replace the current project or file,  the preview region is automatically disabled.
1515     \item  If the preview region is set, when you append data or change the size of the current project, the preview region may appear to either move, shrink, or grow depending on the new length of the media on the timeline.  
1516     \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 red slider.
1517 \end{enumerate}
1518
1519 A good method for taking advantage of the preview region is described here.  
1520 On the main track canvas, scroll to the beginning of the area of interest.  
1521 When you do that, you will see in the compositor the red indicator line of that location.  
1522 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.  
1523 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.  
1524 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.
1525
1526 One last interesting item of note -- sometimes you may wish to see just a little more that is outside the preview region and you can do so!  You can actually move outside the compositor or viewer window space and view more, at least until you hit the end of the screen space.
1527
1528 \section{Resources Window}%
1529 \label{sec:resources_window}
1530 \index{resources window}
1531
1532 Effects, transitions, labels, clips, proxies, user bins, and media assets are accessed here. 
1533 Most of the resources are inserted into the project by dragging them out of the resource window. 
1534 Management of resource allocation is also performed here.
1535
1536 \begin{figure}[htpb]
1537     \centering
1538     \includegraphics[width=0.8\linewidth]{resource_window.png}
1539     \caption{Folders are in the first column with contents of that folder on the right hand side}
1540     \label{fig:resource_window}
1541 \end{figure}
1542
1543 The resources window is divided into two areas (figure~\ref{fig:resource_window}. 
1544 One area lists folders \index{folders} and another area lists the folder contents \index{folder contents}. 
1545 Going into the folder list and clicking on a folder updates the contents area with the contents of that folder. 
1546 The folders can be displayed as icons or text. 
1547 There are several variations for displaying the contents; select \emph{Display text}, \emph{Display icons}, \emph{Display icons packed}, \emph{Display icons list} as types of display for the assets or plugins. 
1548 Use the letter “\texttt{V}” to easily scroll through the choices and see which you prefer.  
1549 You can also get to these options from the menu by a right mouse click in the window.
1550
1551 A \emph{Search} \index{search resources} option is available for any of the folders in the Resources window (and when using \textit{Attach effect} on the main track canvas for the Plugins).  
1552 As you type in characters a match is made with that substring.  
1553 Names that do not match are filtered out making it a lot easier to find the item you are looking for.  
1554 The characters can be any where within the phrase and it does not matter if upper or lower case. 
1555
1556 Other options you will see if you \textit{right mouse click in the folder} which brings up the menu are described next \index{folders!RMB options}.  
1557
1558 \begin{description}
1559     \item[ Load files ]  for convenience to load files same as from the main window so you do not have to move the mouse so far in case you have multiple monitors.
1560     \item[Display text/icons]  as described previously for format variations preference.
1561     \item[Select]  options are All, Used, Unused, and None.  This gives you the capability to have a set of the
1562         contents highlighted for ease of use so you can see what is or is not loaded, or unset the highlight.
1563     \item[Sort items]  to sort the contents of the folder alphabetically.  Especially helpful if you accidentally did a 
1564         drag and changed your mind or dropped suddenly so that the assets no longer look nicely aligned.
1565     \item[Copy/Paste file list]  use to easily copy a set of files or paste a set of files between \CGG{} and other programs or operating system windows.
1566     \item[Snapshot/Grabshot]  use to take a quick snapshot or to grab a specific area on the screen.  These functions are described in detail in section \ref{sub:snapshot_grabshot}).
1567 \end{description}
1568
1569 Using the right mouse click to bring up a menu in the folder area \index{folders!RMB options}, you can also switch from Display text to Display icons, Sort items and create, delete and manipulate user defined folders/bins. Select Folder to create a user Folder or modify an existing folder.
1570
1571 If you \textit{right mouse click on a highlighted/selected resource}, several options are available depending on whether the resource is an effect or transition or a piece of media.  
1572 You can highlight several for some options so that it is applicable to all of them, such as Info.  
1573 Those listed immediately below are the available choices for media assets \index{asset!RMB options}.
1574
1575
1576 \begin{description}
1577     \item[Info] provided basic Asset information; details are described later in this section.
1578     \item[Display text/icons]  same as mentioned previously.
1579     \item[Sort]  same as mentioned previously.
1580     \item[Rebuild index] \index{rebuild index} if you switch from/to using ffmpeg/native for media loading, you should rebuild
1581         indexes.  Or if you get hangs on media or strange looking tracks, you might want to rebuild indexes.
1582     \item[View]  use this option to bring up the media in the Viewer window.
1583     \item[View in new window]  in order to not overwrite your current viewer window, you can open any
1584         number of viewer windows to simultaneously view multiple media.
1585     \item[Open mixers]  when you record with multiple cameras setup, you can work with them most easily
1586         using the mixer mode.  This is described in detail
1587     \item[Paste]  
1588     \item[Match] \index{match format} if you need to change your media parameters you can choose from the following: Match frame
1589         rate, Match project size, Match all 
1590     \item[Remove] \index{remove asset} use to Remove the asset from the project or with caution, to Remove from disk permanently.
1591 \end{description}
1592
1593 In the case of Effects or Transitions \index{effects/transitions info}, a right mouse click on a highlighted selection leads to an \emph{Info} button which gives a short 1 line description of what the effect/transition can be used for.
1594 For Labels \index{label!RMB options}, choices are \emph{Edit}, \emph{Label}, and \emph{Go to}.
1595 For Clips \index{clip!RMB options}, \emph{Nest} and \emph{UnNest} as described elsewhere are available.
1596
1597 \subsection{Info Asset Details}%
1598 \label{sub:info_asset_details}
1599 \index{asset!info}
1600 The asset \emph{Info} window also can be used to display detailed information about the selected/highlighted media file -- available for any loaded media of type mpeg or ffmpeg.  
1601 This is extremely helpful in determining what type of media it is, size, resolution, format, and type/number of audio streams.  It is especially useful for multiple program streams.  You can have the info window popped on several of your assets simultaneously.
1602
1603 \textit{Detail} opens an additional window with more information.
1604
1605 \textit{Sample rate} and \textit{Frame rate} allows you to impose a different sampling or Fps of the audio and video assets.
1606
1607 Another option is \textit{Resize} button, which allows you to change the size (in pixels) of the frame of the asset.
1608
1609 \textit{Asset's interlacing}  is the type of interlacing the asset has: If the file is (H)DV type, recognition and configuration is done automatically. All other media types will be set unknown. So we have to manually set the interlacing \protect\footnote{From Igor ubuntu's mail}.
1610
1611 Figure~\ref{fig:info_asset_details} shows the \textit{Detail} box to click on the left side and a simple, typical output in the Asset Detail window on the right side.  Also, note the highlighted media in the Resources window.
1612
1613 \begin{figure}[htpb]
1614     \centering
1615     \includegraphics[width=0.99\linewidth]{info_asset_details.png}
1616     \caption{Info windows with the “Detail” box}
1617     \label{fig:info_asset_details}
1618 \end{figure}
1619
1620 \subsection{User Folders/Bins}%
1621 \label{sub:user_folders_bins}
1622 \index{user folders/bins}
1623 \index{user media bin}
1624 \index{user clip bin}
1625 \index{folder modify}
1626 \index{folder add filter/search}
1627
1628 Creating folders that are more specific to a particular project is helpful in better organizing your work.  
1629 This can be done by utilizing the files already loaded to the \textit{master} Media or Clips folders in the Resources window.  The general rule is you can only drag clips to a ClipUserBin and you can only drag media to a MediaUserBin.
1630
1631 Below are steps illustrating an easy way to set up a folder.
1632
1633 %TODO Below part need to be rewriten
1634 \begin{enumerate}
1635     \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.  
1636         Highlight, then click \textit{New Media or Clips}.
1637         \begin{figure}[htpb]
1638             \begin{minipage}{.6\linewidth}
1639                 \centering
1640                 \includegraphics[width=0.9\linewidth]{folder_resources.png}
1641                 \caption{Highlight, then click “New Media or Clips”.
1642                     “Modify folder” can be used to change the name of a folder.
1643                     “Delete folder” in the popup can be used to delete a folder.
1644                 }
1645                 \label{fig:folder_resources}
1646             \end{minipage}
1647             \hfill
1648             \begin{minipage}{.37\linewidth}
1649                 \centering
1650 %begin{latexonly}
1651                 \vspace{18ex}
1652 %end{latexonly}
1653
1654                 \includegraphics[width=0.9\linewidth]{folder_new.png}
1655                 \caption{Type in your folder name in the textbox.  Click OK.}
1656                 \label{fig:folder_new}
1657             \end{minipage}
1658         \end{figure}
1659     \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.
1660      \begin{figure}[htbp]    
1661         \centering
1662         \includegraphics[width=0.9\linewidth]{folder_master.png}
1663         \caption{The “master” Media folder}
1664         \label{fig:folder_master}
1665      \end{figure}     
1666     \item  Select the \textit{master} Media folder to see which files are currently loaded, figure~\ref{fig:folder_master}.  
1667         Highlight the files there that you want to copy to your new folder (named Photos of Garden).  
1668         Drag the files to the left and when you see the Photos of Garden folder become highlighted, then drop there.  
1669         You can drag and drop any of the media from the \textit{master} Media at any time.  
1670         It flashes when the drop is successful.
1671 \end{enumerate}
1672
1673 Adding the Shift key before the actual drop, will allow for relative path filenames instead of full path.
1674 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.  
1675 In this case you will want to click on the \textit{Modify folder} in the popup.  
1676 When you bring up the Modify folder window, if you already have files in that folder, you will see filters that were generated automatically when you did a Drag and Drop.
1677
1678
1679 \begin{figure}[htpb]
1680     \centering
1681     %\includegraphics[width=0.8\linewidth]{name.ext}
1682     \begin{tikzpicture}[scale=1, transform shape]
1683         \node (img1) [yshift=0cm, xshift=0cm, rotate=0] {\includegraphics[width=0.7\linewidth]{folder_modify.png}};
1684         \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 }};
1685         \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.}};
1686         \draw [->, line width=1mm] (Arrow1) edge  ([yshift=-20mm] img1.north west);
1687         \end{tikzpicture}
1688     
1689     \caption{Modify target}
1690     \label{fig:modify-target}
1691 \end{figure}
1692
1693 To delete the entire set of files listed on the filter rule, highlight the rule line and hit the \textit{Del} button.  
1694 To add a new filter rule, click on the \textit{Add} button which will automatically add a default line after any current lines.  
1695 The default line will be a line that matches everything in the \textit{master} Media folder which is \textit{Or  Patterns  Matches   *}.  
1696 Click the right mouse button on the current field underneath the column header to see the choices available for each column.  
1697
1698 Modifications will not be in effect until you click on the green arrow OK button or click on the Apply button.  
1699 But once you hit Apply, clicking on the red X button will not undo your changes.  
1700 The filter/search rules are applied in the order listed in the Modify folder window.  
1701 You can change the order of the filter rules by highlighting the rule you want to move and then drag and drop to a new location.
1702
1703 The figure~\ref{fig:modify_folder} below displays the available choices for each field.
1704
1705 \begin{figure}[htpb]
1706     \centering
1707     %\includegraphics[width=0.8\linewidth]{name.ext}
1708     \begin{tikzpicture}[scale=1, transform shape]
1709         \node (img1) [yshift=0cm, xshift=0cm, rotate=0] {\includegraphics[width=0.8\linewidth]{modify_folder1.png}};
1710         \node (img2) [yshift=-1cm, xshift=3.5cm, rotate=0] at (img1) {\includegraphics[width=0.8\linewidth]{modify_folder2.png}};
1711         \node (img3) [yshift=-1cm, xshift=3cm, rotate=0] at (img2){\includegraphics[width=0.5\linewidth]{modify_folder3.png}};
1712     \end{tikzpicture}
1713     \caption{The available choices for each field}
1714     \label{fig:modify_folder}
1715 \end{figure}
1716
1717 Information about the columns and rules for the search filters in the Modify folder window follows \index{folder add filter/search}.
1718
1719 Column headers:
1720
1721 \begin{description}
1722 \item[ Enable]  this column is used to designate the state of that filter rule
1723     \begin{description}
1724         \item[ Off]             disable the filter
1725                 \item[And]              narrow your search; all of your search terms must be present
1726                 \item[Or]               broaden your search to include more values
1727                 \item[And Not]  exclude terms that do not contain the given value from your search results
1728                 \item[Or Not]   include terms that do not contain the given value from your search results
1729     \end{description}
1730 \item [Target] – this column designates which media asset attribute to look at
1731     \begin{description}
1732         \item[ Patterns]        each line contains a filename filter, matches the file path
1733                 \item[Filesize] number of bytes in a file
1734                 \item[Time]             date file was created
1735                 \item[Track Type]       track type of video, audio, or audio video (for both)
1736                 \item[Width]    Format width
1737                 \item[Height]   Format height
1738                 \item[Framerate]        Video framerate
1739                 \item[Samplerate]       Audio samplerate
1740                 \item[Channels] Number of audio channels
1741                 \item[Duration] Playback time in seconds -- it uses the largest of audio or video if contains both
1742     \end{description}
1743 \item[Op] – boolean operators used to narrow or broaden the relationship between your search terms
1744     \begin{description}
1745         \item[Around]   about this value; use \textit{+radius} for a search range: [target–radius$\dots$  target+radius]
1746         \item[Eq        ]       equal to
1747         \item[Ge]       greater than or equal to
1748         \item[Gt]       greater than
1749         \item[Ne]not equal
1750         \item[Le]       less than or equal
1751         \item[Lt] less than
1752         \item[Matches]  exactly matches for strings
1753     \end{description}
1754 \end{description}
1755
1756 \textbf{Value} --- the characteristic you are looking for with expressions that can be written with the following:
1757
1758 \begin{description}
1759 \item[Number] (decimal points are allowed and will be converted to a standard form):
1760     \begin{description}
1761         \item[inf] representing infinity
1762         \item[\#[TtGgMmKk]]  ---  where \# represents a number and the characters mean:
1763     \end{description}
1764
1765     \begin{tabular}{rcl}
1766         inf&=& infinity\\
1767         T&=&1099511627776\\
1768         t&=&1000000000000\\
1769         G&=&1073741824\\
1770         g&=&1000000000\\
1771         M&=&1048576\\
1772         m&=&1000000\\
1773         K&=&1024\\
1774         k&=&1000\\
1775     \end{tabular}
1776
1777 \item[Scalar:] 
1778
1779     \begin{tabular}{l}
1780         Number\\
1781         Number+Number\\
1782     \end{tabular}
1783 \item[Date time:]
1784     \begin{tabular}{rcl}
1785         date&=&year/month\\
1786         date&=&year/month/day\\
1787         time&=&hour:minute\\
1788         time&=&hour:minute:second\\
1789         date\_time&=&date time\\
1790     \end{tabular}
1791
1792   \item[Duration:]
1793       \begin{tabular}{rcl}
1794     day  &=&    \#day     | \#days\\
1795     week &=&    \#week    | \#weeks\\
1796     month&=&    \#month | \#months\\
1797     year &=&    \#year    | \#years\\
1798     delta&=&secs\\
1799     delta&=&mins:secs\\
1800     delta&=&hours:mins:secs\\
1801       \end{tabular}
1802
1803 \item[Around time:]
1804     date time+duration
1805
1806   \item[Around length:]
1807     duration+duration
1808
1809 \end{description}
1810
1811 Table showing the allowed usage:
1812
1813 %TODO create table for below code
1814 \begin{lstlisting}[numbers=none]
1815 target:    |  eq  ge  gt  ne  le  lt   matches  around
1816 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++
1817 patterns   | <---- strcmp ---------> + filter + nearest
1818 file_size  | <---- arithmetic -------+------> + radius
1819 mod_time   | <---- arithmetic -------+------> + radius
1820 track_type | <---- member test ------+--------+------>
1821 width      | <---- arithmetic -------+------> + radius
1822 height     | <---- arithmetic -------+------> + radius
1823 framerate  | <---- arithmetic -------+------> + radius
1824 samplerate | <---- arithmetic -------+------> + radius
1825 channels   | <---- arithmetic -------+------> + radius
1826 duration   | <---- arithmetic -------+------> + radius
1827 \end{lstlisting}
1828
1829 where in the above, the filter can be:
1830
1831 \begin{tabular}{rcl}
1832     filter&=&list\\
1833     filter&=&token\\
1834     list&=&[token]\\
1835     list&=&[token]list\\
1836     string&=&<chars>|<empty>\\
1837     token&=&string\\
1838     token&=&string*token\\
1839 \end{tabular}
1840
1841 Examples with some caveats first:
1842
1843 \begin{enumerate}
1844     \item   \textit{Or} generally includes or adds whereas \textit{And} generally excludes or subtracts.
1845     \item   The filters only work on media in the folder; if there is no media, then there is nothing to search.
1846     \item   The examples below are not meant to be executed as a list of filters in Modify folder, they are just single line examples to indicate what can work.
1847     \item   Sort is by filename base name (directory path not included automatically) except when the \textit{Around} operation is used and then it is sorted by that Target distance first and then filename.
1848 \end{enumerate}
1849
1850 \begin{table}[htpb]
1851     \centering
1852     \caption{Examples}
1853     \label{tab:label}
1854     \small
1855     \begin{tabular}{lllm{10em}m{10em}} \toprule
1856         Enable& Target& Op&     Value&  meaning\\\midrule
1857 Or      &Patterns  &Matches   &*&        all files from the Media folder are included\\
1858 And Not&Filesize&Lt     &160000000& no files that are less than 160MB in size \\
1859 Or Not& Time    &Ge     &2018/07/30 06:13:00    & files not greater than or equal date\\
1860 And     &Duration&Eq    &01:00          & files included must have 60 secs. Duration\\
1861 Off     &Samplerate&Ne  &44000          & off for now, but may want to include later\\
1862 And     &Framerate&Around&24+1          & files included all have 24 to 25 framerate\\
1863 Or      &Patterns&Matches&[*.mp4]       & all files with the extension of mp4\\
1864 Or      &Time&  Around&2018/08/02 06:00:00 + 02:00:00  & files at 4AM to 8 AM\\\bottomrule
1865     \end{tabular}
1866 \end{table}
1867
1868
1869 \subsection{Vicons \& Aicons – aka Video Icons / Audio Icons}%
1870 \label{sub:vicons_aicons_aka_video_icons_audio_icons}
1871 \index{vicon!video icons}
1872 \index{aicon!audio icons}
1873
1874 Vicons are video icons.  
1875 Aicons are audio icons.  
1876 By default the Resources window will play the first 5 seconds of video or audio waveform looped in the area occupied by the media icons (figure~\ref{fig:vicons1}). 
1877 This is enabled for the Media/Proxy folders in icon mode when the mouse pointer is inside the Resources window. 
1878
1879 \begin{figure}[htpb]
1880     \centering
1881     \includegraphics[width=0.99\linewidth]{vicons1.png}
1882     \caption{Note "Full Play" mode and Vicons and Aicons in Media folder}
1883     \label{fig:vicons1}
1884 \end{figure}
1885
1886 The waveform \index{waveform} in the figure~\ref{fig:vicons2} is displayed in the Resources window in the color green for the 3 audio tracks. 
1887 There is a colored bar \index{color bar aicons} 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.  
1888 There are various other colors between these colors same as that seen in the color spectrum in the screenshot below.  
1889 Colors are utilized from the hue wheel in the counter-clockwise direction.  
1890 Note that the horizontal line in the middle of the a-icon is yellow/red representing the 2 audio tracks and is only red for mono.
1891
1892
1893
1894 \begin{figure}[htpb]
1895     \centering
1896     %\includegraphics[width=0.8\linewidth]{name.ext}
1897     \begin{tikzpicture}[scale=1, transform shape]
1898         \node (img1) [yshift=0cm, xshift=0cm, rotate=0] {\includegraphics[width=0.99\linewidth]{vicons2.png}};
1899         \node (img2) [yshift=0cm, xshift=2.8cm, rotate=0] at (img1.south west) {\includegraphics[width=0.3\linewidth]{hue_wheel.png}};
1900         \node [yshift=-5mm, xshift=1cm,anchor=west] at (img2.east) (Arrow1) {\parbox{18em}{Color hue wheel. For illustration only}};
1901         \draw [->, line width=1mm] (Arrow1) edge  ([yshift=-5mm] img2.east);
1902     \end{tikzpicture}
1903     \caption{Draw Vicons   |            Screenshot display various audio file lengths; red is shortest.}
1904     \label{fig:vicons2}
1905 \end{figure}
1906
1907 Note that if in \texttt{Settings $\rightarrow$ Preferences} under the Appearance tab, you have unchecked \textit{Use thumbnails in resource window} you will only have default icons and none of the above capabilities.
1908
1909
1910 \subsection{Resources Window Preview Mode}%
1911 \label{sub:resources_window_preview_mode}
1912 \index{resources preview}
1913
1914
1915 Preview mode can be used to pop up a window which draws the vicons/aicons thumbnails in a larger size.  
1916 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. 
1917 The Preview mode/playback toggle is to the right of the Visibility label as seen in the screenshot above. 
1918 Preview mode is available for the Media, Proxy, Media User Bins, and Clips but clips are only 1 image.
1919
1920 When \textit{Preview/draw vicons} is enabled/active, if you click on one of the video icons or an audio waveform icon, a view pops up that increases the size to 4 times the surface area larger. 
1921 This makes it easier to see or hear if it is the media you are looking for in case you have many similar media files. 
1922 To conserve memory, the video is stored 8\,bits per pixel which results in low image quality while the audio is 16\,bit. 
1923 The reason for playing 5 seconds of a video for a vicon is that until the first I-frame, the media frequently does not decode properly.  
1924 In other words, a lot of media does not begin at the \textit{beginning} point and will not be properly rendered until enough data has been read to assemble a picture.  
1925 You can increase the thumbnail size, clarity of pixels (memory size) and color mode but it takes a lot more memory.  
1926 Change these values in \texttt{Settings $\rightarrow$ Preferences}, Appearance tab, right hand side of the Layout section -- be aware that when you click OK, your session will re-initialize.  
1927 You can also temporarily increase the preview mini-window by use of the mouse wheel up or down.
1928
1929 There are 4 options for the preview mode.
1930
1931 \begin{enumerate}
1932     \item  \emph{Full Play} \index{full play} is the default mode.  
1933         This means all of the media will automatically play when the mouse is in the Resources window and you can use the left mouse button to click on specific media to see it pop up in a larger view.  
1934         Audio only files do not play the audio until the icon is clicked on and the waveform aicon pops up into the 4x larger mode. 
1935         \emph{Full Play} includes the \emph{Mouse Over} capabilities as described below as well as the Inter-View \emph{Src Target} functions.
1936
1937         \item  \emph{No Play} \index{no play} mode is especially useful on smaller computers and for users who find the constant loop play to be somewhat distracting.
1938
1939         \item  \emph{Mouse Over} \index{mouse over} mode is activated by a single click on one of the vicons/aicons and deactivated with another single click over any of the icons.  
1940     Once activated, whenever you just move the mouse over an icon, it automatically pops up the increased size preview.  
1941     The first time in your session that you enable this feature, it may take a few seconds to load all of the icon previews into memory so be patient and just wait.  
1942     \emph{Mouse Over} mode makes it quick and easy to preview without having to drag the media to the viewer.  
1943     You can still drag the media same as without preview enabled.  
1944
1945         \item  \emph{Src Target} \index{source target} mode gives easy access to the Inter-View source target available by using the middle mouse button on media.  
1946     There are 2 advantages to this mode -- there is no 5 second play loop taking up cpu time and the popup allows for the use of the letter “\texttt{f}” on that popup to have it go to fullscreen mode.  
1947     \emph{Src Target} mode in any scenario never plays sound as that is nonsensical usage.  
1948     After the initial click to pop media in this mode, you also have the \emph{Mouse over} feature.
1949 \end{enumerate}
1950
1951 For any of the options, but not \emph{No Play}, you can temporarily turn off that option by clicking on the button using the middle mouse button.  
1952 This helps to avoid having the thumbnail get in the way of dragging or other functions.  
1953 When you do, a line will be drawn through the current preview mode so that you are aware that it is in \emph{No Play} mode until click it again.
1954
1955 Note that if in \texttt{Settings $\rightarrow$ Preferences} under the Appearance tab, you have unchecked \textit{Use thumbnails in resource window} you will only have default icons and no active previews.
1956
1957 \begin{figure}[htpb]
1958     \begin{minipage}{.69\linewidth}
1959         \centering
1960         \includegraphics[width=0.99\linewidth]{preview_icon_mode.png}
1961         \caption{The location of the Preview/Draw Icons mode.}
1962         \label{fig:preview_icon_mode}
1963     \end{minipage}
1964     \hfill
1965     \begin{minipage}{.29\linewidth}
1966         \vspace{2ex}
1967         \centering
1968         \includegraphics[width=0.7\linewidth]{line_through_mode.png}
1969         \caption{Note the line through the mode.}
1970         \label{fig:line_through_mode}
1971     \end{minipage}
1972 \end{figure}
1973
1974
1975
1976 \subsection{Moving clips/media from/to Resources window}%
1977 \label{sub:moving_clips_media_from_to_resources_window}
1978 \index{copy/paste from/to resources window}
1979
1980 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:
1981
1982 Copy or paste a list of files in the Media Resources window:  
1983
1984
1985 \begin{enumerate}
1986     \item  create a highlighted selection of the desired media files in the media Resources window
1987     \item    right click on an unused portion of that window to bring up the popup menu
1988     \item     select the \textit{Copy file list} item and a file list box will appear that contains the full path filenames
1989     \item     wipe the textbox using your standard copy/paste method to put the list of files in the copy buffer
1990     \item     in another \CGG{} instance, choose the \textit{Paste file list} of the media Resources window
1991     \item     paste the list of files, again using your standard paste method, into the new file list box; press OK
1992     \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).
1993 \end{enumerate}
1994
1995 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.  
1996
1997 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.  
1998 Since the procedure varies among the distros, you will have to adapt to your specific one.  For example, a usage for ubuntu consists of:
1999 \begin{enumerate}
2000     \setcounter{enumi}{3}
2001     \item   Ctrl-c to copy the list of files; open gedit; Ctrl-v to paste the list of files into gedit
2002     \item   Ctrl-c or the standard way using the right click to copy this list from gedit
2003     \item Ctrl-v paste the list of files into the new file list box, and press OK
2004 \end{enumerate}
2005
2006 \begin{figure}[htpb]
2007     \centering
2008     \begin{minipage}{.9\linewidth}
2009     \centering
2010         \includegraphics[width=0.99\linewidth]{copy_files1.png}
2011     \end{minipage}
2012     \vfill
2013     \begin{minipage}{.5\linewidth}
2014     \centering
2015         \includegraphics[width=0.99\linewidth]{copy_files2.png}
2016     \end{minipage}
2017     \caption{Example of copy file list}
2018     \label{fig:copy_files1}
2019 \end{figure}
2020
2021 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.  
2022 Note how it includes the full pathname.
2023
2024 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.
2025
2026
2027 Another possible usage of this capability:
2028
2029 \begin{enumerate}
2030     \item  Right Click on the Clips Resources window and use the \textit{Paste Clip} option to paste the Copy selection as a clip.  
2031     \item  Similarly, by highlighting a clip in the Resources window and selecting its copy popup menu item using the right mouse button, that copy buffer can now be loaded onto the timeline.
2032 \end{enumerate}
2033
2034
2035 \subsection{Snapshot / Grabshot}%
2036 \label{sub:snapshot_grabshot}
2037 \index{snapshot}
2038 \index{grabshot}
2039
2040 \begin{figure}[htpb]
2041     \centering
2042     \begin{minipage}{.49\linewidth}
2043     \centering
2044     \includegraphics[width=0.8\linewidth]{snapshot.png}
2045     \caption{Snapshot menu and choices}
2046     \label{fig:snapshot}
2047     \end{minipage}
2048     \begin{minipage}{.49\linewidth}
2049     \centering
2050     \begin{tikzpicture}[scale=1, transform shape]
2051         \node (img1) [yshift=0cm, xshift=0cm, rotate=0] {\includegraphics[width=0.65\linewidth]{grabshot.png}};
2052         \node (img2) [yshift=2cm, xshift=-1cm, rotate=0] {\includegraphics[width=0.07\linewidth]{reticle.png}};
2053     \end{tikzpicture}
2054     \caption{Grabshot reticle \& orange box}
2055     \label{fig:grabshot_recticle}
2056     \end{minipage}
2057 \end{figure}
2058
2059 To take a snapshot, perform the following steps:
2060
2061 \begin{enumerate}
2062     \item set your timeline insert marker where you want the snapshot -- this frame shows in the compositor
2063     \item  right click in an empty spot in the media folder and the popup shows snapshot as the $5^{th}$ item down
2064     \item  highlight that and the submenu comes up allowing you to choose png, jpg, ppm or tiff
2065 \end{enumerate}
2066
2067 The snapshot shows up in the Media folder.  
2068 It is saved by default in \texttt{/tmp} as
2069
2070 \texttt{snap\_date-time.ext} BUT you can change the default directory path in \texttt{Settings $\rightarrow$ Preferences $\rightarrow$ Interface tab} in the right hand side of the Editing section.
2071
2072 Grabshot is the $6^{th}$ menu item.  
2073 A red circle reticle can be moved to the area to grab; use left mouse drag to surround an area; and right click to grab.
2074
2075
2076
2077
2078 \section{Other Options and Other Windows}%
2079 \label{sec:other_options_and_other_windows}
2080
2081 \subsection{Transport Controls}%
2082 \label{sub:transport_controls}
2083 \index{transport buttons}
2084
2085 Transport controls are useful for navigation and for playing media.  
2086 Each of the Viewer, Compositor, and Program windows has its own transport panel.  
2087 The controls generally all contain a colored tooltip when you mouse over the control, providing a hint of their function and shortcuts for usage.
2088
2089 The transport panel is controlled by the keyboard as well as the graphical interface. 
2090 For each of the operations it performs, the starting position is the position of the insertion point in the Program window and the slider in the Compositor and Viewer windows. 
2091 The ending position is either the end or start of the timeline or the end or start of the selected region if there is one.
2092
2093 The orientation of the end or start depends on the direction of playback. 
2094 If it is forward the end position is the end of the selected region. 
2095 If it is backward the end position is the start of the selected region.  
2096 The insertion point moves to track playback. 
2097 When playback stops, the insertion point stays where playback stopped. 
2098 Thus, by playing back you change the position of the insertion point. 
2099 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).  
2100 Hitting any key on the keyboard twice pauses it. 
2101 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.
2102
2103 When using frame advance functions the behavior may seem odd. 
2104 If you frame advance forward and then frame advance backward, the displayed frame does not change. 
2105 This is because the playback position is not the frame but the time between two frames. 
2106 The rendered frame is the area that the playback position crosses. 
2107 When you increment the time between two frames by one and decrement it by one, you cross the same frame both times and so the same frame is displayed.  
2108 There is an option in \texttt{Settings $\rightarrow$ Preferences, Appearance tab} to \textit{Always show next frame} that may help make this clearer for some users.
2109
2110 The transport behavior changes if you hold down Ctrl when issuing any of the transport commands. This causes the starting point to be the In point if playing forward and the Out point if playing backward. If playing forward, the Out point becomes the ending point and if playing backward, the In point becomes the ending point. If no In/Out points are specified, the behavior falls back to using the insertion point and track boundaries as the starting and ending points.
2111
2112 The transport behavior also changes if you hold down the Shift key along with KeyPad 1--6.  
2113 If normally audio is included in the play, it will be removed and if normally audio is not included in the play, it will be added.
2114
2115
2116 \subsection{Zoombar}%
2117 \label{sub:zoombar}
2118 \index{zoom}
2119
2120 The compositor has zoom capability. 
2121 The pull-down menu on the bottom of the compositor window has a number of zoom options. 
2122 When set to Auto the video is zoomed to match the compositor window size as closely as possible. 
2123 When the video is zoomed bigger than the window size,  you can use scrollbars to scan around or if the zoom icon is enabled, the middle mouse button can be used to zoom in or out the video.
2124
2125 The zoom toggle also causes the Compositor window to enter zoom mode. 
2126 In zoom mode, clicking in the video output zooms in while a Ctrl-click in the video output zooms out. 
2127 If you have a wheel mouse, rotating the wheel zooms in or out too. 
2128 Zooming in or out with the zoom tool does not change the rendered output. 
2129 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. 
2130 This could affect performance on slower systems
2131
2132 \subsection{Show Overlays}%
2133 \label{sub:show_overlays}
2134 \index{show ovelays window}
2135
2136 Color Coded Keyframe Curves are a big feature in the \textit{Show Overlays} window because by changing the colors to suit the user, it helps to remove confusion from multiple curves on the track canvas.  
2137 They can be viewed from the pulldown menu of \texttt{Window $\rightarrow$ Show overlays} but they will operate the same as when used from the \textit{View} pulldown menu.  
2138 The \textit{Color Coded Keyframe Curves} have distinct colors associated with each type for ease of identification.  
2139 By clicking LMB on the \textit{Color Ball} to the right of any keyframe type in the \textit{Show overlays} menu you have the ability to change the colors to whatever works best for your video.  
2140 The color ball changes made will be retained across sessions.
2141
2142 There is a line separating the first 4 items, which are just non-automation type settable values as opposed to \textit{auto} keyframe types.  
2143 The color is not changeable for the 3 items of Mode, Pan, and Mask which simply display their symbol icon.
2144
2145 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.  
2146 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.
2147
2148 \begin{figure}[htpb]
2149     \centering
2150     \includegraphics[width=0.85\linewidth]{overlays_window.png}
2151     \caption{Show Overlays window on the left with the Color ball window to the right to set color}
2152     \label{fig:overlays_window}
2153 \end{figure}
2154
2155 Figure~\ref{fig:overlays1} shows several color coded lines for different keyframes along with the Fade slider for manipulation.  
2156 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.
2157
2158 \begin{figure}[htpb]
2159     \centering
2160     \includegraphics[width=1.0\linewidth]{overlays1.png}
2161     \caption{Lines are colored here on the timeline as designated in Show Overlays}
2162     \label{fig:overlays1}
2163 \end{figure}
2164
2165 Overlays Window Nuances:
2166
2167 The Overlays window is an alternative to the main track canvas \textit{View} pulldown, and thus the order is mostly maintained to match each other.  
2168 To make it easier to get a quick temporary look at a specific option, there is a shortcut of Shift-LMB (left mouse button) that can be used as opposed to having to uncheck everything that is currently checked and then having to recheck them on when done.  
2169 Here is a list of how they work.  Keep in mind that if the Expander on the patchbay is enabled, you still see the track.
2170
2171 \begin{itemize}
2172     \item  Shift+LMB (left mouse button) in the Overlays Window on a checkbox will turn off all other
2173         checkboxes except for the one you are on.  Then this named box will have outline for a  \textit{hot} spot.
2174     \item  Shift+LMB on this \textit{hot} spot will return to \textit{cool} of the previous settings with all of the previous
2175         checkboxes checked again.
2176 \end{itemize}
2177
2178 \begin{figure}[htpb]
2179         \begin{minipage}{.29\linewidth}
2180                 \centering
2181                 \includegraphics[width=0.99\linewidth]{overlays_list1.png}
2182                 \caption{Original Settings --- cool spot}
2183                 \label{fig:overlays_list1}
2184         \end{minipage}
2185         \hfill
2186         \begin{minipage}{.29\linewidth}
2187                 \centering
2188                 \includegraphics[width=0.99\linewidth]{overlays_list2.png}
2189                 \caption{Note Titles box hot spot  }
2190                 \label{fig:overlays_list2}
2191         \end{minipage}
2192         \hfill
2193         \begin{minipage}{.29\linewidth}
2194                 \centering
2195                 \includegraphics[width=0.99\linewidth]{overlays_list3.png}
2196                 \caption{Cam/Proj XYZ toggle to fine tune}
2197                 \label{fig:overlays_list3}
2198         \end{minipage}
2199 \end{figure}
2200
2201 \begin{itemize}
2202     \item  Shift+LMB on a non-\textit{hot} spot will simply check or uncheck a box and there is no previous state.
2203     \item This all works in conjunction with the \textit{View} pulldown menu which, of course, has no hot spots.
2204     \item  Caveat \#1 - Shift+LMB on the top 4 choices of Assets, Titles, Transitions, Plugin Keyframes will turn
2205         off all of the checkboxes below because it makes sense to do so.
2206     \item  Caveat \#2 - Shift+LMB on the Autos will not turn off Assets, Titles, Transitions, or Plugin Keyframes
2207         because you need to be able to see what is going on.
2208         \item Caveat \#3 - XYZ toggle on/off of Camera and Projector are not affected.
2209 \end{itemize}
2210
2211
2212
2213
2214 \subsection{Sound Level Meters Window}%
2215 \label{sub:sound_level_meters_window}
2216 \index{sound level meters window}
2217
2218 An additional window, the levels window, can be brought up from the \textit{Window} pulldown.  
2219 The levels window displays the output audio levels after all mixing is done.  
2220 The visible range of the sound level meters is configurable in \texttt{Settings $\rightarrow$ Preferences, Interface tab} under the Operations section.
2221
2222 \begin{wrapfigure}[18]{O}{0.3\linewidth} 
2223         \centering
2224         \vspace{-2ex}
2225         \includegraphics[width=0.5\linewidth]{volume_meter.png}
2226         \caption{Sound Level Meters Window}
2227         \label{fig:volume_meter}
2228 \end{wrapfigure}
2229
2230 Sound level meters can be toggled in the viewer and compositor windows with the show meters button.  
2231 They also appear in the patchbay when the track is expanded and in the recording monitor when audio is being recorded. 
2232
2233 The sound levels in the levels window, compositor, and viewer correspond to the final output levels before they are clipped to the sound card range.  
2234 In the record monitor they are the input values from the sound card.  
2235 In the patchbay they are the sound levels for each track after all effects are processed and before down-mixing for the output.  
2236 Most of the time, audio levels have numerical markings in dB but in the patchbay there is not enough room.
2237
2238 The sound level is color coded as an extra means of determining the sound level.  
2239 Even without numerical markings, the sound level color can distinguish between several ranges and overload.  
2240 Look at the color codings in a meter with numerical markings to see what colors correspond to what sound level.  
2241 Then for meters in the patchbay in expanded audio tracks, use the color codings to see if it is overloading.
2242
2243 Be aware that sound levels in \CGG{} can go above 0 dB.  
2244 This allows for not only seeing if a track is overloading but how much information is being lost by the overloading.  
2245 Overloading by less than 3 dB is usually acceptable.  
2246 While overloading is treated as positive numbers in \CGG{}, it is clipped to 0 when sent to a sound card or file.
2247
2248
2249 %%% Local Variables:
2250 %%% mode: latex
2251 %%% TeX-master: "../CinelerraGG_Manual"
2252 %%% End: