Fix pathbay figure placing

[goodguy/cin-manual-latex.git] / parts / Editing.tex

diff --git a/parts/Editing.tex b/parts/Editing.tex
index aa2e21346767e852679ea47b14545276d8d23392..11b4f53fec1d8cc083ab5b41b6e51054b930c279 100644 (file)
--- a/parts/Editing.tex
+++ b/parts/Editing.tex
@@ -23,6 +23,7 @@ In the following editing sections, references to common operations are scattered
 
 On the left of the timeline is a region known as the patchbay.  The patchbay enables features specific to each track as described next.
 
 
 On the left of the timeline is a region known as the patchbay.  The patchbay enables features specific to each track as described next.
 

+

 \begin{description}
     \item[Textbox] for naming the track.  The default names will usually be Video \#, Audio \#, or Mixer \# if using the multi-camera/mixer operations.  A \# will be designated for subsequent tracks as in 1, 2, 3 and so on.
     \item[Expander] which is a down arrow on the right side, is for viewing more options on the patchbay and for viewing the effects represented on the track.   You can just click on the expander to expand or collapse the patchbay and the track.  If it is pointing sideways, the track is collapsed.  If it is pointing down, the track is expanded.  Existing effects appear below the media for the track.
 \begin{description}
     \item[Textbox] for naming the track.  The default names will usually be Video \#, Audio \#, or Mixer \# if using the multi-camera/mixer operations.  A \# will be designated for subsequent tracks as in 1, 2, 3 and so on.
     \item[Expander] which is a down arrow on the right side, is for viewing more options on the patchbay and for viewing the effects represented on the track.   You can just click on the expander to expand or collapse the patchbay and the track.  If it is pointing sideways, the track is collapsed.  If it is pointing down, the track is expanded.  Existing effects appear below the media for the track.


@@ -31,16 +32,15 @@ On the left of the timeline is a region known as the patchbay.  The patchbay ena
 \noindent Below the textbox name are several toggles referred to as \textit{attributes} for different features (currently there are 5 as shown in figure~\ref{fig:patchbay01}).  If the toggle button is shadowed by a color, the feature is enabled . If the toggle is the background color of most of the window, it is disabled. Click 
 on the toggle to enable/disable the feature.
 
 \noindent Below the textbox name are several toggles referred to as \textit{attributes} for different features (currently there are 5 as shown in figure~\ref{fig:patchbay01}).  If the toggle button is shadowed by a color, the feature is enabled . If the toggle is the background color of most of the window, it is disabled. Click 
 on the toggle to enable/disable the feature.
 

-\begin{wrapfigure}[17]{O}{0.4\linewidth}
+\begin{wrapfigure}[15]{O}{0.3\linewidth}

     \vspace{-2ex}
     \centering
     \includegraphics[width=0.79\linewidth]{images/patchbay01.png}
     \caption{Patchbay}
     \vspace{-2ex}
     \centering
     \includegraphics[width=0.79\linewidth]{images/patchbay01.png}
     \caption{Patchbay}

-    \label{fig:patchbay}
+    \label{fig:patchbay01}

 \end{wrapfigure}
 
 
 \end{wrapfigure}
 
 

-

 Several mouse operations speed up the configuration of several tracks at a time. Click on an attribute and drag the cursor across adjacent tracks to copy the same attribute to those tracks.  Hold down Shift while clicking a track's attribute to enable the attribute in the current track and toggle the attribute in all the other tracks. Or you can:
 
 \begin{enumerate}
 Several mouse operations speed up the configuration of several tracks at a time. Click on an attribute and drag the cursor across adjacent tracks to copy the same attribute to those tracks.  Hold down Shift while clicking a track's attribute to enable the attribute in the current track and toggle the attribute in all the other tracks. Or you can:
 
 \begin{enumerate}


@@ -54,6 +54,9 @@ The \textit{attributes} are described here next.
 \begin{description}
     \item[Play Track] determines whether the track is rendered or not. If it is off, the track is not rendered.  For example if you turn it off in all the video tracks, the rendered media file will have only audio tracks.  If the track is chained to any other tracks by a shared track effect, the other tracks perform all the effects in this shared track, regardless of play status of the shared track that in this particular case affects the media output but not fade and effects.
     \item[Arm Track] determines whether the track is armed or not.  Only the armed tracks are affected by editing operations. Make sure you have enough armed destination tracks when you paste or splice material or some tracks in the material will get left out.  In addition to restricting editing operations, the armed tracks in combination with the active region determine where material is inserted when loading files.  If the files are loaded with one of the insertion strategies which do not delete the existing project, the armed  tracks will be used as destination tracks.
 \begin{description}
     \item[Play Track] determines whether the track is rendered or not. If it is off, the track is not rendered.  For example if you turn it off in all the video tracks, the rendered media file will have only audio tracks.  If the track is chained to any other tracks by a shared track effect, the other tracks perform all the effects in this shared track, regardless of play status of the shared track that in this particular case affects the media output but not fade and effects.
     \item[Arm Track] determines whether the track is armed or not.  Only the armed tracks are affected by editing operations. Make sure you have enough armed destination tracks when you paste or splice material or some tracks in the material will get left out.  In addition to restricting editing operations, the armed tracks in combination with the active region determine where material is inserted when loading files.  If the files are loaded with one of the insertion strategies which do not delete the existing project, the armed  tracks will be used as destination tracks.

+\end{description}
+
+\begin{description}

     \item[Gang Fader] cause the fader to track the movement of whatever other fader you are adjusting by dragging either the fader or the curve on the track.  It doesn't affect the editing made with menu controls.  A fader is only ganged if the arm track is also on.  This is often used to adjust audio levels on all the tracks simultaneously.  Gang also causes Nudge parameters to synchronize across all the ganged tracks.
     \item[Draw Media] determines if picons or waveforms are drawn on the asset in the track.  You may want to disable this if you know that the media/format takes a long time to draw on the timeline.  By default it is set to on in order to see picons on the timeline.
     \item[Don’t send to output] , more commonly called \textit{mute}, causes the output to be thrown away once the track is completely rendered. This happens whether or not \textit{Play track} is on.  For example if you mute all the video tracks, the rendered media file will have a blank video track.  Mute track is represented on the timeline with a line that has the default color of pink/orange.  Use the pulldown View $\rightarrow$ Mute to have the line displayed.  It is a keyframable attribute, but Mute track keyframing is a toggle and it has only the two values of on or off. If a track is part of a shared track effect, the output of the track with the shared track effect is overlaid on the final output even though it is routed back to another track (the shared track).  Mute track is used to keep the track with the shared track effect from overlapping the output of the source track (the shared track) where the shared track effect is not present.
     \item[Gang Fader] cause the fader to track the movement of whatever other fader you are adjusting by dragging either the fader or the curve on the track.  It doesn't affect the editing made with menu controls.  A fader is only ganged if the arm track is also on.  This is often used to adjust audio levels on all the tracks simultaneously.  Gang also causes Nudge parameters to synchronize across all the ganged tracks.
     \item[Draw Media] determines if picons or waveforms are drawn on the asset in the track.  You may want to disable this if you know that the media/format takes a long time to draw on the timeline.  By default it is set to on in order to see picons on the timeline.
     \item[Don’t send to output] , more commonly called \textit{mute}, causes the output to be thrown away once the track is completely rendered. This happens whether or not \textit{Play track} is on.  For example if you mute all the video tracks, the rendered media file will have a blank video track.  Mute track is represented on the timeline with a line that has the default color of pink/orange.  Use the pulldown View $\rightarrow$ Mute to have the line displayed.  It is a keyframable attribute, but Mute track keyframing is a toggle and it has only the two values of on or off. If a track is part of a shared track effect, the output of the track with the shared track effect is overlaid on the final output even though it is routed back to another track (the shared track).  Mute track is used to keep the track with the shared track effect from overlapping the output of the source track (the shared track) where the shared track effect is not present.


@@ -197,7 +200,8 @@ pasted one after the other, keeping the same order they have on the stack.
 
 \paragraph{Split --- blade cut and hard edges:} You can cut the tracks into 2 pieces on the timeline by putting the hairline cursor on the place you want to do a cut and then using the character “x” or the scissors tool (figure~\ref{fig:cut}). 
 
 
 \paragraph{Split --- blade cut and hard edges:} You can cut the tracks into 2 pieces on the timeline by putting the hairline cursor on the place you want to do a cut and then using the character “x” or the scissors tool (figure~\ref{fig:cut}). 
 

-\begin{wrapfigure}[16]{O}{0.3\textwidth}
+\begin{wrapfigure}[16]{O}{0.3\linewidth}
+    \vspace{-1ex}

     \centering
     \includegraphics[width=0.9\linewidth]{images/cut.png}
     \caption{Blade cut}
     \centering
     \includegraphics[width=0.9\linewidth]{images/cut.png}
     \caption{Blade cut}


@@ -363,11 +367,9 @@ Explanation of how to use Inter-View mode will be described here next.
 
 \begin{itemize}
     \item Do your editing as usual on the timeline until you are ready to see what is used or unused.
 
 \begin{itemize}
     \item Do your editing as usual on the timeline until you are ready to see what is used or unused.

-    \item Make sure you are in Preview mode in the Resources window; you enable this mode using the menu
-        \textit{Full play} to the left of the word Search \quad
-        \includegraphics[height=\baselineskip]{images/fullplay.png}.
-    \item Middle mouse click on a thumbnail in the Resources window and a popup occurs of that media with a
-        white colored bar at the top and a red colored bar at the bottom with black sections.
+    \item Make sure you are in any of the Preview modes in the Resources window; you enable the mode using the pulldown to the left of the word Search.  The option looks like this
+    \quad \includegraphics[height=\baselineskip]{images/fullplay.png}.   \item Middle mouse click on a thumbnail in the Resources window and a popup occurs of that media with a
+    white colored bar at the top and a red colored bar at the bottom with black sections.

 \end{itemize}
 
 The red/white bars represent the presence and the black sections represent the absence of where that media is used on the timeline.  To get to a bigger representation, use the “f” key for a full screen.  Now
 \end{itemize}
 
 The red/white bars represent the presence and the black sections represent the absence of where that media is used on the timeline.  To get to a bigger representation, use the “f” key for a full screen.  Now


@@ -592,13 +594,11 @@ Now to use this feature, create a track with edits that have trims on the left a
 
 \paragraph{Cutting/Snapping edits} cuts from an edit handle to the insert point. 
 There are Edit Panel buttons which normally are used to move to the previous or next edit handle/label.
 
 \paragraph{Cutting/Snapping edits} cuts from an edit handle to the insert point. 
 There are Edit Panel buttons which normally are used to move to the previous or next edit handle/label.

-
-\begin{wrapfigure}[8]{O}{0.3\textwidth}
-    \vspace{-2ex}
+\begin{wrapfigure}[5]{r}{0.2\linewidth}
+    \vspace{-1ex}

     \centering
     \centering

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

 \end{wrapfigure}
 \end{wrapfigure}

-

 They look like tags and the letter E on the menu bar and are oriented forward/backward.  These same buttons can be used to \textit{cut} from the insert pointer to the previous or next edit/label when the \texttt{ctrl+alt} keys are both pressed when the buttons are used.  They \textit{snap} off the media instead of doing the standard re-positioning.  This is useful to minimize the number of operations necessary to cut between edits/labels.
 
 Instead of using the edit panel buttons, you can more easily use the following keyboard shortcuts to perform the same functions:
 They look like tags and the letter E on the menu bar and are oriented forward/backward.  These same buttons can be used to \textit{cut} from the insert pointer to the previous or next edit/label when the \texttt{ctrl+alt} keys are both pressed when the buttons are used.  They \textit{snap} off the media instead of doing the standard re-positioning.  This is useful to minimize the number of operations necessary to cut between edits/labels.
 
 Instead of using the edit panel buttons, you can more easily use the following keyboard shortcuts to perform the same functions:


@@ -905,33 +905,86 @@ event: (0, 0, 0x0)
 
 \noindent When done, you will have to Ctrl-C to get out of the program.
 
 
 \noindent When done, you will have to Ctrl-C to get out of the program.
 

-\paragraph{Note 4} For developers, it is also possible to do the following for further in depth testing:
-    \begin{lstlisting}[language=Bash]
-# to locate numerical value of the shuttle, e.g. 0003:0B33.0030.0006
-$ ls /sys/kernel/debug/hid   
-$ cat “/sys/kernel/debug/hid/0003:0B33.0030.0006/rdesc” # substitute your own numerical value
-$ cat “/sys/kernel/debug/hid/0003:0B33.0030.0006/events” # press keys to see the results
-    \end{lstlisting}
+\paragraph{Note 4} For developers, if you have a pre-UEFI Secure Boot kernel it is also possible to do the following for further in depth testing:
+
+\begin{enumerate}
+    \item \texttt{ls /sys/kernel/debug/hid   \# to locate numerical value of the shuttle, e.g. 0003:0B33.0030.0006}
+    \item \texttt{cat “/sys/kernel/debug/hid/0003:0B33.0030.0006/rdesc”    \# substitute your own numerical value}
+    \item \texttt{cat “/sys/kernel/debug/hid/0003:0B33.0030.0006/events”  \# press keys to see the results}
+\end{enumerate}

 
 \subsection{Shuttle key default arrangement for Cinelerra / Composer / Viewer:}%
 \label{sub:shuttle_key_default_cinelerra}
 
 
 \subsection{Shuttle key default arrangement for Cinelerra / Composer / Viewer:}%
 \label{sub:shuttle_key_default_cinelerra}
 

-The following is the default setting for the ShuttlePROv2 and ShuttleXpress (table~\ref{tab:shuttleprov2} and table 2):
-
-\vspace{1ex} \textbf{ShuttlePROv2:}
-
-\begin{table}
-    \caption{ShuttlePROv2 key default arrangement for Cinelerra / Composer / Viewer}
-    \label{tab:shuttleprov2}
-    \centering
-    \begin{tabular}{c c c c c c c c}       
-        \toprule
-        & K1 & & K2 & & K3 & & K4 \\
-        & Label & & Future use & & Future use & & Clip \\
-        &       & & Splice (viewer) & & Copy & & Overwrite (viewer) \\
-        \midrule
-        
-    \end{tabular}
-\end{table}
+The following is the default setting for the ShuttlePROv2 and ShuttleXpress (table~\ref{tab:shuttleprov2} and table~\ref{tab:xpress}):

 
 

+\begin{landscape}   
+    \begin{table}[htpb]
+        \centering
+        \caption{ShuttlePROv2 key default arrangement for Cinelerra / Composer / Viewer}
+        \label{tab:shuttleprov2}
+        \begin{tabular}{c c c c c c c}       
+            \toprule
+            K1 & K2 & & K3 & K4 & & \\
+            Label & Future use & & Future use & Clip & & \\
+                  & Splice (viewer) & & Copy  & Overwrite (viewer) & & \\
+                  \midrule
+            K5 & K6 & K7 & K8 & K9 & & \\
+            Home & Reverse & Stop & Play & End & & \\
+                 &         & Fullscreen & & & & \\
+                 &         & (viewer / compositor) & & & & \\
+                 \midrule
+            Home(Defaults) & MouseBtn1(D) & MouseBtn2(D) & MouseBtn3(D) & End(Defaults) & & \\
+            \midrule
+            \multicolumn{7}{c}{Shuttle Outer Wheel} \\
+            \multicolumn{7}{c}{Play forward (first row) or Play reverse (second row)} \\        
+            S1=Stop &   S2=1/2 &   S3=Normal  &  S4=2x  &  S5=4x  &  S6=8x &   S7=16x \\
+            S-1=Stop &  S-2=1/2 &  S-3=Normal &  S-4=2x &  S-5=4x &  S-6=8x  & S-7=16x \\
+            \midrule
+            K14        & & Jog Left & (Inner Wheel) & Jog Right & & K15 \\ 
+            Toggle In & & Frame reverse & & Frame forward & & Toggle Out \\
+                      & & Scroll up(Defaults) & & Scroll down(Defaults) & & \\
+                      \midrule
+                      & & K10  & &  K11 & & \\
+                      & & Previous Edit & & Next Edit & & \\
+                      & & Future Use(Viewer) & & Future Use(Viewer) & & \\
+                      \midrule
+                      & & K12  & &  K13 & & \\
+                      & & Previous Edit & & Next Edit & & \\
+                      & & Previous Label & & Next label & & \\
+                      \bottomrule
+        \end{tabular}
+    \end{table}
+\end{landscape}
+
+\begin{landscape}   
+    \begin{table}[htpb]
+        \centering
+        \caption{ShuttleXpress key default arrangement for Cinelerra / Composer / Viewer}
+        \label{tab:xpress}
+        \begin{tabular}{c c c c c c c}       
+            \toprule        
+            K5 & K6 & K7 & K8 & K9 & & \\
+            Home & Reverse & Stop & Play & End & & \\
+                 &         & Fullscreen & & & & \\
+                 &         & (viewer / compositor) & & & & \\
+                 \midrule
+            Home(Defaults) & MouseBtn1(D) & MouseBtn2(D) & MouseBtn3(D) & End(Defaults) & & \\
+            \midrule
+            \multicolumn{7}{c}{Shuttle Outer Wheel} \\
+            \multicolumn{7}{c}{Play forward (first row) or Play reverse (second row)} \\        
+            S1=Stop &   S2=1/2 &   S3=Normal  &  S4=2x  &  S5=4x  &  S6=8x &   S7=16x \\
+            S-1=Stop &  S-2=1/2 &  S-3=Normal &  S-4=2x &  S-5=4x &  S-6=8x  & S-7=16x \\
+            \midrule
+                     & & Jog Left & (Inner Wheel) & Jog Right & & \\ 
+                     & & Frame reverse & & Frame forward & & \\
+                     & & Scroll up(Defaults) & & Scroll down(Defaults) & & \\  
+                     \bottomrule      
+        \end{tabular}
+    \end{table}
+    \centering        
+
+
+
+\end{landscape}