Credit Andrea with many more html table fixes
[goodguy/cin-manual-latex.git] / parts / Windows.tex
index 546a55515cf67949cfa6daa14ddc7ae3face050a..2c637afe80664dd22cd7a676b6abed52e8829499 100644 (file)
@@ -84,7 +84,7 @@ Each of the symbols has an associated tooltip as an easy reminder of its functio
 several is described in a little more detail in other areas of this manual. 
 
 \vspace{2ex}
-\begin{tabular}{ll}
+\begin{longtable}{ll}
    \hline
        First set of 3 symbols & Move in the reverse direction on the timeline \\
         4th symbol & Stop play \\
@@ -105,7 +105,7 @@ several is described in a little more detail in other areas of this manual.
        Set Timecode & Explained in \ref{sub:align_timecodes}  \\
        Gang Modes & Explained in \ref{sub:displaying_tracks_ganged} \\
    \hline
-\end{tabular}
+\end{longtable}
 
 The \textit{Manual Go To} \index{goto} menu is quite versatile as you can see in figure~\ref{fig:goto_menu}.  The
 options of \textit{=} represents goto the position indicated in the textbox; \textit{+} indicates
@@ -252,30 +252,6 @@ For best results, \textit{Align cursor on frames} \index{Align cursor on frames}
 Use the pulldown \texttt{Settings$\rightarrow$Align cursor on frames} to change the alignment by
 checking the box on for video and off for audio.
 
-\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.6\linewidth]{insertion-point.png}};
-        \node [yshift=-5mm, xshift=-1cm,anchor=east] at (img1.north west) (Pulldowns) {Pulldowns};
-        \node [yshift=-10mm, xshift=-1cm,anchor=east] at (img1.north west) (Transport) {Transport \& Buttons Bar};
-        \node [yshift=-15mm, xshift=-1cm,anchor=east] at (img1.north west) (Timebar) {Timebar};
-        \node [yshift=-20mm, xshift=-1cm,anchor=east] at (img1.north west) (Title) {Media Title };
-        \node [yshift=-28mm, xshift=-1cm,anchor=east] at (img1.north west) (Video) {Video Track};
-        \node [yshift=-46mm, xshift=-1cm,anchor=east] at (img1.north west) (Audio) {Audio Track};
-        \draw [->, line width=1mm] (Pulldowns) edge  ([yshift=-5mm] img1.north west);
-        \draw [->, line width=1mm] (Transport) edge  ([yshift=-10mm] img1.north west);
-        \draw [->, line width=1mm] (Timebar) edge    ([yshift=-15mm] img1.north west);
-        \draw [->, line width=1mm] (Title) edge      ([yshift=-20mm] img1.north west);
-        \draw [->, line width=1mm] (Video) edge      ([yshift=-28mm] img1.north west);
-        \draw [->, line width=1mm] (Audio) edge      ([yshift=-46mm] img1.north west);
-        \end{tikzpicture}
-    
-    \caption{Insertion point is at 0:00:25:10 in Hr:Mn:Sec:Frames}
-    \label{fig:insertion-points}
-\end{figure}
-
 
 \subsection{Editing Modes}%
 \label{sub:editing_modes}
@@ -286,9 +262,31 @@ There are 2 different editing modes for operations which affect how the insertio
 on the timeline operate.  
 There is:  \emph{drag and drop mode} and \emph{cut and paste mode}. 
 The editing mode is determined by selecting the \texttt{arrow} \index{arrow}, or immediately to the right of the arrow,
-the \texttt{I-beam} \index{i-beam} in the Transport and Buttons bar. In figure~\ref{fig:insertion-points} you can see
-the green colored highlight \protect\footnote{green is used in the default Cakewalk theme, but the highlight color will be different in other themes} on the arrow icon indicating that you are currently in 
-\emph{drag and drop mode}.
+the \texttt{I-beam} \index{i-beam} in the Transport and Buttons bar. In figure~\ref{fig:insertion-points} you can see the green colored highlight \protect\footnote{green is used in the default Cakewalk theme, but the highlight color will be different in other themes} on the arrow icon indicating that you are currently in \emph{drag and drop mode}.
+
+\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.6\linewidth]{insertion-point.png}};
+               \node [yshift=-5mm, xshift=-1cm,anchor=east] at (img1.north west) (Pulldowns) {Pulldowns};
+               \node [yshift=-10mm, xshift=-1cm,anchor=east] at (img1.north west) (Transport) {Transport \& Buttons Bar};
+               \node [yshift=-15mm, xshift=-1cm,anchor=east] at (img1.north west) (Timebar) {Timebar};
+               \node [yshift=-20mm, xshift=-1cm,anchor=east] at (img1.north west) (Title) {Media Title };
+               \node [yshift=-28mm, xshift=-1cm,anchor=east] at (img1.north west) (Video) {Video Track};
+               \node [yshift=-46mm, xshift=-1cm,anchor=east] at (img1.north west) (Audio) {Audio Track};
+               \draw [->, line width=1mm] (Pulldowns) edge  ([yshift=-5mm] img1.north west);
+               \draw [->, line width=1mm] (Transport) edge  ([yshift=-10mm] img1.north west);
+               \draw [->, line width=1mm] (Timebar) edge    ([yshift=-15mm] img1.north west);
+               \draw [->, line width=1mm] (Title) edge      ([yshift=-20mm] img1.north west);
+               \draw [->, line width=1mm] (Video) edge      ([yshift=-28mm] img1.north west);
+               \draw [->, line width=1mm] (Audio) edge      ([yshift=-46mm] img1.north west);
+       \end{tikzpicture}
+       
+       \caption{Insertion point is at 0:00:25:10 in Hr:Mn:Sec:Frames}
+       \label{fig:insertion-points}
+\end{figure}
 
 With the arrow highlighted for \emph{drag and drop mode}, a double click with the left mouse button in the timeline selects the edit the mouse pointer is over. 
 Then dragging in the timeline repositions that edit and this can be used for moving effects,
@@ -487,9 +485,6 @@ and waveforms with transluent colors.  The pink media file has been self-colored
 
 The main window pulldowns as pointed out in figure~\ref{fig:insertion-points} are quite obvious in their meaning and usage, so here is only a summary.  
 
-%TODO Figure 3 shows an example of the pulldowns as displayed in the main window.Appearance
-
-
 \begin{description}
     \item[File] \index{file} options for loading, saving, and rendering as described in other sections (\ref{cha:load_save_and_the_EDL}).
     \item[Edit] \index{edit} edit functions; most of which have shortcuts that you will quickly learn (\ref{cha:editing}).
@@ -1624,100 +1619,97 @@ Figure~\ref{fig:info_asset_details} shows the \textit{Detail} box to click on th
 \index{folder add filter/search}
 
 Creating folders that are more specific to a particular project is helpful in better organizing your work.  
-This can be done by utilizing the files already loaded to the \textit{master} Media or Clips folders in the Resources window.  The general rule is you can only drag clips to a ClipUserBin and you can only drag media to a MediaUserBin.
+This can be done by utilizing the files already loaded to the \textit{master} Media or Clips folders in the Resources window.  The general rule is you can only drag clips to a ClipUserBin and you can only drag media to a MediaUserBin. No subfolders can be created within the new folders. Further below, after we populate the new folder, we will see how to use logical operators or other filters to automatically sort the media.
 
-Below are steps illustrating an easy way to set up a folder.
+Below are steps illustrating an easy way to set up a new folder.
 
-%TODO Below part need to be rewriten
 \begin{enumerate}
-    \item In the Resources window (figure~\ref{fig:folder_resources}), in the location of the Video/Audio effects and Media folders, bring up the \textit{Folder}$\dots$ popup by clicking the right mouse button.  
-        Highlight, then click \textit{New Media or Clips}.
-        \begin{figure}[htpb]
-            \begin{minipage}{.6\linewidth}
-                \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.
-                    “Delete folder” in the popup can be used to delete a folder.
-                }
-                \label{fig:folder_resources}
-            \end{minipage}
-            \hfill
-            \begin{minipage}{.37\linewidth}
-                \centering
-%begin{latexonly}
-                \vspace{18ex}
-%end{latexonly}
-
-                \includegraphics[width=0.9\linewidth]{folder_new.png}
-                \caption{Type in your folder name in the textbox.  Click OK.}
-                \label{fig:folder_new}
-            \end{minipage}
-        \end{figure}
+    \item In the Resources window (figure~\ref{fig:folder_resources}), in the location of the Video/Audio effects and Media folders, bring up the \textit{Folder...} popup by clicking the right mouse button. Highlight, then click \textit{New Media} or \textit{New Clips}. \textit{Modify folder} can be used to change the name of a folder. \textit{Delete folder} can be used to delete a folder.
     \item  In the \textit{New folder} popup as shown below (figure~\ref{fig:folder_new}), type in your folder name in the textbox.  Click OK.
-     \begin{figure}[htbp]    
-       \centering
-       \includegraphics[width=0.9\linewidth]{folder_master.png}
-       \caption{The “master” Media folder}
-       \label{fig:folder_master}
-     \end{figure}     
-    \item  Select the \textit{master} Media folder to see which files are currently loaded, figure~\ref{fig:folder_master}.  
-        Highlight the files there that you want to copy to your new folder (named Photos of Garden).  
-        Drag the files to the left and when you see the Photos of Garden folder become highlighted, then drop there.  
-        You can drag and drop any of the media from the \textit{master} Media at any time.  
-        It flashes when the drop is successful.
+    \item  Select the \textit{master} Media folder to see which files are currently loaded, figure~\ref{fig:folder_master}. Highlight the files there that you want to copy to your new folder (named \textit{Photos of Garden}). Drag the files to the left and when you see the \textit{Photos of Garden} folder become highlighted, then drop there. You can drag and drop any of the media from the \textit{master} Media at any time. It flashes when the drop is successful.       
 \end{enumerate}
 
-Adding the Shift key before the actual drop, will allow for relative path filenames instead of full path.
-But you might want to include or eliminate some of the media that exists in one of the folders that you have set up already.  
-In this case you will want to click on the \textit{Modify folder} in the popup.  
-When you bring up the Modify folder window, if you already have files in that folder, you will see filters that were generated automatically when you did a Drag and Drop.
+\begin{figure}[htpb]
+       \centering
+       \includegraphics[width=0.5\linewidth]{folder_resources.png}
+       \caption{New folder menu}
+       \label{fig:folder_resources}
+\end{figure}
+
+\begin{figure}[htpb]
+       \centering
+       \includegraphics[width=0.4\linewidth]{folder_new.png}
+       \caption{Folder name}
+       \label{fig:folder_new}
+\end{figure}
+
+ \begin{figure}[htbp]    
+       \centering
+       \includegraphics[width=0.8\linewidth]{folder_master.png}
+       \caption{The “master” Media folder}
+       \label{fig:folder_master}
+\end{figure}
+
+\subsection{Modify Folder: sorting the media}%
+\label{sub:sorting_media}
+\index{folder modify}
+
+In \CGG{} all the virtual mediafiles loaded in the \textit{Resources} window are collected in the \texttt{Media} folder without any kind of organization and sorting other than alphabetical. The Media folder is considered a \textit{master} folder because it is the basis for every other new folder we create. Another \textit{master} folder is \texttt{Clips}, and in fact we can create new clips folders as well. If we do editing of large projects containing numerous mediafiles, a rational and selective organization of the source material becomes necessary. In fact, having the sources organized in folders, where they can be found and used easily, makes subsequent editing much faster, as well as minimizing confusion and the possibility of errors. This step, which is fundamental in the pro environment, is called \textit{Logging} and also includes \textit{screening} individual mediafiles in the Viewer window; \textit{renaming} them rationally; and adding labels and descriptions in the \textit{metadata}.
+
+We start by creating one or more new folders (MediaUserBin). These will be empty and we should populate them with the mediafiles contained in the master Media folder. There are two options: manual \textit{Drag and Drop} or automatic populating by setting \textit{filters} (Smart Bins).
 
+\paragraph{Drag and Drop:} you drag mediafiles into the new folder one by one or in selected groups. The starting master folder can only be \texttt{Media} (or \texttt{Clips}, if we have created a new clip folder). Dragging is done by preserving the absolute path of the sources. If you open Modify Folder window you will notice that each imported mediafile occupies a different row characterized by its own path and name. See figure~\ref{fig:modify-target}. The \texttt{Value} field containing paths can contain only 63 characters, and it may happen to find the names cut off. The full path and name can be found by right-clicking on the row, but this is inconvenient and time-consuming. The best solution is to drag the mediafiles while holding down the \texttt{Shift} key; this will return the relative path instead of the absolute path, with space gain.
 
 \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.7\linewidth]{folder_modify.png}};
-        \node [yshift=-20mm, xshift=-1cm,anchor=east] at (img1.north west) (Arrow1) {\parbox{8em}{Here is the filter that was generated with the original drop }};
-        \node [yshift=-65mm, xshift=0cm,anchor=east] at (img1.north west) (Arrow2) {\parbox{10em}{When you click on the Value portion of that filter, the entire set of files that are covered by the filter rules pops up.   Now you can highlight a target filename that you would like to remove, and just erase that line and check the green checkmark for OK.}};
-        \draw [->, line width=1mm] (Arrow1) edge  ([yshift=-20mm] img1.north west);
-        \end{tikzpicture}
-    
-    \caption{Modify target}
-    \label{fig:modify-target}
+       \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.7\linewidth]{folder_modify.png}};
+               \node [yshift=-20mm, xshift=-1cm,anchor=east] at (img1.north west) (Arrow1) {\parbox{8em}{Here is the filter that was generated with the original drop }};
+               \draw [->, line width=1mm] (Arrow1) edge  ([yshift=-20mm] img1.north west);
+       \end{tikzpicture}
+       
+       \caption{Modify Folder}
+       \label{fig:modify-target}
 \end{figure}
 
-To delete the entire set of files listed on the filter rule, highlight the rule line and hit the \textit{Del} button.  
+\paragraph{Filters:} you do automatic populating using filters (Smart Bins mode). You set the values of the \texttt{Enabled}; \texttt{Target}; \texttt{Op} and \texttt{Value} fields to make up the required filtering. The folder will populate automatically by pulling from the \texttt{Media} master folder. The filter is the result of one row, but we can do more sophisticated filtering by adding more rows. The process will start from the first row propagating to subsequent rows always following the pattern from top to bottom. See figure~\ref{fig:modify_folder}.
+
+\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.8\linewidth]{modify_folder1.png}};
+               \node (img2) [yshift=-1cm, xshift=3.5cm, rotate=0] at (img1) {\includegraphics[width=0.8\linewidth]{modify_folder2.png}};
+               \node (img3) [yshift=-1cm, xshift=3cm, rotate=0] at (img2){\includegraphics[width=0.5\linewidth]{modify_folder3.png}};
+       \end{tikzpicture}
+       \caption{The available choices for each field. Value field missing.}
+       \label{fig:modify_folder}
+\end{figure}
+
+Let's look in detail at all the options of Modify Folder. 
+
+When you bring up the Modify folder window, if you already have files in that folder, you will see filters that were generated automatically when you did a Drag and Drop. See figure~\ref{fig:modify-target}.
+
+When you click on the \textit{Value} portion of that filter, the entire set of files that are covered by the filter rules pops up.   Now you can highlight a target filename that you would like to remove, and just erase that line and check the green checkmark for OK.
+
+To delete the entire set of files listed on the filter rule, highlight the rule line and hit the \textit{Del} button. 
+
 To add a new filter rule, click on the \textit{Add} button which will automatically add a default line after any current lines.  
-The default line will be a line that matches everything in the \textit{master} Media folder which is \textit{Or  Patterns  Matches   *}.  
+The default line will be a line that matches everything in the master Media folder which is \textit{Or  Patterns  Matches   *}.  
 Click the right mouse button on the current field underneath the column header to see the choices available for each column.  
 
-Modifications will not be in effect until you click on the green arrow OK button or click on the Apply button.  
+Modifications will not be in effect until you click on the green arrow \textit{OK} button or click on the \textit{Apply} button.  
 But once you hit Apply, clicking on the red X button will not undo your changes.  
 The filter/search rules are applied in the order listed in the Modify folder window.  
 You can change the order of the filter rules by highlighting the rule you want to move and then drag and drop to a new location.
 
-The figure~\ref{fig:modify_folder} below displays the available choices for each field.
-
-\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.8\linewidth]{modify_folder1.png}};
-        \node (img2) [yshift=-1cm, xshift=3.5cm, rotate=0] at (img1) {\includegraphics[width=0.8\linewidth]{modify_folder2.png}};
-        \node (img3) [yshift=-1cm, xshift=3cm, rotate=0] at (img2){\includegraphics[width=0.5\linewidth]{modify_folder3.png}};
-    \end{tikzpicture}
-    \caption{The available choices for each field}
-    \label{fig:modify_folder}
-\end{figure}
-
 Information about the columns and rules for the search filters in the Modify folder window follows \index{folder add filter/search}.
 
 Column headers:
 
 \begin{description}
-\item[ Enable]  this column is used to designate the state of that filter rule
+\item[\textcolor{CinBlueText}{Enable}]  – this column is used to designate the state of that filter rule
     \begin{description}
         \item[Off]             disable the filter
                 \item[And]             narrow your search; all of your search terms must be present
@@ -1725,7 +1717,7 @@ Column headers:
                 \item[And Not] exclude terms that do not contain the given value from your search results
                 \item[Or Not]  include terms that do not contain the given value from your search results
     \end{description}
-\item [Target] – this column designates which media asset attribute to look at
+\item [\textcolor{CinBlueText}{Target}] – this column designates which media asset attribute to look at
     \begin{description}
         \item[Patterns]        each line contains a filename filter, matches the file path
                 \item[Filesize]        number of bytes in a file
@@ -1738,7 +1730,7 @@ Column headers:
                 \item[Channels]        Number of audio channels
                 \item[Duration]        Playback time in seconds -- it uses the largest of audio or video if contains both
     \end{description}
-\item[Op] – boolean operators used to narrow or broaden the relationship between your search terms
+\item[\textcolor{CinBlueText}{Op}] – boolean operators used to narrow or broaden the relationship between your search terms
     \begin{description}
         \item[Around]  about this value; use \textit{+radius} for a search range: [target–radius$\dots$  target+radius]
         \item[Eq       ]       equal to
@@ -1751,14 +1743,14 @@ Column headers:
     \end{description}
 \end{description}
 
-\textbf{Value} --- the characteristic you are looking for with expressions that can be written with the following:
+\textbf{\textcolor{CinBlueText}{Value}} --- the characteristic you are looking for with expressions that can be written with the following:
 
-\begin{description}
-\item[Number] (decimal points are allowed and will be converted to a standard form):
-    \begin{description}
-        \item[inf] representing infinity
-        \item[\#[TtGgMmKk]]  ---  where \# represents a number and the characters mean:
-    \end{description}
+       \begin{description}
+       \item[Number] (decimal points are allowed and will be converted to a standard form):
+       \begin{description}
+                \item[inf] representing infinity
+                \item[\#[TtGgMmKk]]  ---  where \# represents a number and the characters mean:
+       \end{description}
 
     \begin{tabular}{rcl}
         inf&=& infinity\\
@@ -1808,7 +1800,6 @@ Column headers:
 
 Table showing the allowed usage:
 
-%TODO create table for below code
 \begin{lstlisting}[numbers=none]
 target:    |  eq  ge  gt  ne  le  lt   matches  around
 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++
@@ -1845,24 +1836,25 @@ Examples with some caveats first:
     \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{table}[htpb]
-    \centering
-    \caption{Examples}
-    \label{tab:label}
-    \small
-    \begin{tabular}{lllm{10em}m{10em}} \toprule
-        Enable&        Target& Op&     Value&  meaning\\\midrule
-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 4AM to 8 AM\\\bottomrule
-    \end{tabular}
-\end{table}
-
+\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}