Andrea reworked Batch Render for changes + minor fixes
[goodguy/cin-manual-latex.git] / parts / Transition.tex
index f8c7b30eee33176b0ded5bd52ddc5fba195b7b3e..67ba7b551edbc576762b622d495aa9c07656be88 100644 (file)
@@ -1,5 +1,6 @@
 \chapter{Transition Plugins}%
 \label{cha:transition_plugin}
+\index{transitions}
 
 When playing a section of media where one edit ends and another edit begins on the timeline,
 the usual result is that the first edit's output immediately is followed by the second edit.  Transitions provide a better method whereby the first edit’s output becomes the second edit’s output.  There are several different audio and video transitions listed in the Resources window as figure~\ref{fig:transition}.
@@ -11,11 +12,10 @@ the usual result is that the first edit's output immediately is followed by the
     \label{fig:transition}
 \end{figure}
 
-Note the colored bar above the \textit{Shape Wipe} transition.
-This bar near the transition symbol shows the position and the length of the transition.
+Note the bluish colored bar above the \textit{Shape Wipe} transition.
+This bar near the transition symbol shows the position and the length of the transition. We can extend or reduce the length of the bar (and therefore the duration of the transition) by simply dragging the right edge of the bar to the desired position. In the \textit{zoom bar}, at the bottom left where the words \texttt{Welcome to Cinelerra} appears, this is replaced by the real time length of the bluish bar. The unit of measure adopted is that of the timebar --the default is \textit{hh:mm:ss:frame}; we can change it as we like (RMB on timebar).
 
-Transitions only apply to the matching track type; that is audio transitions only apply to audio tracks
-and video transitions only apply to video tracks.
+Transitions only apply to the matching track type; that is audio transitions only apply to audio tracks and video transitions only apply to video tracks.
 
 An example usage of a transition follows:
 \begin{enumerate}
@@ -26,11 +26,18 @@ The beginning of the edit will be covered by the transition, if the insertion po
 Some Transitions have parameters that can be modified. To see these, move the pointer over the transition and right click which brings up a menu. A \texttt{Show} option will pop up a window if there are parameters that you can change to different values. 
 An \textit{On} option makes it possible to turn off the transition so that it will not be in effect in case you want to only enable it under certain conditions.  The default value for this will be checked On.
 A \textit{Length} option lets you adjust the length in seconds of the time that the transition will be in play.  Values modified in the Show or Length will be saved for use the next time that transition is used until changed again. 
-The \textit{Detach} option deletes the transition from the timeline. When you drag and drop a different transition on top of an existing transition on the timeline, it replaces the previous one.
+The \textit{Detach} option deletes the transition from the timeline. When you drag and drop a different transition on top of an existing transition on the timeline, it replaces the previous one (see figure~\ref{fig:transition01}).
+
+\begin{figure}[htpb]
+       \centering
+       \includegraphics[width=0.8\linewidth]{transition01.png}
+       \caption{GUI for Wipe transition}
+       \label{fig:transition01}
+\end{figure}
 
 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. 
@@ -42,7 +49,7 @@ When playing transitions, software rendering is used.  This means that if you ar
     
 When \textit{Info on} is enabled via the right mouse button over an empty space in the Resources window (or the shortcut of the letter “i” is used), a short description will be provided in the lower right hand corner of that window for the current transition that the mouse is on.
 
-Once you have dragged and dropped a transition to the timeline, right mouse click on the transition and a pop-up menu will appear which provides an opportunity to make some changes.  These are described next for all video and audio transitions. 
+Once you have dragged and dropped a transition to the timeline, right mouse click on the transition and a pop-up menu will appear which provides an opportunity to make some changes.  These are described next for all video and audio transitions (see figure~\ref{fig:transition01})
 
 \begin{description}
     \item[Show] If available, clicking on this will pop up a transition specific menu.
@@ -54,42 +61,51 @@ There is a down arrow next to the Seconds box allowing for changing to the other
 
 \section{Audio Transitions}%
 \label{sec:audio_transition}
+\index{transitions!audio}
 
 \subsection*{Crossfade}%
 \label{sub:crossfade}
+\index{crossfade}
 
 Creates a smooth transition from one audio source edit to another. The crossfade has the first source \textit{fade out} while the second \textit{fades in}.
 
 \section{Video Transitions}%
 \label{sec:video_transition}
+\index{transitions!video}
 
 \subsection*{BandSlide}%
 \label{sub:bandslide}
+\index{band slide}
 
 Bands slide across video and you see the image slide.
 
 \subsection*{BandWipe}%
 \label{sub:bandwipe}
+\index{band wipe}
 
 Bands wipe across the video and you see the mask slides.
 
 \subsection*{Dissolve}%
 \label{sub:dissolve}
+\index{dissolve}
 
 A soft dissolve where the In segment becomes more transparent while the Out segment begins to gradually show in its place until fully there.
 
 \subsection*{Flash}%
 \label{sub:flash}
+\index{flash}
 
 The video flashes when transitioning between segments.
 
 \subsection*{IrisSquare}%
 \label{sub:irissquare}
+\index{iris square}
 
 Video switches segments via a small rectangular view that gradually grows to full size.
 
 \subsection*{Shape Wipe}%
 \label{sub:shape_wipe}
+\index{shape wipe}
 
 Wipe a specific shape across the video. Currently available 63 shapes are:
 
@@ -127,7 +143,9 @@ Next, there is a \textit{Feather} textbox with tumbler arrows or a slider bar to
 
 \begin{figure}[htpb] \centering
        \includegraphics[width=0.9\linewidth]{star.png}
-       \caption{Example of the Shape Wipe $\rightarrow$ Star}
+       \caption{Example of the Shape Wipe -> Star}
+%      do not use rightarrow in a figure as HTML version does not like it
+%      \caption{Example of the Shape Wipe $\rightarrow$ Star}
        \label{fig:star}
 \end{figure}
 
@@ -136,22 +154,25 @@ You can add your own images to the Shape Wipe transition and there are some free
 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}}.
+the equivalent png versions at {\small \url{https://cinelerra-gg.org/download/testing/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}
+\index{slide}
 
 Image slides into view; you can set Left/Right/In/Out.
 
 \subsection*{Wipe}%
 \label{sub:wipe}
+\index{wipe}
 
 Wipe the image across screen starting left or right.
 
 \subsection*{Zoom}%
 \label{sub:zoom}
+\index{zoom}
 
 Zoom out video at $\frac{X}{Y}$ magnification for some seconds.