- \item[Masks tool] this tool brings up the mask editing tool. Enable “Show tool info” to see the options.
- \item[Camera] the camera brings up the camera editing tool. Enable “Show tool info” to see options.
- \item[Projector] the projector brings up the projector editing tool. Enable “Show tool info” for options.
- \item[Crop tool] this tool brings up the cropping tool. “Show tool info” must be enabled to use this tool.
- \item[Eyedropper] brings up the eyedropper. The eyedropper detects whatever color is under it and stores it
- in a temporary area. Enabling the “Show tool info” shows the currently selected color. Click
- anywhere in the video output to select the color at that point. The eyedropper not only lets you see
- areas which are clipped, but its value can be applied to many effects. Different effects handle the
- eyedropper differently.
- \item[Show tool info] this tool button works only in conjunction with the other controls on the compositor.
- Based on what compositing control is active, the toggle button will activate or deactivate the
- appropriate control dialog box. Controls with dialog boxes are: Edit mask, Camera and Projector
- automation, Crop control, and Get color.
- \item[Safe regions tool] draws the safe regions in the video output. The largest (external) square is called \textit{action safe overlay}; the smallest internal square is called \textit{title safe overlay}. They are especially useful if the destination is the TV. This does not affect the rendered output
+ \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
+\textit{Show tool info} to popup the menu depending on whether or not you dismissed that window previously.
+ \item[Ruler] this can be a handy tool to get the X,Y coordinates of an exact point or to
+measure the distance between 2 points. To use the \textit{Ruler}, move the mouse on the video to
+get to the desired spot - these X,Y coordinates will be displayed in the \textit{Current} text
+box. Clicking the LMB creates Point 1 and then continue to hold down the LMB so that a ruler line is created between
+this Point 1 and the stopping Point 2. \textit{Deltas} is the X,Y difference between the 2 points;
+\textit{Distance} is the number of pixels between the 2 points; and \textit{Angle} is the angle in degrees of the ruler line.
+In Figure~\ref{fig:safe_regions} you can see the Ruler menu on the right side of the Compositor window.
+
+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 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
+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 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 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. 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 \textit{Protect video from changes}, \textit{Zoom view}, and \textit{Show safe regions} since they have
+no dialog popup menus.
+
+\begin{figure}[htpb]
+ \centering
+ \includegraphics[width=0.9\linewidth]{safe_regions.png}
+ \caption{Note the black outlines showing the safe regions. Also note the Ruler menu}
+ \label{fig:safe_regions}
+\end{figure}
+
+ \item[Show safe regions] draws 2 outlines to display the safe regions in the video as you
+can see in Figure~\ref{fig:safe_regions}.
+On some particular TVs/monitors/displays, the borders of the image are cut off and that
+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}.
+
+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
+a scratch or vertical blanking space. Enabling the safe regions makes it really
+easy to see these borders so that you can make sure
+titles are inside the inner outline and actions are inside the outer outline.
+