additional Sergio corrections as he proofreads while also translating to Spanish
[goodguy/cin-manual-latex.git] / parts / Windows.tex
index b662a49fd0a745d057bb33382e80d3d112ca33c8..10597b84be1b83073f5d648c4d0e03d00babda68 100644 (file)
@@ -137,7 +137,8 @@ The Track Menu contains a number of options:
     \item[Move down]  moves the selected track one step down in the stack of its corresponding type - audio or video.
     \item[Delete track]  removes the track from the timeline.
     \item[Add Track]  adds a track of the same media type as the one selected, audio or video, above the selected track.
-    \item[Find in Resources]  that media file will be highlighted in the media folder in the Resources window.
+    \item[Find in Resources]  that media file will be highlighted in the media folder in the Resources window. If the 
+       Resources window is closed, media is found and highlighted but the Resources window is not displayed.
     \item[Show edit]  will point out the exact start and stop points along with the length of the current edit on
         that track as well as the media name, track name and number, and edit number.
     \item[User title]  is used to change the title name.  This is really handy for files that have very long and
@@ -254,7 +255,7 @@ If only the Out point is set, when you click the Out point icon the Out point wi
 Holding the Shift key while clicking on an In/Out point, the area between the insertion point and that
 In/Out point will be highlighted or extended to that In/Out point if already highlighted. 
 
-An easy way to turn off the In/Out points if both are set, is to double click on the [ icon. 
+An easy way to turn off the In/Out points if both are set, is to double click on the [ icon in the toolbar
 If you have already set the In and Out points, and then move the insertion point anywhere to the left of
 the Out point, a LMB click on the [ icon will move the In point to the location of the insertion point.  In the same
 manner if you move the insertion point anywhere to the right of the In point, a LMB click on the ] icon
@@ -321,7 +322,7 @@ With labels you can also select regions:
 If you LMB click the label button when an area is highlighted, labels are created at each end of the
 highlighted area. 
 When a label is selected, if you click on the label icon, the label will be deleted. 
-To delete multiple labels, highlight that area, then use the \texttt{Edit $\rightarrow$ Clear labels}
+To delete multiple labels, highlight that area, then use the \texttt{Edit $\rightarrow$ Clear $\rightarrow$ Clear labels}
 function to delete them all. The same precedence rules apply to this operation as mentioned earlier.  That
 is, if both In/Out points are set and there is a highlighted area also set, the highlighted area's 
 labels will be cleared and not those between the In/Out points.
@@ -346,12 +347,12 @@ To enable auto-color go to \texttt{Settings $\rightarrow$ Preferences, Appearanc
 as shown in Figure~\ref{fig:settings}.  It is disabled by default.  
 Each media will have a random muted color and there could easily be close duplicates as generated by the program algorithm.  There will be no total black, but some dark shades are possible.  
 
-To change a specific clip to your own chosen color, middle mouse button (MMB) over that clip and an Edits popup will be displayed.  
+To change a specific clip to your own chosen color, right mouse button (RMB) over that clip and an Edits popup will be displayed.  
 Choose the option \textit{Bar Color} to bring up the color picker and choose a color.   
 You can also change the alpha value in the color picker and this alpha takes precedence over the current alpha slider bar value unless the color picker's alpha value is set to 1.0.   
 The color will only change after you click on the checkmark.  
 The \emph{Bar Color} option works in either Drag and Drop or Cut and Paste editing mode and also works if \textit{Autocolor assets} is not set.  
-In Drag and Drop editing mode, if you select several clips and then bring up the Edits popup with the middle mouse button over a track, you can use the \emph{Bar Color} option to change all of those selected to the same color.
+In Drag and Drop editing mode, if you select several clips and then bring up the Edits popup with the right mouse button over a track, you can use the \emph{Bar Color} option to change all of those selected to the same color.
 
 To go back to the default colors, uncheck \textit{Autocolor assets} in Preferences, but this does not affect the specially chosen self-colored ones as they are preserved.  
 To change these individually or  selectively, use the Edits popup \emph{Bar Color} option and click on \textit{Default} in the color picker window.  Auto-color does not honor armed/disarmed tracks.  
@@ -416,7 +417,7 @@ If you like to use different window layouts than the default for certain scenari
 First, position your \CGG{} windows where you want them to be and then use the Window pulldown and choose \emph{Save layout}. Note the words \emph{Save layout} highlighted in Figure~\ref{fig:window_layouts}a with 4 names shown to the right and below of that highlight. 
 To use the default name of \textit{Layout \#}, when the popup comes up, just click the green checkmark OK on the Layout popup menu.  
 If you would like a specific name for your layout so you can remember what its best use case is,
-keyin 1-8 english characters that are meaningful to you (english characters mean you can not use the German umlaut or the French accent).  
+keyin 1-8 english characters that are meaningful to you (english characters mean you can not use the German umlaut, the French accent, or the Spanish ñ). 
 Legal characters are a-z, A-Z, 0-9, \_ (the underscore character) and a limit of 8 total.  
 If you keyin more than 8, only the last 8 characters will be used.  
 To rename a currently existing layout, use the \emph{Save layout} option again on the one to rename, and keyin a different name into the text box or leave blank for the default name (figure~\ref{fig:window_layouts}b).
@@ -452,7 +453,7 @@ Other ways to \textit{play around} are described next.
 \subsubsection*{Repeat Play / Looping Method}%
 \label{ssub:repeat_play_looping_method}
 
-There are 2 methods for repeat play or looping on the timeline and 1 method for both the Compositor and the Viewer.  This works in conjunction with any of the transport buttons or shortcuts in either forward or reverse as usual.  The 1 exception is that the Shift button can not be used to either add or subtract audio within the repeat area.
+There are 2 methods for repeat play or looping on the timeline and 1 method for both the Compositor and the Viewer.  This works in conjunction with any of the transport buttons or shortcuts in either forward or reverse as usual.  The 1 exception is that the Shift key can not be used to either add or subtract audio within the repeat area.
 
 \textit{Method 1:} Shift-L on the Timeline, repeats the selection per the algorithm outlined next.
   
@@ -539,7 +540,7 @@ For the keyboards without a numeric keypad or if you prefer to use keys closer t
 + Shift key, results in the reverse of whether audio is included or not.
 \vspace{1ex}
 
-+ Ctrl, results in the transport function operating only between the in/out pointers.
++ Shift + Ctrl, results in the transport function operating only between the in/out pointers.
 \end{minipage}
 
 \section{Compositor Window}%
@@ -570,7 +571,8 @@ On the bottom of the window, there are many
 of the same transport buttons and controls that are available in the Program window.
 They work the same as in the Program window and also have tooltips that are visible 
 when you mouse over each of the icons so their use is fairly obvious.  However,
-of particular note is the button \textit{Click to play} which is described in~\ref{sub:click_to_play_in_viewer_and_compositor}.
+of particular note is the button \textit{Click to play} which is described in~\ref{sub:click_to_play_in_viewer_and_compositor}.  Next is the \textit{Videoscope} button which is used to enable the scopes window
+without having to apply the filter to the tracks/edits.
 
 Next to all of these controls all the way to the right side, there is a \textit{zoom menu} and a \textit{tally light}.  The \textit{zoom menu} has a pulldown with different settings that you can choose from
 or you can just use the tumbler arrows to the right. Generally when just getting started, you
@@ -657,13 +659,16 @@ In Figure~\ref{fig:safe_regions} you can see the Ruler menu on the right side of
 
 Holding down the Ctrl key while dragging with the LMB on one of the points, will
 ensure that the line is always at a multiple of a 45 degree angle.  Holding down the Alt key while
-dragging with the LMB on one of the points, will translate the ruler line to another place on 
-the video while maintaining its length and angle. If you dismiss the Ruler menu, click on
+dragging with the LMB on any of the points, will translate the ruler line to another place on 
+the video while maintaining its length and angle. For some desktop window managers, such as 
+\textit{UbuntuStudio 16.4} and \textit{Arch}, the Alt key is already in use by the Operating System
+so you will have to use Alt+Ctrl instead.
+If you dismiss the Ruler menu, click on
 \textit{Show tool info} to get the menu to popup again.  
     \item[Adjust camera automation]  the camera brings up the camera editing tool. Enable \textit{Show tool info} if the popup menu does not appear. More detail for usage is provided in the subsequent
-paragraph~\ref{sub:camera_and_projector}.
+section~\ref{sub:camera_and_projector}.
     \item[Adjust projector automation]  the projector brings up the projector editing tool. Enable \textit{Show tool info} to get the menu to popup again. More detail for usage is provided in the
-subsequent paragraph~\ref{sub:camera_and_projector}.
+subsequent section~\ref{sub:camera_and_projector}.
     \item[Crop a layer or output]  this is a cropping tool used to reduce the visible picture area.
 More detail for usage is provided in a 
 subsequent paragraph (\ref{sub:cropping}).  There is also a Crop \& Position plugin that provides
@@ -746,7 +751,7 @@ screens, zooms, and pans in the compositor.
 
 The \textit{Output size} can be set in \texttt{File $\rightarrow$ New} when creating a new project,
 or by using \texttt{Settings $\rightarrow$ Format}, or in the Resources window with RMB click on
-a video asset and choosing \emph{Match project size}. When you \emph{Match project size}, you
+a video asset and choosing \texttt{Match $\rightarrow$ Match project size}. When you \emph{Match project size}, you
 are conforming the output to the asset. Once you have set the output size in 1 of these 3 ways,
 any newly created tracks will conform to the specified output size.  When rendering, the project's
 output size is the final video track size where the temporary pipeline is rendered into.  
@@ -816,7 +821,7 @@ green and yellow colored outlines.
 placement.
 \end{enumerate}
 
-When you drag over the viewport in the compositor window, it looks like you are moving the camere
+When you drag over the viewport in the compositor window, it looks like you are moving the camera
 with the mouse.  The viewport moves in the same manner.
 
 \subsubsection*{Camera Compositing}%
@@ -845,7 +850,7 @@ By either tumbling or entering text directly, the camera and projector can be pr
 Justification types are also defined for easy access. 
 A popular justification operation is upper left projection after image reduction. 
 This is used when reducing the size of video with aspect ratio adjustment.  
-In the last figure you see the choices for justification as the red stripe in the 6 boxes in the order of left, center horizontal, right, top, center vertical, and bottom.
+In the last figure you see the choices for justification as the location of the line in the 6 boxes in the order of left, center horizontal, right, top, center vertical, and bottom.
 
 The translation effect allows simultaneous aspect ratio conversion and reduction but is easier to use if the reduced video is put in the upper left of the \textit{temporary} instead of in the center. 
 The track size is set to the original size of the video and the camera is centered. 
@@ -870,9 +875,9 @@ In the compositing window, there is a popup menu of options for the camera and p
 \label{ssub:use_case_interaction_camera_projector}
 
 \begin{enumerate}
-    \item Start by shrinking the projector to $z=0,500$ ($\frac{1}{4}$ of the original frame).
-    \item The next step is to switch to the camera and note that the green box has assumed the size of the projector, i.e.\ the red box. The value of $z$ of the camera is always equal to $1,000$ (default) but the frame is $\frac{1}{4}$ of the original frame, i.e.\ it has the size of the projector that has $z=0,500$. This is the current viewport size.
-    \item You enlarge the room bringing $z=2,000$. You can see that the dimensions of the viewport (green box) do not change, remaining the same as those of the projector. However, the frame has been enlarged and this variation is indicated by the enlargement of the yellow box. Let's remember that this follows the changes made with the camera tool.
+    \item Start by shrinking the projector to $z=0.500$ ($\frac{1}{4}$ of the original frame).
+    \item The next step is to switch to the camera and note that the green box has assumed the size of the projector, i.e.\ the red box. The value of $z$ of the camera is always equal to $1.000$ (default) but the frame is $\frac{1}{4}$ of the original frame, i.e.\ it has the size of the projector that has $z=0.500$. This is the current viewport size.
+    \item You enlarge the room bringing $z=2.000$. You can see that the dimensions of the viewport (green box) do not change, remaining the same as those of the projector. However, the frame has been enlarged and this variation is indicated by the enlargement of the yellow box. Let's remember that this follows the changes made with the camera tool.
     \item We can drag the room so that we can center the frame to our liking. The movement of the yellow box shows well the variation compared to the green box.
     \item Finally, if we want, we can switch to the projector tool to move the output frame to the position we want with respect to the size of the source. Of course, we can also work on the $z$, which in the example is at $z=0.500$, if we have decided to change the size of the output.
 \end{enumerate}
@@ -922,10 +927,12 @@ that you are viewing in the compositor.  An easy way to see the masked area is t
 below the target track and drag the \textit{Gradient} plugin to a highlighted area on that track.
      \item  You can move existing points to new locations by simply using the LMB at a point to
 drag that point to a different location.
-    \item  The mask can be translated as a single entity by Alt-dragging the mask.
+    \item  The mask can be translated as a single entity by Alt-dragging the mask.  For some desktop
+window managers, such as \textit{UbuntuStudio 16.4} and \textit{Arch}, the Alt key is already in use
+by the Operating System so you will have to use Alt+Ctrl instead.
     \item To create curved instead of straight lines between the points, use  Ctrl-drag on a
 specific point. Using Ctrl-drag activates bezier handles (control points) to create these curves
-between the points.       
+between the points. For example, on a mask with just two points, you can create a romantic heart mask.     
 \end{enumerate}
 
 There are a lot more operations you can do using the Mask menu as shown in 
@@ -969,7 +976,9 @@ When you click \textit{Load} preset, keep in mind that it will write the mask nu
 
 \textit{Center} mask button allows for quickly centering a mask on the video track. 
 \textit{Normalize} mask button makes it easy to normalize the size of the mask based on the scale of the video. 
-The next 3 symbols concern the direction to \textit{drag translate} a mask using the \texttt{Alt+LMB} thus making it easy to preserve the current $X$ or $Y$ value when desirable.
+The next 3 symbols concern the direction to \textit{drag translate} a mask using the \texttt{Alt+LMB} thus making it easy to preserve the current $X$ or $Y$ value when desirable.  For some desktop window managers,
+such as \textit{UbuntuStudio 16.4} and \textit{Arch}, the Alt key is already in use by the Operating System
+so you will have to use Alt+Ctrl instead.
 
 \texttt{xlate/scale x} - drag translate constrained in the $X$ direction
 
@@ -982,7 +991,7 @@ The next 3 symbols concern the direction to \textit{drag translate} a mask using
 
 The \texttt{Fade}: textbox is used to type in a fade value; the tumbler to the right of the textbox allows you to increase or decrease that number; and the slider bar makes it quick to adjust the fade value.  The fader goes from $-100$ on the left to $+100$ on the right for negative to positive.  Default value is $+100$. The fade slider includes a sticky point at 0 so that it is easy to get to 0 without going too far or not quite far enough -- that way you don’t have to keep jiggling to get there. 
 
-In addition there is a \textit{Gang fader} symbol to allow for having all of the masks fade in unison. The symbol is surrounded by a gold colored background when it is in effect.  If you have multiple masks with different modes, a decision had to be made on what value to use -- it uses the maximum transparency value of the background to determine the operations results.  To understand how this works, here is a summary:
+In addition there is a \textit{Gang fader} symbol to allow for having all of the masks fade in unison. The symbol is surrounded by a green colored background (in the default theme) when it is in effect.  If you have multiple masks with different modes, a decision had to be made on what value to use -- it uses the maximum transparency value of the background to determine the operations results.  To understand how this works, here is a summary:
 
 Note1: The area outside the mask is referred to as the background.
 
@@ -1165,7 +1174,7 @@ the timebar above the transport buttons.
 \begin{figure}[htpb]
     \centering
     \includegraphics[width=0.99\linewidth]{viewer_window.png}
-    \caption{Viewer Window - note the green/white arrow "Play" button left of 001484}
+    \caption{Viewer Window - the red arrow "Play" button is left of the Videoscope button}
     \label{fig:viewer_window}
 \end{figure}
 
@@ -1181,9 +1190,10 @@ In order to view media in the window, you have to load it as follows:
 
 Note that you can have multiple Viewer windows open with different or even the same media asset.
 After the media is loaded you can use the transport buttons to play, rewind, stop, and so on, or
-for fast previewing drag with the LMB anywhere on the timebar slider.  A few more options
-available in the Viewer window can be accessed with a RMB click on the display.  These functions
-are listed next.
+for fast previewing drag with the LMB anywhere on the timebar slider.  There is also the Videoscope
+button which is to used to enable the scopes window without having to apply the filter to the tracks/edits.
+A few more options available in the Viewer window can be accessed with a RMB click on the display.
+These functions are listed next.
 
 \begin{enumerate}
     \item  Switch to a fullscreen display by choosing \textit{Fullscreen}.  To switch back, click
@@ -1265,7 +1275,7 @@ There are either a left or right resize pointer and you can click and drag in ei
 \begin{figure}[htpb]
     \centering
     \includegraphics[width=1.0\linewidth]{timebar2.png}
-    \caption{A left-facing arrow on the right side of the blue slider bar is used to drag the bar.}
+    \caption{A left-facing arrow on the right side of the reddish slider bar is used to drag the bar.}
     \label{fig:timebar2}
 \end{figure}