+\end{description}
+
+Table showing the allowed usage:
+
+\begin{lstlisting}[numbers=none]
+target: | eq ge gt ne le lt matches around
+++++++++++++++++++++++++++++++++++++++++++++++++++++++++
+patterns | <---- strcmp ---------> + filter + nearest
+file_size | <---- arithmetic -------+------> + radius
+mod_time | <---- arithmetic -------+------> + radius
+track_type | <---- member test ------+--------+------>
+width | <---- arithmetic -------+------> + radius
+height | <---- arithmetic -------+------> + radius
+framerate | <---- arithmetic -------+------> + radius
+samplerate | <---- arithmetic -------+------> + radius
+channels | <---- arithmetic -------+------> + radius
+duration | <---- arithmetic -------+------> + radius
+\end{lstlisting}
+
+where in the above, the filter can be:
+
+\begin{tabular}{rcl}
+ filter&=&list\\
+ filter&=&token\\
+ list&=&[token]\\
+ list&=&[token]list\\
+ string&=&<chars>|<empty>\\
+ token&=&string\\
+ token&=&string*token\\
+\end{tabular}
+
+Examples with some caveats first:
+
+\begin{enumerate}
+ \item \textit{Or} generally includes or adds whereas \textit{And} generally excludes or subtracts.
+ \item The filters only work on media in the folder; if there is no media, then there is nothing to search.
+ \item The examples below are not meant to be executed as a list of filters in Modify folder, they are just single line examples to indicate what can work.
+ \item Sort is by filename base name (directory path not included automatically) except when the \textit{Around} operation is used and then it is sorted by that Target distance first and then filename.
+\end{enumerate}
+
+\begin{longtable}{lllm{10em}m{10em}}
+ \caption{Examples}
+ \label{tab:label}\\
+ \toprule
+ \textbf{Enable} & \textbf{Target} & \textbf{OP} & \textbf{Value} & \textbf{meaning} \\
+ \hline
+ %begin{latexonly}
+ \endhead
+ %end{latexonly}
+ Or & Patterns & Matches & * & all files from the Media Folder are included \\
+ And Not & Filesize & Lt & 160000000 & no files that are less than 160MB in size \\
+ Or Not & Time & Ge & 2018/07/30 06:13:00 & files not greater than or equal date \\
+ And & Duration & Eq & 01:00 & files included must have 60 secs. Duration \\
+ Off & Samplerate & Ne & 44000 & off for now, but may want to include later \\
+ And & Framerate & Around & 24+1 & files included all have 24 to 25 framerate \\
+ Or & Patterns & Matches & [*.mp4] & all files with the extension of mp4 \\
+ Or & Time & Around & 2018/08/02 06:00:00 + 02:00:00 & files at 4 AM to 8 AM \\
+ \bottomrule
+\end{longtable}
+
+\subsection{Vicons \& Aicons – aka Video Icons / Audio Icons}%
+\label{sub:vicons_aicons_aka_video_icons_audio_icons}
+\index{vicon!video icons}
+\index{aicon!audio icons}
+
+Vicons are video icons.
+Aicons are audio icons.
+By default the Resources window will play the first 5 seconds of video or audio waveform looped in the area occupied by the media icons (figure~\ref{fig:vicons1}).
+This is enabled for the Media/Proxy folders in icon mode when the mouse pointer is inside the Resources window.
+
+\begin{figure}[htpb]
+ \centering
+ \includegraphics[width=0.99\linewidth]{vicons1.png}
+ \caption{Note "Full Play" mode and Vicons and Aicons in Media folder}
+ \label{fig:vicons1}
+\end{figure}
+
+The waveform \index{waveform} in the figure~\ref{fig:vicons2} is displayed in the Resources window in the color green for the 3 audio tracks.
+There is a colored bar \index{color bar aicons} on the top of each a-icon where the color is based on the Color Spectrum -- the smaller the time duration, the redder the color; then as the time duration goes up, the color goes up so that you will go to green, then yellow, then blue, then really dark blue, then purple for the audio files 1 hour and over.
+There are various other colors between these colors same as that seen in the color spectrum in the screenshot below.
+Colors are utilized from the hue wheel in the counter-clockwise direction.
+Note that the horizontal line in the middle of the a-icon is yellow/red representing the 2 audio tracks and is only red for mono.
+
+
+
+\begin{figure}[htpb]
+ \centering
+ %\includegraphics[width=0.8\linewidth]{name.ext}
+ \begin{tikzpicture}[scale=1, transform shape]
+ \node (img1) [yshift=0cm, xshift=0cm, rotate=0] {\includegraphics[width=0.99\linewidth]{vicons2.png}};
+ \node (img2) [yshift=0cm, xshift=2.8cm, rotate=0] at (img1.south west) {\includegraphics[width=0.3\linewidth]{hue_wheel.png}};
+ \node [yshift=-5mm, xshift=1cm,anchor=west] at (img2.east) (Arrow1) {\parbox{18em}{Color hue wheel. For illustration only}};
+ \draw [->, line width=1mm] (Arrow1) edge ([yshift=-5mm] img2.east);
+ \end{tikzpicture}
+ \caption{Draw Vicons | Screenshot display various audio file lengths; red is shortest.}
+ \label{fig:vicons2}
+\end{figure}
+
+Note that if in \texttt{Settings $\rightarrow$ Preferences} under the Appearance tab, you have unchecked \textit{Use thumbnails in resource window} you will only have default icons and none of the above capabilities.
+
+
+\subsection{Resources Window Preview Mode}%
+\label{sub:resources_window_preview_mode}
+\index{resources preview}
+
+
+Preview mode can be used to pop up a window which draws the vicons/aicons thumbnails in a larger size.
+Preview or \textit{draw vicons} mode is a helpful feature of \CGG{} that lets you see and/or hear the first 5 seconds of the video for identification purposes.
+The Preview mode/playback toggle is to the right of the Visibility label as seen in the screenshot above.
+Preview mode is available for the Media, Proxy, Media User Bins, and Clips but clips are only 1 image.
+
+When \textit{Preview/draw vicons} is enabled/active, if you click on one of the video icons or an audio waveform icon, a view pops up that increases the size to 4 times the surface area larger.
+This makes it easier to see or hear if it is the media you are looking for in case you have many similar media files.
+To conserve memory, the video is stored 8\,bits per pixel which results in low image quality while the audio is 16\,bit.
+The reason for playing 5 seconds of a video for a vicon is that until the first I-frame, the media frequently does not decode properly.
+In other words, a lot of media does not begin at the \textit{beginning} point and will not be properly rendered until enough data has been read to assemble a picture.
+You can increase the thumbnail size, clarity of pixels (memory size) and color mode but it takes a lot more memory.
+Change these values in \texttt{Settings $\rightarrow$ Preferences}, Appearance tab, right hand side of the Layout section -- be aware that when you click OK, your session will re-initialize.
+You can also temporarily increase the preview mini-window by use of the mouse wheel up or down for media but not for clips.
+
+There are 4 options for the preview mode.
+
+\begin{enumerate}
+ \item \emph{Full Play} \index{full play} is the default mode.
+ This means all of the media will automatically play when the mouse is in the Resources window and you can use the left mouse button to click on specific media to see it pop up in a larger view.
+ Audio only files do not play the audio until the icon is clicked on and the waveform aicon pops up into the 4x larger mode.
+ \emph{Full Play} includes the \emph{Mouse Over} capabilities as described below as well as the Inter-View \emph{Src Target} functions.
+
+ \item \emph{No Play} \index{no play} mode is especially useful on smaller computers and for users who find the constant loop play to be somewhat distracting.
+
+ \item \emph{Mouse Over} \index{mouse over} mode is activated by a single click on one of the vicons/aicons and deactivated with another single click over any of the icons.
+ Once activated, whenever you just move the mouse over an icon, it automatically pops up the increased size preview.
+ The first time in your session that you enable this feature, it may take a few seconds to load all of the icon previews into memory so be patient and just wait.
+ \emph{Mouse Over} mode makes it quick and easy to preview without having to drag the media to the viewer.
+ You can still drag the media same as without preview enabled.
+
+ \item \emph{Src Target} \index{source target} mode gives easy access to the Inter-View source target available by using the middle mouse button on media.
+ There are 2 advantages to this mode -- there is no 5 second play loop taking up cpu time and the popup allows for the use of the letter “\texttt{f}” on that popup to have it go to fullscreen mode.
+ \emph{Src Target} mode in any scenario never plays sound as that is nonsensical usage.
+ After the initial click to pop media in this mode, you also have the \emph{Mouse over} feature.
+\end{enumerate}
+
+For any of the options, but not \emph{No Play}, you can temporarily turn off that option by clicking on the button using the middle mouse button.
+This helps to avoid having the thumbnail get in the way of dragging or other functions.
+When you do, a line will be drawn through the current preview mode so that you are aware that it is in \emph{No Play} mode until click it again.
+
+Note that if in \texttt{Settings $\rightarrow$ Preferences} under the Appearance tab, you have unchecked \textit{Use thumbnails in resource window} you will only have default icons and no active previews.
+
+\begin{figure}[htpb]
+ \begin{minipage}{.69\linewidth}
+ \centering
+ \includegraphics[width=0.99\linewidth]{preview_icon_mode.png}
+ \caption{The location of the Preview/Draw Icons mode.}
+ \label{fig:preview_icon_mode}
+ \end{minipage}
+ \hfill
+ \begin{minipage}{.29\linewidth}
+ \vspace{2ex}
+ \centering
+ \includegraphics[width=0.7\linewidth]{line_through_mode.png}
+ \caption{Note the line through the mode.}
+ \label{fig:line_through_mode}
+ \end{minipage}
+\end{figure}
+
+
+
+\subsection{Moving clips/media from/to Resources window}%
+\label{sub:moving_clips_media_from_to_resources_window}
+\index{copy/paste from/to resources window}
+
+If you have several media files loaded into the Resources window of one instance of \CGG{} and want to load some of the same ones into another instance or just want a listing to save in a file for later use, you can do this with these set of steps:
+
+Copy or paste a list of files in the Media Resources window:
+
+
+\begin{enumerate}
+ \item create a highlighted selection of the desired media files in the media Resources window
+ \item right click on an unused portion of that window to bring up the popup menu
+ \item select the \textit{Copy file list} item and a file list box will appear that contains the full path filenames
+ \item wipe the textbox using your standard copy/paste method to put the list of files in the copy buffer
+ \item in another \CGG{} instance, choose the \textit{Paste file list} of the media Resources window
+ \item paste the list of files, again using your standard paste method, into the new file list box; press OK
+ \item the status bar of the main window will be updated as the file list is loaded to the media folder (the purpose of displaying the status is simply to show that the load is progressing normally).
+\end{enumerate}
+
+Obviously this \textit{Paste file list} feature means you can create a list of files outside of \CGG{} using an editor, wipe the names, and then use \textit{Paste file list} to load them into the media Resources window.
+
+It is important to note that in the steps above, the Operating System cut and paste capabilities are in use for steps 4 and 6 as opposed to \CGG{}’s c/v shortcuts.
+Since the procedure varies among the distros, you will have to adapt to your specific one. For example, a usage for ubuntu consists of:
+\begin{enumerate}
+ \setcounter{enumi}{3}
+ \item Ctrl-c to copy the list of files; open gedit; Ctrl-v to paste the list of files into gedit
+ \item Ctrl-c or the standard way using the right click to copy this list from gedit
+ \item Ctrl-v paste the list of files into the new file list box, and press OK
+\end{enumerate}
+
+\begin{figure}[htpb]
+ \centering
+ \begin{minipage}{.9\linewidth}
+ \centering
+ \includegraphics[width=0.99\linewidth]{copy_files1.png}
+ \end{minipage}
+ \vfill
+ \begin{minipage}{.5\linewidth}
+ \centering
+ \includegraphics[width=0.99\linewidth]{copy_files2.png}
+ \end{minipage}
+ \caption{Example of copy file list}
+ \label{fig:copy_files1}
+\end{figure}
+
+In the Figure~\ref{fig:copy_files1}, one instance of \CGG{} has 3 items in the Media area highlighted that were copied to the file list.
+Note how it includes the full pathname.
+
+In this screenshot on another instance of \CGG{}, there are only 2 items in the media but the \textit{Paste file list} box is ready to have the items inserted via the standard text box paste method. When that is done, the additional 6 media files will be available on this other instance too.
+
+
+Another possible usage of this capability:
+
+\begin{enumerate}
+ \item Right Click on the Clips Resources window and use the \textit{Paste Clip} option to paste the Copy selection as a clip.
+ \item Similarly, by highlighting a clip in the Resources window and selecting its copy popup menu item using the right mouse button, that copy buffer can now be loaded onto the timeline.
+\end{enumerate}
+
+
+\subsection{Snapshot / Grabshot}%
+\label{sub:snapshot_grabshot}
+\index{snapshot}
+\index{grabshot}
+
+\begin{figure}[htpb]
+ \centering
+ \begin{minipage}{.49\linewidth}
+ \centering
+ \includegraphics[width=0.8\linewidth]{snapshot.png}
+ \caption{Snapshot menu and choices}
+ \label{fig:snapshot}
+ \end{minipage}
+ \begin{minipage}{.49\linewidth}
+ \centering
+ \begin{tikzpicture}[scale=1, transform shape]
+ \node (img1) [yshift=0cm, xshift=0cm, rotate=0] {\includegraphics[width=0.65\linewidth]{grabshot.png}};
+ \node (img2) [yshift=2cm, xshift=-1cm, rotate=0] {\includegraphics[width=0.07\linewidth]{reticle.png}};
+ \end{tikzpicture}
+ \caption{Grabshot reticle \& orange box}
+ \label{fig:grabshot_recticle}
+ \end{minipage}
+\end{figure}
+
+To take a snapshot, perform the following steps:
+
+\begin{enumerate}
+ \item set your timeline insert marker where you want the snapshot -- this frame shows in the compositor
+ \item right click in an empty spot in the media folder and the popup shows snapshot as the $5^{th}$ item down
+ \item highlight that and the submenu comes up allowing you to choose png, jpg, ppm or tiff
+\end{enumerate}
+
+The snapshot shows up in the Media folder.
+It is saved by default in \texttt{/tmp} as
+
+\texttt{snap\_date-time.ext} BUT you can change the default directory path in \texttt{Settings $\rightarrow$ Preferences $\rightarrow$ Interface tab} in the right hand side of the Editing section.
+
+Grabshot is the $6^{th}$ menu item.
+A red circle reticle can be moved to the area to grab; use left mouse drag to surround an area; and right click to grab.
+
+
+
+
+\section{Other Options and Other Windows}%
+\label{sec:other_options_and_other_windows}
+
+\subsection{Transport Controls}%
+\label{sub:transport_controls}
+\index{transport buttons}
+
+Transport controls are useful for navigation and for playing media.
+Each of the Viewer, Compositor, and Program windows has its own transport panel.
+The controls generally all contain a colored tooltip when you mouse over the control, providing a hint of their function and shortcuts for usage.
+
+The transport panel is controlled by the keyboard as well as the graphical interface.
+For each of the operations it performs, the starting position is the position of the insertion point in the Program window and the slider in the Compositor and Viewer windows.
+The ending position is either the end or start of the timeline or the end or start of the selected region if there is one.
+
+The orientation of the end or start depends on the direction of playback.
+If it is forward the end position is the end of the selected region.
+If it is backward the end position is the start of the selected region.
+The insertion point moves to track playback.
+When playback stops, the insertion point stays where playback stopped.
+Thus, by playing back you change the position of the insertion point.
+The keyboard interface of either the numeric pad or alternative keys has more speeds with the addition of \emph{Forward Slow}(2) and \emph{Reverse Slow} (5).
+Hitting any key on the keyboard twice pauses it.
+The shortcuts section of this manual as well as a Shell Command available from the \CGG{} main window has a listing of each of the keys.
+
+When using frame advance functions the behavior may seem odd.
+If you frame advance forward and then frame advance backward, the displayed frame does not change.
+This is because the playback position is not the frame but the time between two frames.
+The rendered frame is the area that the playback position crosses.
+When you increment the time between two frames by one and decrement it by one, you cross the same frame both times and so the same frame is displayed.
+There is an option in \texttt{Settings $\rightarrow$ Preferences, Appearance tab} to \textit{Always show next frame} that may help make this clearer for some users.
+
+The transport behavior changes if you hold down Ctrl when issuing any of the transport commands. This causes the starting point to be the In point if playing forward and the Out point if playing backward. If playing forward, the Out point becomes the ending point and if playing backward, the In point becomes the ending point. If no In/Out points are specified, the behavior falls back to using the insertion point and track boundaries as the starting and ending points.
+
+The transport behavior also changes if you hold down the Shift key along with KeyPad 1--6.
+If normally audio is included in the play, it will be removed and if normally audio is not included in the play, it will be added.
+
+
+\subsection{Zoombar}%
+\label{sub:zoombar}
+\index{zoom}
+
+The compositor has zoom capability.
+The pull-down menu on the bottom of the compositor window has a number of zoom options.
+When set to Auto the video is zoomed to match the compositor window size as closely as possible.
+When the video is zoomed bigger than the window size, you can use scrollbars to scan around or if the zoom icon is enabled, the middle mouse button can be used to zoom in or out the video.
+
+The zoom toggle also causes the Compositor window to enter zoom mode.
+In zoom mode, clicking in the video output zooms in while a Ctrl-click in the video output zooms out.
+If you have a wheel mouse, rotating the wheel zooms in or out too.
+Zooming in or out with the zoom tool does not change the rendered output.
+It is merely for scrutinizing video or fitting it in the desktop. Playing video on the compositor when zoomed to any size other that 100\%, the original size, requires \CGG{} to do extra processing steps.
+This could affect performance on slower systems
+
+\subsection{Show Overlays}%
+\label{sub:show_overlays}
+\index{show ovelays window}
+
+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 \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.
+
+There is a line separating the first 4 items, which are just non-automation type settable values as opposed to \textit{auto} keyframe types.
+The color is not changeable for the 3 items of Mode, Pan, and Mask which simply display their symbol icon.
+
+Figure~\ref{fig:overlays_window} displays the Show overlays popup with all of its options and color coded types such as yellow for Speed and blue for Camera Z.
+Upon clicking on the associated \textit{color ball} to the right of any keyframe type, for example \textit{Fade} in this screenshot, the color wheel palette window pops up so that you can manipulate the color as desired.
+
+\begin{figure}[htpb]
+ \centering
+ \includegraphics[width=0.85\linewidth]{overlays_window.png}
+ \caption{Show Overlays window on the left with the Color ball window to the right to set color}
+ \label{fig:overlays_window}
+\end{figure}
+
+Figure~\ref{fig:overlays1} shows several color coded lines for different keyframes along with the Fade slider for manipulation.
+The slider is in the same color as the color coded keyframe type line which is the same color as in the \textit{Show overlays} window.
+
+\begin{figure}[htpb]
+ \centering
+ \includegraphics[width=1.0\linewidth]{overlays1.png}
+ \caption{Lines are colored here on the timeline as designated in Show Overlays}
+ \label{fig:overlays1}
+\end{figure}
+
+Overlays Window Nuances:
+
+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.
+
+\begin{itemize}
+ \item Shift+LMB (left mouse button) in the Overlays Window on a checkbox will turn off all other
+ checkboxes except for the one you are on. Then this named box will have outline for a \textit{hot} spot.
+ \item Shift+LMB on this \textit{hot} spot will return to \textit{cool} of the previous settings with all of the previous
+ checkboxes checked again.
+\end{itemize}
+
+\begin{figure}[htpb]
+ \begin{minipage}{.29\linewidth}
+ \centering
+ \includegraphics[width=0.99\linewidth]{overlays_list1.png}
+ \caption{Original Settings --- cool spot}
+ \label{fig:overlays_list1}
+ \end{minipage}
+ \hfill
+ \begin{minipage}{.29\linewidth}
+ \centering
+ \includegraphics[width=0.99\linewidth]{overlays_list2.png}
+ \caption{Note Titles box hot spot }
+ \label{fig:overlays_list2}
+ \end{minipage}
+ \hfill
+ \begin{minipage}{.29\linewidth}
+ \centering
+ \includegraphics[width=0.99\linewidth]{overlays_list3.png}
+ \caption{Cam/Proj XYZ toggle to fine tune}
+ \label{fig:overlays_list3}
+ \end{minipage}
+\end{figure}
+
+\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 \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
+ because you need to be able to see what is going on.
+ \item Caveat \#3 - XYZ toggle on/off of Camera and Projector are not affected.
+\end{itemize}
+
+
+
+
+\subsection{Sound Level Meters Window}%
+\label{sub:sound_level_meters_window}
+\index{sound level meters window}
+
+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.
+
+\begin{wrapfigure}[18]{O}{0.3\linewidth}
+ \centering
+ \vspace{-2ex}
+ \includegraphics[width=0.5\linewidth]{volume_meter.png}
+ \caption{Sound Level Meters Window}
+ \label{fig:volume_meter}