minor changes based on MatN reviews
[goodguy/cin-manual-latex.git] / parts / Windows.tex
index c217495211d96d6a98635ea7c8cb8224dd7a3845..55f996b5cf388d88c6224d75fc228e68e7038bef 100644 (file)
@@ -18,7 +18,7 @@ and pointers to the media so that the media is not modified. The EDL is describe
 
 The main window is called the \textit{Program} window and is often just referred to as the \textit{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 File pulldown, Save command.
+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. The patchbay contains options that affect each track.  
 These options are described in great detail in \nameref{sec:patchbay}.
 
@@ -138,8 +138,12 @@ The Track Menu contains a number of options:
 
 \begin{description}
     \item[Attach Effect] opens a dialog box of effects applicable to the type of track of audio or video.
-    \item[Move 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.
-    \item[Move down]  moves the tracks one step down in the stack with the
+    \item[Move up] allows for changing the order of the tracks up; the actual code refers
+to this as a swap. Disarmed tracks affect the results.
+    \item[Move down]  allow for changing the order of the tracks down; the actual code refers
+to this as a swap.  Disarmed tracks affect the results.
+    \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.
+    \item[Roll down]  moves the tracks one step down in the stack with the
 bottom track going to the top.  This is applicable to all armed and disarmed tracks.
     \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.
@@ -152,8 +156,6 @@ bottom track going to the top.  This is applicable to all armed and disarmed tra
         media. In Drag and Drop editing mode, if you select multiple edits all of those clips will have
 their title name changed.
     \item[Bar color]  allows the user to select a specific color for the title bar.  This helps to more easily locate a piece of media.
-    \item[Swap up] allows for changing the order of the tracks up. Disarmed tracks affect the results.
-    \item[Swap down]  allow for changing the order of the tracks down.  Disarmed tracks affect the results.
     \item[Resize Track]  resizes the track; this is only applicable to video tracks.
     \item[Match Output Size]  resizes the track to match the current output size; this is only applicable to video tracks.
 \end{description}
@@ -334,14 +336,14 @@ function to delete them all. The same precedence rules apply to this operation a
 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.
 
-If you enable \emph{Edit labels} in the Settings pulldown menu or disable the \emph{Lock labels from moving}
+If you enable \emph{Edit labels} in the \textit{Settings} pulldown menu or disable the \emph{Lock labels from moving}
 button on the Transport and Buttons bar, labels will be cut, copied or pasted along with the selected
 area of the first armed track. 
 In the same manner, if a selected area of media is spliced from the viewer to the timeline in a position 
 before labels, the labels will be moved to the right on the timebar so that the label maintains its 
 relative position to its edit. 
 To prevent labels from moving on the timebar, enable the \emph{Lock labels from moving} icon or
-disable the \emph{Edit labels} option under the Settings pulldown.
+disable the \emph{Edit labels} option under the \textit{Settings} pulldown.
 
 \subsection{Color Title Bars and Assets}%
 \label{sub:color_title_bars_and_assets}
@@ -426,7 +428,7 @@ Proxy and Transcode (\ref{sec:proxy_settings}), as well as the others.
 \label{sub:window_layouts}
 
 If you like to use different window layouts than the default for certain scenarios, you can setup, save, and load 4 variations.   
-First, position your \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. 
+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. 
 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, the French accent, or the Spanish ñ). 
@@ -451,7 +453,7 @@ To rename a currently existing layout, use the \emph{Save layout} option again o
 
 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}.
 
-To use the desired layout, keyin the shortcut or use the Window pulldown and choose \emph{Load layout} and then make your choice. It is very beneficial to 
+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 
 learn the the associated shortcut layouts (Ctrl+Shift+Fx where x is 1,2,3, or 4)
 because they can be executed from any of the 4 windows instead of just the main
 timeline window.
@@ -459,7 +461,7 @@ timeline window.
 \subsection{Multi-Pane Support}%
 \label{sub:multipane_support}
 
-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 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.
+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.
 
 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}).
 
@@ -609,13 +611,19 @@ will be using the default \textit{Auto} option.  The window size is not changed,
 the size of the video itself. In addition there are many shortcuts for zooming that you
 will find in the Shortcuts chapter (\ref{cha:shortcuts}).
 
-To resize the entire window instead of just the video, use a RMB click in the compositor
-window which brings up a menu with all the zoom levels, zoom auto mode, and some other options. 
+Using a RMB click in the compositor window brings up a menu with several options.  One of these
+is \emph{Resize Window} which allows for resizing the entire window instead of just the video
+and if you highlight that, you can choose from several variations for the window size. 
+Other available options include self-explanatory ones of \emph{Fullscreen} with "f" as a toggle
+to go to fullscreen and to revert to non-fullscreen and \emph{Zoom Auto}. 
 As you would expect, whenever the video is zoomed so that only part of the image is visible
 in the window, scrollbars are automatically added as needed on the bottom, the right hand 
 side, or both.
 Other options include \emph{Reset camera} and \emph{Reset projector} which obviously are used
-to reset the camera and the projector. 
+to reset the camera and the projector (reference~\ref{sub:camera_and_projector}).  And
+\emph{Camera/Projector keyframe} will create a keyframe at that point on the timeline for
+X,Y, and Z without the requirement of being in \textit{Automatic Keyframe Mode}.  More 
+information is described in the section \nameref{sec:compositor_keyframes}.
 The \emph{Hide controls/Show controls} option is great for hiding the left hand toolbar and
 bottom set of controls for a cleaner look. 
 
@@ -657,12 +665,12 @@ Once you have set the zoom to the desired size, use the vertical and horizontal
 As mentioned earlier, this
 variety of zoom only affects the video and not the resizing of the Compositor window.  After
 utilizing this slider bar for zooming around, you may want to switch back to \textit{Auto} 
-using the Controls on the bottom of the window.
+using the controls on the bottom of the window.
 This slider bar is also displayed
 when you click on the icons for \textit{Adjust camera automation} or \textit{Adjust projector automation}.  
 
 The Compositor window image in figure~\ref{fig:zoom_slider} shows the zoom slider bar with rectangular shaped slider about in the middle.  Note that the magnifying glass is enabled which
-automatically pops-up the slider and the Protect video from changes is disabled.  Also note that
+automatically pops-up the slider and the \textit{Protect video from changes} is disabled.  Also note that
 there is a scroll bar on the bottom and right side of the image since the image at this magnification
 does not fit in the window.
 The Controls zoom textbox shows $\times0.82$ size.  
@@ -701,17 +709,22 @@ subsequent section~\ref{sub:camera_and_projector}.
     \item[Crop a layer or output]  this is a cropping tool used to reduce the visible picture area.
 More detail for usage is provided in a 
 subsequent paragraph (\ref{sub:cropping}).  There is also a Crop \& Position plugin that provides
-a different set of capabilities~\ref{sub:crop_position}.
+a different set of capabilities described in~\ref{sub:crop_position}.
+    Enable \textit{Show tool info} to get the menu to popup if it does not come
+up automatically.
     \item[Get color / eyedropper]  brings up the eyedropper used to detect the color at a
 particular spot.  Enable the \textit{Show tool info} if the Color popup menu does not come up 
 automatically or if that menu was accidentally dismissed.  Click on a specific color in the video
 output with the LMB to see the selected color. You can then use that color's 
-value to be applied to some effects depending on how the effect handles the eyedropper.
+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
+around the cross cursor and an average value of the color will be the result.
+If you \textit{Use maximum}, instead of an average value of the color, the result
+will be the maximum of all values within that square.
     \item[Show tool info]  this tool button is used in conjunction with the other tools on the
 compositor's toolbar. You only need to click on this if one of these tools popup menu does not
 come up or has been dismissed - Mask, Ruler, Camera, Projector, Crop, or Eyedropper tools.
 You can also use it when highlighted to dismiss the highlighted tool's dialog box.
-It is not needed for Protect video from changes, Zoom view, and Show safe regions since they have
+It is not needed for \textit{Protect video from changes}, \textit{Zoom view}, and \textit{Show safe regions} since they have
 no dialog popup menus.
 
 \begin{figure}[htpb]
@@ -773,7 +786,7 @@ cropped.
 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).
 You can see or set the track size by RMB click on a track and then select \emph{Resize Track} to resize
 the track to any size. Or select \emph{Match output size} to make the track the same size as the
-output. Or from the Resources window, RMB on a video media and choose \textit{Info} and then \textit{Resize}. When a track is resized what it looks like on the compositor changes.  The relationship
+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
 between the track and the project's output size makes it possible to magnify or reduce the size of
 a track in regards to the final output. This feature means you can create visual effects such as different aspect ratios, adjust split screens, zooms, and pans in the compositor.
 
@@ -893,19 +906,16 @@ The camera and projector have shortcut operations that do not appear in the popu
 These are accessed in the \emph{Show tool info} window.
 Most operations in the Compositor window have a tool window which is enabled by activating the question mark icon (figure~\ref{fig:camera_tool}).
 
-\begin{wrapfigure}[10]{O}{0.45\linewidth} 
-       %\vspace{1ex}
-    \includegraphics[width=1.0\linewidth]{camera_tool.png}
-    \caption{Camera and Projector tool}
-    \label{fig:camera_tool}
-\end{wrapfigure}
+\begin{figure}[htpb]
+       \centering
+       \includegraphics[width=0.8\linewidth]{camera_tool.png}
+       \caption{Camera and Projector tool}
+       \label{fig:camera_tool}
+\end{figure}
+
+In the \textit{Position} section you can act on the $X$, $Y$ and $Z$ coordinates. By either tumbling or entering text directly or by using the slider, the camera and projector can be precisely positioned. There is also a reference to the color of the curve as we see it on the timeline. You can also define the \textit{range} of action which by default is [-100 to 100]. By pressing the Reset button for each coordinate, or the global Reset button, the range is automatically brought to the project size value (HD; 4k; etc), which are usually the most useful limits. Note that the range can also be changed in the \textit{Program} window, in the \textit{zoom bar}, where there are similar input fields to enter the chosen limits.
 
-In the case of the camera and projector, the tool window shows $x$, $y$, and $z$ coordinates. 
-By either tumbling or entering text directly, the camera and projector can be precisely positioned.  
-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 location of the line in the 6 boxes in the order of left, center horizontal, right, top, center vertical, and bottom.
+In the \textit{Justify} section we can use automatic positioning in the 6 standard coordinates: Left, Horizontal, Right, Top, Center 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. 
@@ -913,21 +923,21 @@ The output size is set to the reduced size of the video.
 Without any effects, this produces just the cropped center portion of the video in the output.
 
 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. 
-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. 
-Instead, we leave out $x$ and out $y$ at 0 and use the projector's tool window. 
+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. 
+Instead, we leave out $X$ and out $Y$ at 0 and use the projector's tool window. 
 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.
 
-Other buttons cover the 5 modes of curves interpolation: smooth, linear, tangent, free, bump.
+In the \textit{Curve type} section we can choose between various interpolation algorithms that determine the curve type:
 
 \begin{description}
        \item[smooth:] bezier interpolation which are flat at the endpts
        \item[linear:] piecewise linear curve.
        \item[tangent:] bezier interpolation with collinear endpts in a specified line.
-       \item[disjoint:] piecewise bezier, if there is such a thing.
+       \item[free:] piecewise bezier, if there is such a thing.
        \item[bump:] has 2 values, one viewed from the left/right, discontinuous.
 \end{description}
 
-Finally there are the 2 buttons for the bump curves: settings on Right/Left Edges and Span (see \nameref{sec:bump_autos}).
+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}.
 
 \subsubsection*{Reset to Default}%
 \label{ssub:reset_default}
@@ -1036,13 +1046,15 @@ The \textit{Enable} row of masks makes it so you can enable all or none of the m
 
 There are 4 shapes that are automatically available for usage as masks – square, circle, triangle, and oval.  In addition, the next 3 symbols in this section are for the purpose of loading, saving, and deleting your own customized shapes.  The first symbol, \textit{Load} preset, will bring up a list of your previously saved presets.  Clicking on \textit{Save} preset brings up a popup window allowing you to provide a name used to identify the preset you want to save, along with a pulldown to see the names of your other saved presets.   Clicking on \textit{Delete} preset also brings up a textbox with a pulldown to choose which one to delete.  There is a file, called \texttt{mask\_rc}, in \texttt{\$HOME/.bcast5} that records your custom masks.  
 
-When you click \textit{Load} preset, keep in mind that it will write the mask number that you have selected so if you already have a mask at that location, it will write over it – just \textit{Undo mask} under the main window Edit pulldown (shortcut `z') to revert to the previous if you made this mistake.
+When you click \textit{Load} preset, keep in mind that it will write the mask number that you have selected so if you already have a mask at that location, it will write over it – just \textit{Undo mask} under the main window \textit{Edit} pulldown (shortcut `z'or `Ctrl-z') to revert to the previous if you made this mistake.
 
 \subsubsection*{Position \& Scale section}%
 \label{ssub:position_scale_section}
 
 \textit{Center} mask button allows for quickly centering a mask on the video track. 
-\textit{Normalize} mask button makes it easy to normalize the size of the mask based on the scale of the video. 
+\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 
+directions.  Normalization makes the mask fit in the space to avoid having
+it wander off of the window, then you can move it around easily before resizing.
 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.
@@ -1070,7 +1082,7 @@ background colors are at a transparency value of zero. So the largest transparen
 \paragraph{Case 2, Negative Fade:} When the program computes the background color for any number of masks that includes negative
 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.
 
-\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 gold colored background when it is in effect.
+\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.
 
 \subsubsection*{Mask Points section}%
 \label{ssub:masks_points_section}
@@ -1085,12 +1097,13 @@ The next 6 symbols in 2 columns represent \textit{Smooth} and \textit{Linear} bu
 
 \textit{smooth curve}  $\rightarrow$ smooth all points on a mask edge curve.
 
-\textit{smooth all}    $\rightarrow$ smooth all active masks.
+\textit{smooth all}    $\rightarrow$ smooth all enabled masks on this track.
 
 Linear buttons of \textit{linear point}, \textit{linear curve}, and \textit{linear all}, perform the inverse of the smooth functions.
 The control point vectors on the bezier endpoints are set to zero magnitude.
 
-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; for example you can then see mask 0, mask 1 \dots at the same time.
+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
+even if they are not enabled; for example you can then see mask 0, mask 1 \dots at the same time.
 
 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.
 
@@ -1099,7 +1112,7 @@ A \textit{gang} symbol on the right hand side of this section, tooltip of \texti
 
 The \textit{X:} and \textit{Y:} coordinates mark the value of the current \textit{Pivot Point} used for rotation, scaling, and translation.  You can either directly key in numerical values or use the tumblers to change the values as long as the \textit{Focus} checkbox is checked.
 
-The \textit{Focus} checkbox is used in case you want to set a different point in the Compositor for pivoting instead.  And the \textit{Gang} symbol for rotate/scale/translate means that these operations will be performed on all points of the enabled masks.  The gang symbol is surrounded by a gold colored background when it is in effect.  When performing a rotate operation on a mask with the mouse wheel, \textit{acceleration} is in effect -- this means the faster you wheel, the more space is covered so that you do not have to wheel dozens of time to make a full rotation.  Then when you wheel around slower, you can fine tune the result.
+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.
 Note that in order to be able to rotate/scale around pointer, the Focus checkbox must be unchecked.
 
 \subsubsection*{Other sections}%
@@ -1188,7 +1201,7 @@ the actual cropping take affect.
 There are 3 choices of crop methods to choose in the menu pulldown on the bottom right side.
 \begin{enumerate}
      \item Reformat - Reformat Session crops and changes the Format for the entire session. 
-Because the Format is changed, this is applied to all tracks in the project.
+Because the Format is changed, this is applied to all tracks in the project. 
 The part of the image outside the rectangle will be cut off and the projector will make the video fit.
 The  \texttt{Settings $\rightarrow$ Format} window will show the new project Width and Height values and
 the projector tool window will show the new $X, Y$ values. Track size remains unchanged.
@@ -1324,36 +1337,31 @@ at least temporarily, is so that you can quickly review your video before a rend
 \subsection{Timebar + Preview Region Usage in the Compositor and Viewer}%
 \label{sub:timebar_preview_region_usage_in_the_compositor_and_viewer}
 
-The Viewer and Compositor each have a timebar control area with an indicator line below the video
-output. The \textit{timebar} shows the whole time covered by the program. When a video asset
-is loaded in the main window and you move in the compositor, the insertion pointer in the main
-window will reflect those movements.  However, this is not the case with the viewer.  In the viewer
-only that specific media is shown and there is no corresponding movement on the timeline.
-
-Both the Compositor and Viewer support labels and in/out pointer which are displayed in the timebar.
-And as with the movements, when you use the labels or in/out pointer in the compositor timebar,
-the result will also be reflected in the main window timebar.  Along with that, of course, when
-you move to a label or in/out pointer in the compositor, the insertion point in the program window
-will go to that position.
-
-The timebar in the compositor and the viewer can be used to define a region known as the \textit{preview region}.  
-This preview region is the region of the timeline which the slider affects.  
-By using a preview region inside the entire program and using the slider inside the preview region you can very precisely and relatively quickly seek in the compositor and viewer.  
-The preview region can be especially handy when you have large pieces of media by previewing one section, then move to the next section.  
-
-The active preview region is the zone between the edge bars.  
-The full range of the window slider pointer action is down-scaled to the active preview region.   
-To use this, set the preview active region as a media time region of interest.  
-Now addressing the timebar with the mouse only operates as if the timebar is zoomed to the scale of the active preview zone.  
-This has the effect of magnifying the interesting media in terms of the mouse pointer addressing, for fine-tuning.
+The Viewer and Compositor each have a timebar control area with a red indicator
+line below the video output. The timebar shows the whole time covered by the
+resource. When a video resource is loaded in the main window and you move in the
+compositor, the insertion pointer in the main window will reflect those movements.
+But in the viewer only that specific media is shown and there is no corresponding movement on the timeline.
 
 \begin{figure}[htpb]
-    \centering
-    \includegraphics[width=1.0\linewidth]{timebar1.png}
-    \caption{The arrow above the green colored “play forward” transport button is on the timebar.}
-    \label{fig:timebar1}
+       \centering
+       \includegraphics[width=1.0\linewidth]{timebar1.png}
+       \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".}
+       \label{fig:timebar1}
 \end{figure}
 
+Both the Compositor and Viewer support labels and in/out pointer which are dis-
+played in the timebar. And as with the movements, when you use the labels or
+in/out pointer in the compositor timebar, the result will also be reflected in the
+main window timebar. Along with that, of course, when you move to a label or
+in/out pointer in the compositor, the insertion point in the program window will
+go to that position.
+
+The timebar in the compositor and the viewer covers the whole length of the resource
+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.
+
+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.
+
 To create and use a preview region, hold down the right mouse button inside the timebar on either end of the timebar close to the edge until you see the resize pointer.  
 While continuously holding the right mouse button down, drag the arrow away from the end towards the middle of the timebar until you have the desired area outlined.  
 The slider will be a dark red color while the selected preview region will remain the same initial black color.  
@@ -1369,8 +1377,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]{timebar3.png}
-    \caption{Here you can see the right-facing arrow used to drag the other end of the slider bar.  
-        The black area between is the actual preview area.}
+    \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.}
     \label{fig:timebar3}
 \end{figure}
 
@@ -1378,25 +1385,19 @@ You can slide the preview zone left or right by holding the right mouse button o
 The selected area will move left or right as you drag and still retains the same size.
 
 \begin{figure}[htpb]
-    \centering
-    \includegraphics[width=1.0\linewidth]{timebar4.png}
-    \caption{Note the double-headed fat arrow in the preview area used  to move the selection over.}
-    \label{fig:timebar4}
+       \centering
+       \includegraphics[width=1.0\linewidth]{timebar4.png}
+       \caption{Note the double-headed fat arrow in the black preview area used to move the selection over.}
+       \label{fig:timebar4}
 \end{figure}
 
 Settings:
 
 \begin{enumerate}
-    \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 blue slider
-        suddenly mysteriously appear.
-    \item  If the preview region is set, when you replace the current project or file,  the preview region is
-        automatically disabled.
-    \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.  
-    \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.
+    \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.
+    \item  If the preview region is set, when you replace the current project or file,  the preview region is automatically disabled.
+    \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.  
+    \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.
 \end{enumerate}
 
 A good method for taking advantage of the preview region is described here.  
@@ -1406,7 +1407,7 @@ Now in the compositor window, right mouse drag from the left side of the edge of
 Back in the main track canvas, move to the location of the area you want to end looking and again you will see the red indicator line in the compositor.  
 Use the right mouse drag from the right to stop at that end point.  Using this method is often easier than continuous usage of the single frame move which can be tedious.
 
-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 monitor space.
+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.
 
 \section{Resources Window}%
 \label{sec:resources_window}
@@ -1516,7 +1517,7 @@ Below are steps illustrating an easy way to set up a folder.
                 \centering
                 \includegraphics[width=0.9\linewidth]{folder_resources.png}
                 \caption{Highlight, then click “New Media or Clips”.
-                    “Modify folder” can be used to   change the name of a folder.
+                    “Modify folder” can be used to change the name of a folder.
                     “Delete folder” in the popup can be used to delete a folder.
                 }
                 \label{fig:folder_resources}
@@ -2000,7 +2001,7 @@ This could affect performance on slower systems
 \label{sub:show_overlays}
 
 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.  
-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 View pulldown menu.  
+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.  
 The \textit{Color Coded Keyframe Curves} have distinct colors associated with each type for ease of identification.  
 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.  
 The color ball changes made will be retained across sessions.
@@ -2030,7 +2031,7 @@ The slider is in the same color as the color coded keyframe type line which is t
 
 Overlays Window Nuances:
 
-The Overlays window is an alternative to the main track canvas View pulldown, and thus the order is mostly maintained to match each other.  
+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.  
 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.  
 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.
 
@@ -2066,7 +2067,7 @@ Here is a list of how they work.  Keep in mind that if the Expander on the patch
 
 \begin{itemize}
     \item  Shift+LMB on a non-\textit{hot} spot will simply check or uncheck a box and there is no previous state.
-    \item This all works in conjunction with the View pulldown menu which, of course, has no hot spots.
+    \item This all works in conjunction with the \textit{View} pulldown menu which, of course, has no hot spots.
     \item  Caveat \#1 - Shift+LMB on the top 4 choices of Assets, Titles, Transitions, Plugin Keyframes will turn
         off all of the checkboxes below because it makes sense to do so.
     \item  Caveat \#2 - Shift+LMB on the Autos will not turn off Assets, Titles, Transitions, or Plugin Keyframes
@@ -2080,7 +2081,7 @@ Here is a list of how they work.  Keep in mind that if the Expander on the patch
 \subsection{Sound Level Meters Window}%
 \label{sub:sound_level_meters_window}
 
-An additional window, the levels window, can be brought up from the Window pulldown.  
+An additional window, the levels window, can be brought up from the \textit{Window} pulldown.  
 The levels window displays the output audio levels after all mixing is done.  
 The visible range of the sound level meters is configurable in \texttt{Settings $\rightarrow$ Preferences, Interface tab} under the Operations section.