New Motion changes by SGE + other Andrea fixes, MatN review fixes, Andrew notfication...
[goodguy/cin-manual-latex.git] / parts / Transition.tex
index 7dba75191713caacfe3fb7e9ec0a3454a9c08caa..a581cf6f24e840c32efe0c9673af3725e716aed4 100644 (file)
@@ -6,7 +6,7 @@ the usual result is that the first edit's output immediately is followed by the
 
 \begin{figure}[htpb]
     \centering
-    \includegraphics[width=0.8\linewidth]{images/transition.png}
+    \includegraphics[width=0.8\linewidth]{transition.png}
     \caption{Resources window displaying the Video Transitions.}
     \label{fig:transition}
 \end{figure}
@@ -30,7 +30,7 @@ The \textit{Detach} option deletes the transition from the timeline. When you dr
 
 There are some shortcuts to alleviate the dragging and dropping of transitions when you want to do a lot of them in various places on the timeline. After you have established the parameter values for a transition that you have dragged from the Resources window, you can use "U" and "u" keys to paste the same transition;
 the "U" key pastes the last video transition while the "u" key pastes the last audio transition on all recordable tracks. 
-Alternatively, you can add the same transition to multiple edits when in \textit{Arrow mode} (Drag and Drop editing), by selecting edits to add the transition to and use the Video/Audio pulldown to \textit{Attach transition}. Select the desired transition and then click the checkmark OK. You can set a default transition in the Attach transition popup box -- by highlighting your choice, then click on the button \textit{Set Default Transition}, and you will see that transition become the new default.
+Alternatively, you can add the same transition to multiple edits when in \textit{Arrow mode} (Drag and Drop editing), by selecting edits to add the transition to and use the \textit{Video/Audio} pulldown to \textit{Attach transition}. Select the desired transition and then click the checkmark OK. You can set a default transition in the Attach transition popup box -- by highlighting your choice, then click on the button \textit{Set Default Transition}, and you will see that transition become the new default.
 
 The way that transitions work is that two edits overlap for some length of time and no edits are actually moved during the transitions.
 Instead extra frames from the source file will be used to lengthen the first edit enough to make it overlap the second edit for the length of the transition. The transition takes effect exactly at the beginning of the second edit and lasts for the specific length of time you set into the second edit. 
@@ -91,22 +91,54 @@ Video switches segments via a small rectangular view that gradually grows to ful
 \subsection*{Shape Wipe}%
 \label{sub:shape_wipe}
 
-Wipe a specific shape across the video. Currently available shapes are: \textit{burst}, \textit{Butterfly},
- \textit{circle}, \textit{Circle-h\_01}, \textit{Circle-h\_02}, \textit{Circle-v\_01}, \textit{Circle-v\_02},
- \textit{clock}, \textit{Clouds\_01}, \textit{Clouds\_02}, \textit{Cross-Iris\_01}, \textit{Cross\_01},
-\textit{Diagonal-Curve}, \textit{Diagonal-Linear}, \textit{Diamond-Iris\_01}, \textit{Diamond\_01},
- \textit{Diamond\_02}, \textit{Diamond\_03}, \textit{Double-Door-h}, \textit{Double-Door-v}, \textit{Gravity},
-\textit{heart}, \textit{Linear-h}, \textit{Linear-v}, \textit{Plasma\_01}, 
- \textit{specks}, \textit{spiral}, \textit{tile2x2h}, \textit{tile2x2v}, \textit{Venetian-Blinds-h-x05},
- \textit{Venetian-Blinds-h-x10}, \textit{Venetian-Blinds-v-x05}, and \textit{Venetian-Blinds-v-x10}\protect\footnote{many shapes by Igor Beg}. 
-
+Wipe a specific shape across the video. Currently available 63 shapes are:
+
+\begin{center}
+       \begin{longtable}{p{4cm}p{4cm}p{4cm}}
+               \label{tabular:transitions}
+               \textit{asimetric\_clocks} & \textit{asimetric\_clocks\_2} & \textit{audio} \\
+               \textit{burst} & \textit{Butterfly} & \textit{Circle-h\_01} \\
+               \textit{Circle-h\_02} & \textit{Circle-v\_01} & \textit{Circle-v\_02} \\
+               \textit{circle} & \textit{clock} & \textit{Clouds\_01} \\
+               \textit{Clouds\_02} & \textit{crazy\_clock} & \textit{cream} \\
+               \textit{Cross-Iris\_01} & \textit{Cross\_01} & \textit{Diagonal-Curve} \\
+               \textit{Diagonal-Linear} & \textit{Diamond-Iris\_01} & \textit{Diamond\_01} \\
+               \textit{Diamond\_02} & \textit{Diamond\_03} & \textit{Double-Door-h} \\
+               \textit{Double-Door-v} & \textit{film} & \textit{film2} \\
+               \textit{Gravity} & \textit{heart} & \textit{Linear-h} \\
+               \textit{Linear-v} & \textit{mosaic} & \textit{multi\_box} \\
+               \textit{Plasma\_01} & \textit{rare\_spiral} & \textit{specks} \\
+               \textit{spiral} & \textit{spiral\_clock} & \textit{square} \\
+               \textit{squares} & \textit{star} & \textit{tile2x2h} \\
+               \textit{tile2x2v} & \textit{Venetian-Blinds-h-x05} & \textit{Venetian-Blinds-h-x10} \\
+               \textit{Venetian-Blinds-v-x05} & \textit{Venetian-Blinds-v-x10} & \textit{water} \\
+\\
+                \textit{Cinelerra16-9-Heavy} & \textit{Cinelerra16-9-Light} & \textit{CinelerraGG} \\
+                \textit{16-9\_boart} & \textit{16-9\_boxes} & \textit{16-9\_cat\_eyes} \\
+                \textit{16-9\_film\_bands} & \textit{16-9\_multi\_circle} & \textit{16-9\_multi\_spiral} \\
+                \textit{16-9\_multi\_square} & \textit{16-9\_rare\_spiral} & \textit{16-9\_rectangles} \\
+                \textit{16-9\_star} & \textit{16-9\_stars} & \textit{16-9\_wood} \\
+
+               \bottomrule
+       \end{longtable}
+\end{center}
 The menu for Shape Wipe that popups when you click on \textit{Show} has several possible choices.  First, the \textit{Shape} allows for choosing from the list of shapes as outlined previously either by typing in the textbox, using the down arrow, or clicking on the tumbler down/up arrows.
-Next, there is a \textit{Feather} textbox with tumbler arrows or a slider bar to easily change the blending amount.  A reset button is conveniently located to the right of the slider bar.  There is a checkbox to \textit{Preserve shape aspect ratio} and a \textit{Direction} of \textit{White to Black} or \textit{Black to White}.
+Next, there is a \textit{Feather} textbox with tumbler arrows or a slider bar to easily change the blending amount.  A reset button is conveniently located to the right of the slider bar.  There is a checkbox to \textit{Preserve shape aspect ratio} and a \textit{Direction} of \textit{White to Black} or \textit{Black to White} (figure~\ref{fig:star}).
+
+\begin{figure}[htpb] \centering
+       \includegraphics[width=0.9\linewidth]{star.png}
+       \caption{Example of the Shape Wipe $\rightarrow$ Star}
+       \label{fig:star}
+\end{figure}
 
-You can add your own images to the Shape Wipe transition and there are some free ones available to download such as under the \texttt{Video $\rightarrow$ Transitions} pulldown at {\small \url{assistcg.com}}.
+You can add your own images to the Shape Wipe transition and there are some free ones available to download such as under the \texttt{Video $\rightarrow$ Transitions} pulldown at {\small \url{http://assistcg.com}}.
 
-To include new images in the Shape Wipe Transition, simply copy the file \texttt{{shape}.png} to the
- subdirectory \texttt{plugins/shapes} in your \CGG{} directory path.
+To include new images in the Shape Wipe Transition, simply copy the file \textit{shape.jpg} or
+\textit{shape.png} to the subdirectory \texttt{plugins/shapes} in your \CGG{} directory path. If
+you prefer to have a better quality png used instead of the included 90\% jpg version, you can download
+the equivalent png versions at {\small \url{https://cinelerra-gg.org/download/ShapeWipe\_pngs.txz}}.
+You will then need to untar this file, choose the ones you want, and add them to your directory path.
+After an update of \CGG{}, they will have to be restored each time.
 
 \subsection*{Slide}%
 \label{sub:slide}