Credit Andrea with a lot of clarification work
[goodguy/cin-manual-latex.git] / parts / Windows.tex
index d20465bf60e0e5e9797257ab02daf10a15b007c3..546a55515cf67949cfa6daa14ddc7ae3face050a 100644 (file)
     \label{fig:Fenstergrundposition-en}
 \end{figure}
 
-First it is important to know what an EDL is. When \CGG{} saves a file, it saves the EDL,
+First, it is important to know what an EDL is. When \CGG{} saves a file, it saves the EDL,
 Edit Decision List, of your project which contains all the settings and locations of edits
-and pointers to the media so that the media is not modified. The EDL is described in \nameref{sec:edl_edit_decision_list}.
+and pointers to the media so that the media is not modified. The EDL is described 
+in \nameref{sec:edl_edit_decision_list}.
+
+Second, for those users who would like to keep all 4 windows together for a better workflow,
+see \nameref{sec:focus_group}.
 
 \section{Program Window}%
 \label{sec:program_window}
 \index{program window}
 
-The main window is called the \textit{Program} window and is often just referred to as the \textit{timeline} \index{timeline}.  Here is where you enter the main menu operations.  
+The main window is called the \textit{Program} window and is often just referred to as the \textit{timeline}\index{timeline}.  Here is where you enter the main menu operations.  
 This timeline consists of a vertical stack of tracks with time represented horizontally on the track. 
 It is the output of the rendering operations and this is what is saved when you run the \textit{File} pulldown, Save command.
-Immediately to the left of the timeline is the patchbay \index{patchbay}. The patchbay contains options that affect each track.  
+Immediately to the left of the timeline is the patchbay\index{patchbay}. The patchbay contains options that affect each track.  
 These options are described in great detail in \nameref{sec:patchbay}.
 
 The \textit{Window} pulldown on the main window contains options
@@ -180,7 +184,7 @@ Use the tumbler arrows to the left of the numbers for the minimum value and the
 Good default values for audio fade are -40.0 to 6.0 and for video fade are 0.0 to 100.0. 
 The tumbler arrows change curve amplitude, but the only way to curve offset is to use the fit curves button on the curve itself.
 
-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
+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
 position of the timeline and the selection length is 0.
 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}.  
 It has no function without that flag set.
@@ -293,6 +297,13 @@ There are numerous methods to cut and paste in \emph{drag and drop mode} by sett
 a selected region or using the Copy/Paste Behavior as outlined in~\ref{sub:copy_paste_behavior}. 
 In this mode, clicking the LMB in the timeline does not reposition the \textit{Insertion Point}. 
 
+\begin{figure}[htpb]
+       \centering
+       \includegraphics[width=0.4\linewidth]{i-beam.png}
+       \caption{I-beam + in/out  +  labels}
+       \label{fig:i-beam}
+\end{figure}
+
 When the I-beam is highlighted, you are in \emph{cut and paste mode}.
 In cut and paste mode, clicking the LMB in the timeline does reposition the \textit{Insertion Point}. 
 Double clicking in the timeline selects the entire edit the cursor is over, i.e.\ that column. 
@@ -300,13 +311,6 @@ Dragging in the timeline with the LMB pressed down, highlights a selected region
 and paste operations.  It is also the playback range used for the subsequent playback operation. 
 Holding down the Shift key while clicking in the timeline extends the highlighted region.
 
-\begin{figure}[htpb]
-    \centering
-    \includegraphics[width=0.4\linewidth]{i-beam.png}
-    \caption{I-beam + in/out  +  labels}
-    \label{fig:i-beam}
-\end{figure}
-
 \subsection{In/Out Points}%
 \label{sub:in_out_points}
 \index{in/out point}
@@ -355,6 +359,12 @@ Some of the useful operations concerning the In/Out pointers are listed next.
     \item[Ctrl-t]  clears both In/Out points
 \end{description}
 
+\subsection{Guide on timeline}%
+\label{sub:guide_timeline}
+\index{guide lines}
+
+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.
+
 \subsection{Labels}%
 \label{sub:labels}
 \index{label}
@@ -665,16 +675,9 @@ will not include audio.
     \label{fig:compositor_window}
 \end{figure}
 
-The Compositor window (figure~\ref{fig:compositor_window}) is used to display the timeline
-output.  Playing and moving along the timeline video in the Program window shows in the
-Compositor window what the current image is.  Here is where many compositing operations are
-performed that can change 
-what the timeline will look like.  When enabled, you can simply click the LMB in the Compositor
-window to start and stop play.
-  You can zoom in and out to 
-see small details, pan with the scrollbars, lock the window to prevent changes, add masks,
-and make changes with the Projector and Camera function operators. These will be explained
-in more detail in the following sections.
+The Compositor window (figure~\ref{fig:compositor_window}) is used to display the timeline output.  Playing and moving along the timeline video in the Program window shows in the Compositor window what the current image is.  Here is where many compositing operations are performed that can change what the timeline will look like and that is why it is called \textit{canvas}. The canvas dimesions correspond, by default, to the W/H values set in the project (\textit{Set Format} window).
+
+When enabled, you can simply click the LMB in the Compositor window to start and stop play. You can zoom in and out to see small details, pan with the scrollbars, lock the window to prevent changes, add masks, and make changes with the Projector and Camera function operators. These will be explained in more detail in the following sections.
 
 \subsection{Compositor Controls}%
 \label{sub:compositor_controls}
@@ -856,14 +859,7 @@ to the camera, effects, and the projector.
 \label{ssub:output_size}
 \index{temporary}
 
-\CGG{}'s compositing routines use a \textit{temporary} which is a single frame of video in
-memory where graphics processing takes place. The size of the temporary and of the output in
-the compositing pipeline are different and vary for any particular frame.  Effects are processed in
-the temporary and as such are affected by the temporary size.  In the case of the camera, its
-viewport is the temporary size. However, projectors are rendered to the output and so are affected
-by the output size. When the temporary is smaller than the output, the temporary will have blank
-borders around the region in the output.  When the temporary is larger than the output, it will be
-cropped.
+\CGG{}'s compositing routines use a \textit{temporary} which is a single frame of video in memory where graphics processing takes place. By default the size of the temporary is that of the project ($W \times H$), i.e., the output size. But if the tracks on the timeline have various sizes different from those of the project, then the temporary will take the size of the active track (viewport = green border). We can also change the size of the viewport using the Camera tool, as well as pans and zooms the temporary displayed in it. Effects are processed in the temporary and as such are affected by the temporary size.  In the case of the camera, its viewport is the temporary size.  The size of the temporary and of the output in the compositing pipeline can be different and vary for any particular frame. However, projectors are rendered to the output and so are affected by the output size. The temporary is the basis on which the Projector tool acts to display the canvas on the Compositor window. The canvas always has the size of the project, although with the projector we can make pans and resizes of the red border inside it. When the temporary is smaller than the output, the temporary will have blank borders around the region in the output.  When the temporary is larger than the output, it will be cropped.
 
 \subsubsection*{Track and Output size}%
 \label{ssub:track_size}
@@ -882,7 +878,11 @@ or by using \texttt{Settings $\rightarrow$ Format}, or in the Resources window w
 a video asset and choosing \texttt{Match $\rightarrow$ Match project size}. When you \emph{Match project size}, you
 are conforming the output to the asset. To change the size and aspect ratio of the output (Projector) we have to change the whole project, which will alter all the tracks in the timeline. Once you have set the output size in 1 of these 3 ways,
 any newly created tracks will conform to the specified output size.  When rendering, the project's
-output size is the final video track size where the temporary pipeline is rendered into. 
+output size is the final video track size where the temporary pipeline is rendered into.
+
+To clarify, let's take an example.
+
+If we load a media (M) into Resources and adjust the size of the project to the size of M, we will get the canvas size of the media $W_{M} \times H_{M}$). We can see in the Set Format window that the project's default values ($W \times H$) have changed to those of M ($W_{M} \times H_{M}$). The tracks on the timeline can have different sizes, but what we will see on the canvas, that is, in the Compositor window, is always the output size i.e. the size of the project. Tracks with smaller sizes will be seen with black bands; tracks with larger sizes will be cropped. Each track has its own size but we will see it inserted in the output size. If we change the output size the tracks will not change, remaining in their original size. We can only change the size of the tracks by manually acting on each one in the ways seen before. Finally, if we create a new track in a project of size $W \times H$, it will assume the size of the project automatically.
 
 \subsubsection*{Aspect Ratio (Theory)}%
 \label{ssub:aspect_ratio_theory}
@@ -918,6 +918,14 @@ where:
 
 \textit{SAR}= Storage Aspect Ratio (i.e media file aspect ratio)
 
+In practice, there can be a problem with anamorphic format rendering as desired because it does
+not use square pixels.  So, for example, FFV1 format in the mkv container will ignore the DAR
+(Display Aspect Ratio).  You can check if your media is anamorphic format using the \textit{Mediainfo}
+program.  If the Width/Height is 720/576 (=1.25) and DAR is 16/9 (=1.777) then you have non-square
+pixels.  SAR (Storage Aspect Ratio) is different from DAR and you have to use a workaround as 
+described at the "Cinelerra for Grandma" site by Raffaella Traniello:
+{\small\url{http://www.g-raffa.eu/Cinelerra/HOWTO/anamorphic.html}} . 
+
 
 \subsection{Camera and Projector}%
 \label{sub:camera_and_projector}
@@ -1045,7 +1053,7 @@ In the compositing window, there is a popup menu of options for the camera and p
        
 \textit{Reset Projector}: causes the projector to return to the center.
 
-\subsubsection*{Use Case: Interaction Between Camera And Projector \protect\footnote{Example provided by Sam. The relative video is located at: \url{https://streamable.com/iq08i}}}%
+\subsubsection*{Use Case: Interaction Between Camera And Projector \protect\footnote{Example provided by Sam. The relative video is located at: \url{https://youtu.be/ZQaLZiYY1lg}}}%
 \label{ssub:use_case_interaction_camera_projector}
 \index{camera}
 \index{projector}
@@ -1090,6 +1098,8 @@ The compositing pipeline graph has a masking stage (figure~\ref{fig:temporary-02
 
 The Mask popup menu can be overwhelming upon first encounter.  However, if you follow the next
 few steps you can create a single simple mask without having to understand every possible parameter.
+Be sure you are working in a Format that includes the Alpha channel, YUVA or RGBA, because you need
+to have transparency for masking to show or will end up with only a black area.
 \begin{enumerate}
     \item To define a mask, in the Compositor window click on the \textit{Edit mask} icon to get the popup Mask menu.  If the menu does not come up, click on the \textit{Show tool info}.
     \item  On the video, LMB click on the place where you want to start a mask.
@@ -1346,7 +1356,7 @@ click on the \emph{Apply} button in the menu to actually perform the crop operat
 
 \section{Viewer Window}%
 \label{sec:viewer_window}
-\index{viewer window}
+\index{viewer!window}
 
 The Viewer window (figure~\ref{fig:viewer_window}) is convenient for previewing your media and 
 clips. It can also be used for editing with cuts and then paste operations into the timeline or
@@ -1375,7 +1385,7 @@ Note that you can have multiple Viewer windows open with different or even the s
 After the media is loaded you can use the transport buttons to play, rewind, stop, and so on, or
 for fast previewing drag with the LMB anywhere on the timebar slider.  There is also the Videoscope \index{videoscope}
 button which is to used to enable the scopes window without having to apply the filter to the tracks/edits.
-A few more options available in the Viewer window can be accessed with a RMB click on the display \index{viewer RMB options}.
+A few more options available in the Viewer window can be accessed with a RMB click on the display \index{viewer!RMB options}.
 These functions are listed next.
 
 \begin{enumerate}
@@ -1544,7 +1554,7 @@ The characters can be any where within the phrase and it does not matter if uppe
 Other options you will see if you \textit{right mouse click in the folder} which brings up the menu are described next \index{folders!RMB options}.  
 
 \begin{description}
-    \item[ Load files ]  for convenience to load files same as from the main window so you do not have to move the mouse so far in case you have multiple monitors.
+    \item[Load files ]  for convenience to load files same as from the main window so you do not have to move the mouse so far in case you have multiple monitors.
     \item[Display text/icons]  as described previously for format variations preference.
     \item[Select]  options are All, Used, Unused, and None.  This gives you the capability to have a set of the
         contents highlighted for ease of use so you can see what is or is not loaded, or unset the highlight.
@@ -1709,7 +1719,7 @@ Column headers:
 \begin{description}
 \item[ Enable]  this column is used to designate the state of that filter rule
     \begin{description}
-        \item[ Off]            disable the filter
+        \item[Off]             disable the filter
                 \item[And]             narrow your search; all of your search terms must be present
                 \item[Or]              broaden your search to include more values
                 \item[And Not] exclude terms that do not contain the given value from your search results
@@ -1717,7 +1727,7 @@ Column headers:
     \end{description}
 \item [Target] – this column designates which media asset attribute to look at
     \begin{description}
-        \item[ Patterns]       each line contains a filename filter, matches the file path
+        \item[Patterns]        each line contains a filename filter, matches the file path
                 \item[Filesize]        number of bytes in a file
                 \item[Time]            date file was created
                 \item[Track Type]      track type of video, audio, or audio video (for both)
@@ -1856,8 +1866,8 @@ Or        &Time&  Around&2018/08/02 06:00:00 + 02:00:00  & files at 4AM to 8 AM\\\bottom
 
 \subsection{Vicons \& Aicons – aka Video Icons / Audio Icons}%
 \label{sub:vicons_aicons_aka_video_icons_audio_icons}
-\index{vicons : video icons}
-\index{aicons: audio icons}
+\index{vicon!video icons}
+\index{aicon!audio icons}
 
 Vicons are video icons.  
 Aicons are audio icons.  
@@ -1912,7 +1922,7 @@ The reason for playing 5 seconds of a video for a vicon is that until the first
 In other words, a lot of media does not begin at the \textit{beginning} point and will not be properly rendered until enough data has been read to assemble a picture.  
 You can increase the thumbnail size, clarity of pixels (memory size) and color mode but it takes a lot more memory.  
 Change these values in \texttt{Settings $\rightarrow$ Preferences}, Appearance tab, right hand side of the Layout section -- be aware that when you click OK, your session will re-initialize.  
-You can also temporarily increase the preview mini-window by use of the mouse wheel up or down.
+You can also temporarily increase the preview mini-window by use of the mouse wheel up or down for media but not for clips.
 
 There are 4 options for the preview mode.
 
@@ -2072,7 +2082,7 @@ A red circle reticle can be moved to the area to grab; use left mouse drag to su
 
 Transport controls are useful for navigation and for playing media.  
 Each of the Viewer, Compositor, and Program windows has its own transport panel.  
-The controls generally all contain a yellow colored tooltip when you mouse over the control, providing a hint of their function and shortcuts for usage.
+The controls generally all contain a colored tooltip when you mouse over the control, providing a hint of their function and shortcuts for usage.
 
 The transport panel is controlled by the keyboard as well as the graphical interface. 
 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.