minor corrections from Andrea, + other improvements

diff --git a/images/cropped_area.png b/images/cropped_area.png
index 35d874061053df3201abf084371ba24378ed55b4..36f60301f3b21c9e757f64327d2d4095626ef41e 100644 (file)
Binary files a/images/cropped_area.png and b/images/cropped_area.png differ

diff --git a/parts/Plugins.tex b/parts/Plugins.tex
index a084c3231467883f694909c3299066b67ec450f1..fe52bfa11cc3bbf9760ae8e7cb4760a437cebd96 100644 (file)
--- a/parts/Plugins.tex
+++ b/parts/Plugins.tex
@@ -71,7 +71,7 @@ When enabled, which is the default, and you edit tracks, the effects follow the
 
 \begin{figure}[htpb]
     \centering
 
 \begin{figure}[htpb]
     \centering

-    \includegraphics[width=0.8\linewidth]{images/editing-effects.png}
+    \includegraphics[width=0.9\linewidth]{images/editing-effects.png}

     \caption{Screencast of the native Video plugins in the default Cinfinity icon set.}
     \label{fig:editing-effects}
 \end{figure}
     \caption{Screencast of the native Video plugins in the default Cinfinity icon set.}
     \label{fig:editing-effects}
 \end{figure}


@@ -749,8 +749,8 @@ Below is a screencast showing the auto start gui flag and the \texttt{LV2\_PATH}
 
 \begin{figure}[htpb]
     \centering
 
 \begin{figure}[htpb]
     \centering

-    \includegraphics[width=0.8\linewidth]{images/reload.png}
-    \caption{\textit{Reload plugin index} in yellow and \textit{Auto start lv2 gui} unchecked}
+    \includegraphics[width=0.9\linewidth]{images/reload.png}
+    \caption{Reload plugin index in yellow and Auto start lv2 gui unchecked}

     \label{fig:reload}
 \end{figure}
 
     \label{fig:reload}
 \end{figure}
 


@@ -760,7 +760,7 @@ Note the UI button in the upper right hand corner above the Reset button (figure
 
 \begin{figure}[htpb]
     \centering
 
 \begin{figure}[htpb]
     \centering

-    \includegraphics[width=0.9\linewidth]{images/calf.png}
+    \includegraphics[width=1.0\linewidth]{images/calf.png}

     \caption{Screencast of simple text interface in the middle of the screen for a Calf LV2 plugin}
     \label{fig:calf}
 \end{figure}
     \caption{Screencast of simple text interface in the middle of the screen for a Calf LV2 plugin}
     \label{fig:calf}
 \end{figure}


@@ -1245,7 +1245,7 @@ The Chroma Interpolation Key plugin, CriKey, is a regionally based chroma key wi
 
 \begin{figure}[htpb]
     \centering
 
 \begin{figure}[htpb]
     \centering

-    \includegraphics[width=0.6\linewidth]{images/crikey.png}
+    \includegraphics[width=0.5\linewidth]{images/crikey.png}

     \caption{three active point created in CriKey}
     \label{fig:crikey}
 \end{figure}
     \caption{three active point created in CriKey}
     \label{fig:crikey}
 \end{figure}


@@ -2625,7 +2625,7 @@ The Text Color window has several enhanced features as listed here and seen in f
 
 \begin{figure}[hbtp]
     \centering
 
 \begin{figure}[hbtp]
     \centering

-    \includegraphics[width=0.5\linewidth]{images/title04.png}
+    \includegraphics[width=0.6\linewidth]{images/title04.png}

     \caption{Screencast showing the Color Picker menu.}
     \label{fig:title04}
 \end{figure}
     \caption{Screencast showing the Color Picker menu.}
     \label{fig:title04}
 \end{figure}


@@ -2893,6 +2893,43 @@ Figure~\ref{fig:zoom} shows the parameters: Radius=21 and Steps=3.
     \label{fig:zoom}
 \end{figure}
 
     \label{fig:zoom}
 \end{figure}
 

+\section{CUDA plugins}%
+\label{sec:cuda_plugins}
+\settocdepth{section}
+
+Only for Nvidia GPU and Cuda SDK
+
+\subsection{Mandelbrot}%
+\label{sub:mandelbrot}
+
+Produce fractal figures (figure~\ref{fig:mandelbrot}). Use case:
+\begin{enumerate}
+       \item add the Mandelbrot Cuda video effect to the timeline
+       \item you must enable Drag in the plugin popup menu
+       \item drag the mouse with the RMB down and you will see the fractal change
+       \item enable "Generate keyframes while tweaking" and move to another spot on the timeline and RMB drag again
+       \item so now when you play the video from the beginning because you have keyframes, the fractal will be animated between keyframes.
+\end{enumerate}
+
+\begin{figure}[hbtp]
+       \centering
+       \includegraphics[width=0.9\linewidth]{images/mandelbrot.png}
+       \caption{Mandelbrot Cuda plugin}
+       \label{fig:mandelbrot}
+\end{figure}
+
+\subsection{N\_Body}%
+\label{sub:n_body}
+
+Produce animated particles (figure~\ref{fig:n_body}).
+
+\begin{figure}[hbtp]
+       \centering
+       \includegraphics[width=1.0\linewidth]{images/n_body.png}
+       \caption{N\_Body Cuda plugin}
+       \label{fig:n_body}
+\end{figure}
+

 \section{OpenCV plugins}%
 \label{sec:opencv_plugins}
 \settocdepth{section}
 \section{OpenCV plugins}%
 \label{sec:opencv_plugins}
 \settocdepth{section}

diff --git a/parts/Rendering.tex b/parts/Rendering.tex
index 3b6e3b4839b6efe86c846f5f383bb07259bacdde..105a8633f50fc47a177361b746996b0ec36d9fc4 100644 (file)
--- a/parts/Rendering.tex
+++ b/parts/Rendering.tex
@@ -31,7 +31,7 @@ Use the File pulldown and select Render to start the render dialog (figure~\ref{
 \end{figure}
 
 \begin{description}
 \end{figure}
 
 \begin{description}

-    \item[Wrench:] select the \textit{wrench} next to each toggle to set compression parameters.  If the file format can not store audio or video the compression parameters will be blank.  If \textit{Render audio tracks} or \textit{Render video tracks} is selected and the file format does not support it, trying to render will result in an error message.
+    \item[Wrench:] select the \textit{wrench} next to each toggle to set compression parameters.  If the file format can not store audio or video the compression parameters will be blank.  If \textit{Render audio tracks} or \textit{Render video tracks} is selected and the file format does not support it, trying to render will result in an error message. More details in the section: \nameref{sub:extra_cin_option_ffmpeg}

     \item[Create new file at each label] the option causes a new file to be created when every label in the timeline is encountered – a separate file for each.  This is useful for dividing long audio recordings into individual tracks.  When using the Render Farm (described later), \textit{Create new file at each label} causes one render farm job to be created at every label instead of using the internal load balancing algorithm to space jobs.   If the filename given in the render dialog has a 2 digit number in it, the 2 digit number is overwritten with a different incremental number for every output file. If no 2 digit number is given, Cinelerra automatically concatenates a number to the end of the given filename for every output file.
     For example, in the filename \texttt{/movies/track01.wav} the $01$ would be overwritten for every output file. 
     The filename \texttt{/movies/track.wav}; however, eventually would become \texttt{/movies/track.wav001} and so on.  
     \item[Create new file at each label] the option causes a new file to be created when every label in the timeline is encountered – a separate file for each.  This is useful for dividing long audio recordings into individual tracks.  When using the Render Farm (described later), \textit{Create new file at each label} causes one render farm job to be created at every label instead of using the internal load balancing algorithm to space jobs.   If the filename given in the render dialog has a 2 digit number in it, the 2 digit number is overwritten with a different incremental number for every output file. If no 2 digit number is given, Cinelerra automatically concatenates a number to the end of the given filename for every output file.
     For example, in the filename \texttt{/movies/track01.wav} the $01$ would be overwritten for every output file. 
     The filename \texttt{/movies/track.wav}; however, eventually would become \texttt{/movies/track.wav001} and so on.  


@@ -513,7 +513,7 @@ To use x264 lossless rendering -- choose File format of ffmpeg, m2ts in the Rend
 \subsection{Extra “cin\_” Options for Render with FFmpeg}%
 \label{sub:extra_cin_option_ffmpeg}
 
 \subsection{Extra “cin\_” Options for Render with FFmpeg}%
 \label{sub:extra_cin_option_ffmpeg}
 

-There are several special parameters that can be used in the ffmpeg options file to pass values to the codecs that are not normally available.  These are explained below.
+There are several special parameters that can be used in the ffmpeg options file to pass values to the codecs that are not normally available.  They're called Global Options. These are explained below.

 
 \paragraph{cin\_pix\_fmt} The Render menus allows you to choose the codec input pixel format (figure~\ref{fig:yuv420}).  The Pixels selection provides the available pixel format options for the chosen codec type; valid choices vary for the different file types.  This list represents the formats that the codec advertises.  It is not always complete, and it may include options that are not legal with all parameter configurations.
 
 
 \paragraph{cin\_pix\_fmt} The Render menus allows you to choose the codec input pixel format (figure~\ref{fig:yuv420}).  The Pixels selection provides the available pixel format options for the chosen codec type; valid choices vary for the different file types.  This list represents the formats that the codec advertises.  It is not always complete, and it may include options that are not legal with all parameter configurations.
 


@@ -556,6 +556,8 @@ Example: \textit{cin\_sample\_fmt=s16}
     \label{fig:audio}
 \end{figure}
 
     \label{fig:audio}
 \end{figure}
 

+\paragraph{Private Options} (muxers). In the window of the \textit{wrench} in addition to the \textit{View} button, which allows more global options and changes to the formats, there is an additional \textit{Format} button that allows you to modify the Private Options, i.e. relating to specific muxing formats. More information on all these options can be found at: {\small \url{https://ffmpeg.org/ffmpeg-all.html#Format-Options}} sections 19 and 21.
+

 \subsection{Two-pass Encoding with FFmpeg}%
 \label{sub:two_pass_encoding_ffmpeg}
 
 \subsection{Two-pass Encoding with FFmpeg}%
 \label{sub:two_pass_encoding_ffmpeg}
 

diff --git a/parts/Shortcuts.tex b/parts/Shortcuts.tex
index 050ba12c9c3f2e02810066dda769993d0d5d0896..96af9bb4ef9ad9794af9c2a3d962243647da0292 100644 (file)
--- a/parts/Shortcuts.tex
+++ b/parts/Shortcuts.tex
@@ -91,7 +91,7 @@ The Main window (also called the program window) consists of pulldown menus, but
           \textcolor{blue}{Tracks} & Move tracks up & Shift-Up & Circulate tracks up \\             
              & Move trks down & Shift-Down & Circulate tracks down \\             
              & Delete tracks &  & Delete all tracks \\             
           \textcolor{blue}{Tracks} & Move tracks up & Shift-Up & Circulate tracks up \\             
              & Move trks down & Shift-Down & Circulate tracks down \\             
              & Delete tracks &  & Delete all tracks \\             

-             & Delete last track & d & Delete last track \\             
+             & Delete last track & Ctrl-Shift-D & Delete last track \\             

              & Delete first track & Shift-D & Delete first track \\             
              & Concatenate trks &  & Concatenate tracks together \\             
              & Append to Proj.  & Shift-N & Add set of tracks \\             
              & Delete first track & Shift-D & Delete first track \\             
              & Concatenate trks &  & Concatenate tracks together \\             
              & Append to Proj.  & Shift-N & Add set of tracks \\             

diff --git a/parts/Tips.tex b/parts/Tips.tex
index 611a63331c12ad050a1ec6bd6c9da5f756006337..acebf99537d0c956fba3e4da5d75f10968f7e860 100644 (file)
--- a/parts/Tips.tex
+++ b/parts/Tips.tex
@@ -394,20 +394,7 @@ so your configure line will look something like this:
        ./configure --with-single-user --with-booby --with-cuda
 \end{lstlisting}
 
        ./configure --with-single-user --with-booby --with-cuda
 \end{lstlisting}
 

-There are currently 4 available plugins for \textit{show and tell} that take advantage of the hardware acceleration of Cuda -- \textit{N\_Body} and \textit{Mandelbrot} as shown next (figure~\ref{fig:cuda-effects}), \textit{F\_scale\_cuda} and \textit{F\_yadif\_cuda}.
-
-\begin{figure}[htpb]
-       \centering
-       \begin{minipage}[h]{0.99\linewidth}
-               \center{\includegraphics[width=0.99\linewidth]{images/n_body.png}} \\
-       \end{minipage}
-       \vfill
-       \begin{minipage}[h]{0.7\linewidth}
-               \center{\includegraphics[width=0.99\linewidth]{images/mandelbrot.png}} \\
-       \end{minipage}
-       \caption{N\_Body and Mandelbrot effects}
-       \label{fig:cuda-effects}
-\end{figure}
+There are currently 4 available plugins for \textit{show and tell} that take advantage of the hardware acceleration of Cuda -- \textit{N\_Body} and \textit{Mandelbrot} (see \nameref{sec:cuda_plugins}), \textit{F\_scale\_cuda} and \textit{F\_yadif\_cuda}.

 
 An error you may see on your Cinelerra startup window when you have Cuda installed and try to run one of the 2 plugins is \textit{cudaErrorInsufficientDriver}.  This indicates CUDA 10 (the current version at the time of this writing) is not compatible with the driver version on your computer.  You can either:
 
 
 An error you may see on your Cinelerra startup window when you have Cuda installed and try to run one of the 2 plugins is \textit{cudaErrorInsufficientDriver}.  This indicates CUDA 10 (the current version at the time of this writing) is not compatible with the driver version on your computer.  You can either:
 

diff --git a/parts/Trouble.tex b/parts/Trouble.tex
index 86305ceac9c0546eb77f8feedcfdd3eee94288d3..0a773959709e8b1d3f138b5ac1dc65fa5149434e 100644 (file)
--- a/parts/Trouble.tex
+++ b/parts/Trouble.tex
@@ -16,7 +16,11 @@ installed in \texttt{/mnt0/build5/cinelerra-5.1}, you would execute the followin
 \texttt{/mnt0/build5/cinelerra-5.1/bin/cin} \\
 The problem you are experiencing may be as simple as an error due to the settings in your \texttt{\$HOME/.bcast5} subdirectory so you may want to first rename your current \texttt{.bcast5} in order to start with default settings. By renaming the directory instead of deleting it, you will be able to put it back and not lose all of your preferences.
 
 \texttt{/mnt0/build5/cinelerra-5.1/bin/cin} \\
 The problem you are experiencing may be as simple as an error due to the settings in your \texttt{\$HOME/.bcast5} subdirectory so you may want to first rename your current \texttt{.bcast5} in order to start with default settings. By renaming the directory instead of deleting it, you will be able to put it back and not lose all of your preferences.
 

-Some other troubleshooting help is also included in other sections of this manual for specific features.
+However, there are some easy things to do to fix errors that may have resulted from media problems,
+computer problems, or operational missteps so you can proceed without having to wait for help.  These
+are outlined in \ref{cha:when_things_go_wrong} - be sure to read down through
+\textit{Common Problems} where some exact error messages are mentioned along with their cause or solution.  Other 
+troubleshooting help is included in other sections of this manual for specific features.

 
 \section{What to Include in Problem Reports}%
 \label{cha:include_in_problem_reports}
 
 \section{What to Include in Problem Reports}%
 \label{cha:include_in_problem_reports}


@@ -92,12 +96,22 @@ Sometimes things go wrong and there are some ways to continue your work without
 to try before abandoning your session.
 
 \begin{enumerate}
 to try before abandoning your session.
 
 \begin{enumerate}

-       \item If you suddenly get hangs on media or strange looking tracks, you might want to rebuild indexes. You can do this in the Resources window with a right mouse click on the media to get a pulldown with the \textit{Rebuild index} option. For an easy way to rebuild for all of your media use \texttt{Settings $\rightarrow$ Preferences, Interface} tab, Index Files section, \textit{Delete existing indexes}. This will take some time to recreate all of the currently loaded media and subsequent loads, but can be an easy fix.
+       \item If you suddenly get errors or hangs on media or strange looking tracks, you might want to rebuild indexes. You can do this in the Resources window with a right mouse click on the media to get a pulldown with the \textit{Rebuild index} option. For an easy way to rebuild for all of your media use \texttt{Settings $\rightarrow$ Preferences, Interface} tab, Index Files section, \textit{Delete existing indexes}. Over time, as you
+load media, the indexes will automatically be recreated so each load takes a little longer, but this quite often
+is all that is needed to repair a media problem.

        \item On an older computer, if you are playing media and it can not keep up, you can turn off \textit{Play every frame} in the \textit{Video Out} tab of \texttt{Settings $\rightarrow$ Preferences, Playback} tab. You will then see the video jump as it skips frames in order to stay caught up.
        \item The \textit{Cache size} can be lowered to 1048 if playback seems choppy or if you have problems with lv2 plugins, or you can increase the \textit{Cache size} for better flow. This can be changed in \texttt{Settings $\rightarrow$ Preferences, Performance} tab.
        \item On an older computer, if you are playing media and it can not keep up, you can turn off \textit{Play every frame} in the \textit{Video Out} tab of \texttt{Settings $\rightarrow$ Preferences, Playback} tab. You will then see the video jump as it skips frames in order to stay caught up.
        \item The \textit{Cache size} can be lowered to 1048 if playback seems choppy or if you have problems with lv2 plugins, or you can increase the \textit{Cache size} for better flow. This can be changed in \texttt{Settings $\rightarrow$ Preferences, Performance} tab.

-       \item After saving your current session and exiting Cinelerra, you might want to rename your current \texttt{\$HOME/.bcast5} directory and start with the default setup. This will eliminate your settings as the potential cause of a problem; however, all of your current preferences will be lost until you go back to your original \texttt{.bcast5}.
+       \item After saving your session and settings and exiting Cinelerra, you might want to rename your current \texttt{\$HOME/.bcast5} directory and start with the default setup. This will eliminate your settings as the potential cause of a problem; however, all of your preferences will be lost until you go back to your original \texttt{.bcast5}.
+        \item You can also temporarily rename just Cinelerra\_rc in your \$HOME/.bcast5 directory, so
+that a new file with the original name will be created with original defaults.  You will lose your preferences,
+but it is just for testing and you can move back the renamed Cinelerra\_rc over the new one if that is not the
+cause of the problem.  Be sure to stop and restart Cinelerra whenever you rename this file.

        \item Some media has only a single keyframe at the beginning of the file so that moving anywhere on the timeline results in just a black image in the compositor. Cinelerra needs more keyframes to determine position. You can temporarily use \texttt{Settings $\rightarrow$ Proxy} to $\frac{1}{2}$ size to put in keyframes. How to use Proxy is explained in \href{sec:proxy_settings}{Proxy settings and Transcode}.
        \item Some media has only a single keyframe at the beginning of the file so that moving anywhere on the timeline results in just a black image in the compositor. Cinelerra needs more keyframes to determine position. You can temporarily use \texttt{Settings $\rightarrow$ Proxy} to $\frac{1}{2}$ size to put in keyframes. How to use Proxy is explained in \href{sec:proxy_settings}{Proxy settings and Transcode}.

-       \item If the rate at which frames are captured during Recording is much lower than the framerate of the source, the video will accumulate in the recording buffers over time and the audio and video will become out of sync. Decrease the number of frames to buffer in the device in \texttt{Settings $\rightarrow $ Preferences, Recording} tab so that the excess frames are dropped instead of buffered.
+        \item If you have enabled an \textit{Automation Curve} such as Fade or Speed on your track but it
+does not show, it could simply be because the range minimum and maximum are incorrectly set in the zoom bar.
+Set them to more reasonable values until you see the lines appear. Just as a reminder, the zoom bar is on the
+bottom of the main window (figure~\ref{fig:automation}). 
+       \item If the rate at which frames are captured during Recording is much lower than the framerate of the source, the video will accumulate in the recording buffers over time and the audio and video will become out of sync. Decrease the number of frames to buffer in the device in \texttt{Settings $\rightarrow $ Preferences, Recording} tab so that the excess frames are dropped instead of buffered.

        \item If loading files locks up, this might be because Cinelerra is building picons/vicons for the Resources window. If you load a large number of images it needs to decompress every single image to build a picon/vicon. Go into \texttt{Settings $\rightarrow$ Preferences, Appearance} tab and disable \textit{Use thumbnails in resource window} to skip this process. Keep in mind though, that it only has to create these thumbnails the first time a new piece of media is loaded or the values are changed.
        \item For an older computer with less CPU power, in \texttt{Settings $\rightarrow$ Preferences, Appearance} tab, be sure that \textit{Autocolor assets }is disabled; set \textit{View thumbnail size} \& \textit{Vicon quality}\& \textit{Vicon color mode} to lower values or switch to \textit{No Play} instead of \textit{Full Play} in the Resources window (this is to the right of the word \textit{Visibility} in the left hand side of that window). You will then have more CPU and more memory available to do actual editing.
 \end{enumerate}
        \item If loading files locks up, this might be because Cinelerra is building picons/vicons for the Resources window. If you load a large number of images it needs to decompress every single image to build a picon/vicon. Go into \texttt{Settings $\rightarrow$ Preferences, Appearance} tab and disable \textit{Use thumbnails in resource window} to skip this process. Keep in mind though, that it only has to create these thumbnails the first time a new piece of media is loaded or the values are changed.
        \item For an older computer with less CPU power, in \texttt{Settings $\rightarrow$ Preferences, Appearance} tab, be sure that \textit{Autocolor assets }is disabled; set \textit{View thumbnail size} \& \textit{Vicon quality}\& \textit{Vicon color mode} to lower values or switch to \textit{No Play} instead of \textit{Full Play} in the Resources window (this is to the right of the word \textit{Visibility} in the left hand side of that window). You will then have more CPU and more memory available to do actual editing.
 \end{enumerate}

diff --git a/parts/Windows.tex b/parts/Windows.tex
index 3730545692480d3df21c3ada21d6645ddaccad14..fa07c25d5fe2968999c32f9d4cf0399ace0e822d 100644 (file)
--- a/parts/Windows.tex
+++ b/parts/Windows.tex
@@ -638,7 +638,6 @@ The Controls zoom textbox shows $\times0.82$ size.
     \caption{Compositor window zoom slider bar and scroll bars}
     \label{fig:zoom_slider}
 \end{figure}
     \caption{Compositor window zoom slider bar and scroll bars}
     \label{fig:zoom_slider}
 \end{figure}

-

 \begin{description}
     \item[Edit mask] brings up a mask editing menu with many versatile options as
 described in great detail later in this section (\ref{sub:masks}). You may also have to click on
 \begin{description}
     \item[Edit mask] brings up a mask editing menu with many versatile options as
 described in great detail later in this section (\ref{sub:masks}). You may also have to click on


@@ -678,7 +677,7 @@ no dialog popup menus.
 
 \begin{figure}[htpb]
     \centering
 
 \begin{figure}[htpb]
     \centering

-    \includegraphics[width=0.99\linewidth]{images/safe_regions.png}
+    \includegraphics[width=0.5\linewidth]{images/safe_regions.png}

     \caption{Note the black outlines showing the safe regions. Also note the Ruler menu}
     \label{fig:safe_regions}
 \end{figure}
     \caption{Note the black outlines showing the safe regions. Also note the Ruler menu}
     \label{fig:safe_regions}
 \end{figure}


@@ -690,6 +689,7 @@ cut off section might not be as square as it appears in the compositor window.
 These are especially useful if the device for the output display is an older model TV.
 The outside largest outline is the \textit{action safe overlay}; whereas the inside smallest
 outline is the \textit{title safe overlay}.
 These are especially useful if the device for the output display is an older model TV.
 The outside largest outline is the \textit{action safe overlay}; whereas the inside smallest
 outline is the \textit{title safe overlay}.

+

 Using the \textit{Show safe regions} has no affect on the rendered output.
 The purpose of showing the borders is to make it easy to see where it might be cut off.  This
 area outside the safe region can then be used as
 Using the \textit{Show safe regions} has no affect on the rendered output.
 The purpose of showing the borders is to make it easy to see where it might be cut off.  This
 area outside the safe region can then be used as


@@ -702,13 +702,13 @@ titles are inside the inner outline and actions are inside the outer outline.
 \subsection{Compositing}%
 \label{sub:compositing}
 
 \subsection{Compositing}%
 \label{sub:compositing}
 

-A large amount of Cinelerra's editing is directed towards compositing. 
-Changing the resolution of a show, making a split screen, and fading in and out among other things are all compositing operations in Cinelerra. 
-Cinelerra detects when it is in a compositing operation and plays back through the compositing engine only then. 
-Otherwise, it uses the fastest decoder available in the hardware.
-
-Compositing operations are done on the timeline and in the Compositor window. Shortcuts exist in the Resource window for changing some compositing attributes. 
-Once some video files are on the timeline, the compositor window is a good place to try compositing.
+Much of the editing in Cinelerra involves "compositing" which is the combining of visual
+elements from different sources into single images.  This includes such things as 
+speeding up and slowing down the video, changing the resolution, creating a split screen, and fading in and out.
+Compositing operations are done on the timeline and in the Compositor window using various
+operations and other compositing attributes that are available in the Resources window.
+When Cinelerra is performing a compositing operation it plays back through the
+compositing engine, but when not, it uses the fastest decoder that it has.

 
 \subsection{Camera and Projector}%
 \label{sub:camera_and_projector}
 
 \subsection{Camera and Projector}%
 \label{sub:camera_and_projector}


@@ -827,54 +827,57 @@ In the compositing window, there is a popup menu of options for the camera and p
 \subsection{Masks}%
 \label{sub:masks}
 
 \subsection{Masks}%
 \label{sub:masks}
 

-Masks select a region of the video for either displaying or hiding. 
-Masks are also used in conjunction with another effect to isolate the effect to a certain region of the frame. 
-A copy of one video track may be delayed slightly and unmasked in locations where the one copy has interference but the other copy does not. 
-Color correction may be needed in one subsection of a frame but not another. 
-A mask can be applied to just a subsection of the color corrected track while the plain track shows through. 
-Removal of boom microphones and airplanes are a common kind of mask uses.
+Masks can be used to accomplish various tasks but basically are used to select an area of the 
+video to be displayed or hidden. 
+They can be used in conjunction with another effect to isolate the effect to a certain region.
+Another usage is where you slightly delay one video track copy and unmask an area where
+the one copy has interference but the other copy does not.  Or use a mask when  color correction is
+needed in one part of a frame but not another.  A mask can be applied to just a small section of
+a color corrected track while a plain track shows through. 
+Removal of boom microphones, license plates, people and airplanes via mask is a very common usage.

 
 

-The order of the compositing pipeline affects what can be done with masks. Mainly, masks are performed on the temporary after effects and before the projector. This means multiple tracks can be bounced to a masked track and projected with the same mask.
+The order of the compositing pipeline affects how masks are done. Usually masks are operated on the
+temporary, after the effects but before the projector. Because of the way this works, multiple
+tracks can be bounced to a masked track and projected with the same mask.

 
 The compositing pipeline graph has a masking stage (figure~\ref{fig:temporary-02}).
 
 \begin{figure}[htpb]
     \centering
     \includegraphics[width=0.7\linewidth]{images/temporary-02.pdf}
 
 The compositing pipeline graph has a masking stage (figure~\ref{fig:temporary-02}).
 
 \begin{figure}[htpb]
     \centering
     \includegraphics[width=0.7\linewidth]{images/temporary-02.pdf}

-    \caption{compositing pipeline with mask}
+    \caption{Compositing pipeline with mask}

     \label{fig:temporary-02}
 \end{figure}
 
     \label{fig:temporary-02}
 \end{figure}
 

-There are 8 possible masks per track. Each mask is defined separately, although they each perform the same operation, whether it is addition or subtraction.
-

 \subsubsection*{Compositing pipeline with masks}%
 \label{ssub:compositing_pipeline_with_masks}
 
 \subsubsection*{Compositing pipeline with masks}%
 \label{ssub:compositing_pipeline_with_masks}
 

+The Mask popup menu can be overwhelming upon first encounter.  However, if you follow the next
+few steps you can create a single simple mask without having to understand every possible parameter.

 \begin{enumerate}
 \begin{enumerate}

-    \item To define a mask, go into the Compositor window and enable the mask toggle.
-    \item  Next go over the video and click-drag. 
-        Note: You have to select automatic keyframes if you wish to move a mask over time.  
-        If you do not, the mask position will be the same even if you edit at different places on the timeline.
-    \item  Click-drag again in another part of the image to create each new point of the mask. 
-        While it is not the conventional Bezier curve behavior, this masking interface performs in realtime what the effect 
-        of the mask is going to be. Creating each point of the mask expands a rubber band curve.
-
-        Once points are defined, they can be moved by Ctrl-dragging in the vicinity of the corner. 
-        Shift-drag allows you to move existing points to new locations, thus altering the shape of the mask.  
-        However, this does not smooth out the curve. 
-        The end points of the Bezier curve are accessed by Ctrl-dragging in the vicinity of the corner. 
-        Then Ctrl-dragging near the end point causes the point to move.  
-        Shift-drag activates bezier handles (control points) to create curves between mask points.       
-
-    \item  Finally once you have a mask, the mask can be translated in one piece by Alt-dragging the mask.
-    The effect of the mask is always on.  
-    Ctrl-Alt-drag translates an entire mask to a new location on the
-    screen.
+    \item To define a mask, in the Compositor window click on the \textit{Edit mask} icon to get the popup Mask menu.  If the menu does not come up, click on the \textit{Show tool info}.
+    \item  On the video LMB click on the place where you want to start a mask.
+    \item  Then LMB click on another spot of the image to create each new point of the mask. Once
+you have at least 3 points, lines will be drawn between them, but you can just create as many
+more points as you need and the lines will be redrawn to cover all points. When you 
+create each point of the mask a straight line curve is expanded, altering the shape of the mask.
+The mask position will always be in the same place on each image of the video unless you enable 
+\textit{Generate keyframes while tweaking} on the Program window Transport and Buttons bar. When 
+enabled you can move a mask over time.
+     \item For a mask to be seen or not seen, there must be another video track under the track
+that you are viewing in the compositor.  An easy way to see the masked area is to just add an empty track
+below the target track and drag the \textit{Gradient} plugin to a highlighted area on that track.
+     \item  You can move existing points to new locations by simply using the LMB near 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 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.       

 \end{enumerate}
 
 \end{enumerate}
 

-The masks have many more parameters which could not be represented with video overlays. 
-These are represented in the tool window for masks. 
-Selecting the question mark when the mask toggle is highlighted brings up the mask options window (figure~\ref{fig:mask_window}).
+There are a lot more operations you can do using the Mask menu as shown in 
+figure~\ref{fig:mask_window}.  Detailed description is provided here next.  Note that the Mask
+window is separated into various sections to make it easier to locate the area of interest.

 
 \begin{figure}[htpb]
     \centering
 
 \begin{figure}[htpb]
     \centering


@@ -883,14 +886,12 @@ Selecting the question mark when the mask toggle is highlighted brings up the ma
     \label{fig:mask_window}
 \end{figure}
 
     \label{fig:mask_window}
 \end{figure}
 

-Masking has been greatly improved compared to the original tool.  Detailed description is provided here.  Note that the Mask window is separated into various sections to make it easier to locate the area of interest.
-

 \subsubsection*{Masks on Track section}%
 \label{ssub:masks_track_section}
 
 \subsubsection*{Masks on Track section}%
 \label{ssub:masks_track_section}
 

-The \textit{Track}: textbox displays the different video tracks for your session which will be initially set to the first armed video track or will be left blank if there are no armed tracks.  A pulldown to the right of the box brings up the names of all of the video tracks allowing you to change to which track the masking applies.  You can also just use the tumbler to easily mouse up/down to get to the desired track. In the pulldown list, any track that has red colored text is disarmed so that you can not change it.  A track that contains masks has yellow colored text for easy identification.  Only when there are no masks on the track, do you have the default text color. This textbox is display only and you can not type into it.
+The \textit{Track}: textbox displays the different video tracks for your session which will be initially set to the first armed video track or will be left blank if there are no armed tracks.  A pulldown to the right of the box brings up the names of all of the video tracks allowing you to change to which track the masking applies.  You can also just use the tumbler to easily mouse up/down to get to the desired track. In the pulldown list, any track that has a red colored text name is disarmed so that you can not change it.  A track that contains masks has yellow colored text for easy identification.  Only when there are no masks on the track, do you have the default text color. This textbox is display only and you can not type into it.

 
 

-The \textit{Solo} button in the Masks on Track section of the Mask window is very handy when working with masks on different tracks.  It displays only that track so that you only see the track you choose, as well as the tracks behind it to show the mask part.  The Solo button is just a convenience to prevent having to mouse over to the patchbay.
+The \textit{Solo} button in the Masks on Track section of the Mask window is very handy when working with masks on different tracks.  It displays just that track so that you see only the track you choose, as well as the tracks behind it to show the mask part.  The Solo button is just a convenience to prevent having to mouse over to the patchbay.

 
 \subsubsection*{Masks section}%
 \label{ssub:masks_section}
 
 \subsubsection*{Masks section}%
 \label{ssub:masks_section}


@@ -1039,50 +1040,62 @@ Note: in order to be able to rotate/scale around pointer, the Focus checkbox mus
 \subsection{Cropping}%
 \label{sub:cropping}
 
 \subsection{Cropping}%
 \label{sub:cropping}
 

-It changes the values of the output dimensions (width and height in pixels) and the $X, Y$ values of the projector in a single operation. Since it changes project settings it affects all the tracks for their entire duration and it is not keyframable. 
-
-
-  The easiest way to use cropping is to click with the LMB at the spot
-to begin cropping and while holding down the LMB drag. This creates a rectangular cropping area.
-To change the size/location of that area, click on any of the 4 corner points with the LMB
-and drag.
-Note the X1,Y1 coordinates and W for width, H for height, in the Crop tool popup menu
-automatically will change numerical value to reflect your dragging. For precise locations, you
-can keyin exact values into those textboxes.
-Once you have the crop are defined as you want it, then click on the Apply button to have the
-actual cropping take affect.
-There are 3 choices of capabilities to choose in the menu pulldown on the bottom right side.
-Reformat (or Reformat Session) which crops and changes the Format for the session. 
-Because the Format is changed, this is applied to all tracks in the project.\\
-Resize (or Resize Projector)\\
-Shrink (or Resize Projector and Camera).\\
- An important note here is that the original aspect ratio will be maintained so if your frame is rectangular (as many are) and you "crop" by surrounding the region of interest with a square, the cropped are will be more than you marked in order
-to keep the aspect rectangular shape.
+Cropping is used to reduce the visible picture area by changing the output dimensions, width and
+height in pixels, and the $X, Y$ values. An example of cropping and the crop menu is seen in
+figure~\ref{fig:cropped_area}.
+The easiest way to use cropping is to click with the LMB 
+at the spot to begin cropping and while holding down the LMB, drag the mouse. This creates a rectangular
+cropping area.  To change the size/location of that area, click on any of the 4 corner points
+with the LMB and drag.  While dragging, you will see 
+the X1, Y1 coordinates and W for width, H for height, in the Crop tool popup menu
+automatically change numerical value to reflect the current position. For precise locations, you
+can keyin exact values into those textboxes instead of using the mouse.
+Once you have the crop area defined as you want it, then click on the \textit{Apply} button to have
+the actual cropping take affect.
+
+There are 3 choices of crop methods to choose in the menu pulldown on the bottom right side.
+\begin{enumerate}
+     \item Reformat - Reformat Session crops and changes the Format for the entire session. 
+Because the Format is changed, this is applied to all tracks in the project.
+The part of the image outside the rectangle will be cut off and the projector will make the video fit.
+The  \texttt{Settings $\rightarrow$ Format} window will show the new project Width and Height values and
+the projector tool window will show the new $X, Y$ values. Track size remains unchanged.
+You can undo the cropping by entering the original project dimensions in the
+\texttt{Settings $\rightarrow$ Format} window for the Width and Height.  You will also have to use the Projector
+tool in the Compositor toolbar to \textit{Ajdust projector automation} by clicking on the Reset icon.
+     \item Resize - Resize Projector; to undo this, enable \textit{Adjust projector automation} 
+and do a Reset.
+     \item Shrink - Resize Projector and Camera; to undo this, enable each of the \textit{Adjust
+projector and camera automation} tools, one at a time, and do a Reset in the menus.
+\end{enumerate}
+An important note here is that the original aspect ratio will be maintained so if your frame is
+rectangular (as many are) and you "crop" by surrounding the region of interest with a square,
+the cropped area will be more than you marked in order to keep the aspect rectangular shape.

 The Resize and Shrink options are applicable to all video tracks except the disarmed ones. 
 This is in contrast to the Reformat option, as mentioned previously, which applies to all tracks even if disarmed because it changes the Format for the session.
 One last note of interest, this cropping is keyframable.
 
 The Resize and Shrink options are applicable to all video tracks except the disarmed ones. 
 This is in contrast to the Reformat option, as mentioned previously, which applies to all tracks even if disarmed because it changes the Format for the session.
 One last note of interest, this cropping is keyframable.
 

-

 \begin{figure}[htpb]
     \centering
     \includegraphics[width=0.5\linewidth]{images/cropped_area.png}
 \begin{figure}[htpb]
     \centering
     \includegraphics[width=0.5\linewidth]{images/cropped_area.png}

-    \caption{Cropped area is in the top right corner}
+    \caption{Crop menu and outlined crop rectangle on the right side}

     \label{fig:cropped_area}
 \end{figure}
 
     \label{fig:cropped_area}
 \end{figure}
 

+An easy to follow step by step usage of the cropping tool is outlined next.

 \begin{itemize}
 \begin{itemize}

-    \item Enable the crop toggle and the tool window in the compositor window to display the Crop control dialog box.
-    \item Click-drag anywhere in the video to define the crop area. This draws a rectangle over the video.
-    \item Click-drag anywhere in the video to start a new rectangle.
-    \item Click-drag over any corner of the rectangle to reposition the corner.
-    \item Alt-click in the cropping rectangle to translate the rectangle to any position without resizing it.
-    \item The crop control dialog allows text entry of the top left coordinates ($X1,Y1$) and bottom right coordinates ($X2,Y2$) that define the crop rectangle. When the rectangle is positioned, hit the \emph{Do it} button in the crop control dialog to execute the cropping operation: the portion of the image outside  the rectangle will be cut off and the projector will make the output fit the canvas.
-    \item The \textit{Set Format} window will show the new project Width and Height values.
-    \item The projector tool window will show the new $X, Y$ values.
-    \item Track size will remain unchanged.
+    \item Enable the crop tool in the compositor window to display the Crop popup menu.
+    \item Click-drag in the video to define the crop area which draws a rectangle on the video.
+    \item Click-drag in the video to start a different rectangle instead.
+    \item Click-drag on a corner of the rectangle to reposition that corner.
+    \item Alt-click in crop rectangle to translate the rectangle to a different position without resizing.
+    \item The crop popup menu allows text entry of the top left coordinates ($X1,Y1$) and width and
+height ($W, H$) that define the crop rectangle. 
+    \item Choose one of the 3 options of Reformat, Resize, or Shrink.
+    \item When you have the rectangle where you want it,
+click on the \emph{Apply} button in the menu to actually perform the crop operation.

 \end{itemize}
  
 \end{itemize}
  

-To undo the cropping enter the original project dimensions in the \textit{Set Format} window and click on \textit{Reset projector} in the popup menu of the compositor.

 
 \subsection{Track and Output Sizes}%
 \label{sub:track_and_output_sizes}
 
 \subsection{Track and Output Sizes}%
 \label{sub:track_and_output_sizes}