\subsubsection*{2. Media cut and paste operations}%
\label{ssub:media_cut_paste_operations}
-To create a media selection, highlight a region on the cinelerra media timeline, then use the main menubar or compositor/viewer edit panel to operate the clip cut, copy, or copy-keyframe menu buttons. This selection can then be pasted to a target selection on the timeline using the main menubar or compositor/viewer edit panel to operate the clip paste or paste-keyframe operation. Also, by using the resource window you can select the \textit{Clips} folder and right mouse the resources list box, then use the \texttt{Paste Clip} menu item to paste the selection to a named clip. Additionally, these methods work between running instances of cinelerra, which means you can move media clips between the cinelerra program instances. The clip data is also copied to the secondary clipboard buffer. This makes it possible to examine the clip content directly if so desired.
+To create a media selection, highlight a region on the Cinelerra media timeline, then use the main menubar or compositor/viewer edit panel to operate the clip cut, copy, or copy-keyframe menu buttons. This selection can then be pasted to a target selection on the timeline using the main menubar or compositor/viewer edit panel to operate the clip paste or paste-keyframe operation. Also, by using the resource window you can select the \textit{Clips} folder and right mouse the resources list box, then use the \texttt{Paste Clip} menu item to paste the selection to a named clip. Additionally, these methods work between running instances of Cinelerra, which means you can move media clips between the Cinelerra program instances. The clip data is also copied to the secondary clipboard buffer. This makes it possible to examine the clip content directly if so desired.
\subsubsection*{3. The older cut\_buffer method}%
\label{ssub:older_cut_buffer_method}
\begin{itemize}
- \item For text, if there is an active selection when a window closes, it uses \texttt{cut\_buffer0}. Normally when a paste is performed, the target window \textit{notifies} the selection owner to \textit{send it now} when you do a paste, but if the window has closed there is no source window, so no pasting. Some programs, like cinelerra, use \texttt{cut\_buffer0} as a fallback. This makes it possible to paste data from a closed window.
+ \item For text, if there is an active selection when a window closes, it uses \texttt{cut\_buffer0}. Normally when a paste is performed, the target window \textit{notifies} the selection owner to \textit{send it now} when you do a paste, but if the window has closed there is no source window, so no pasting. Some programs, like Cinelerra, use \texttt{cut\_buffer0} as a fallback. This makes it possible to paste data from a closed window.
\item To move media clip, data \texttt{cut\_buffer2} is used because it does not require the selection owner interface, and works simply and reliably. This buffer is not normally in use by other programs.
\end{itemize}
\subsection*{Final note}%
\label{sub:final_note}
-When a text selection is set, the selected text is redrawn using selected-highlight color when the textbox loses focus. This convenience feature shows the active text selection as you move the pointer to the new target window. When a new selection is set anywhere else on your screen, the current text selection will be redrawn using the inactive-highlight color as the textbox loses selection ownership. In most cinelerra themes, the drag selection text-highlight color is BLUE ($\#0000FF$), the selected-highlight color is SLBLUE ($\#6040C0$) -- really sort of purple, and the inactive-highlight color is MEGREY ($\#AFAFAF$).
+When a text selection is set, the selected text is redrawn using selected-highlight color when the textbox loses focus. This convenience feature shows the active text selection as you move the pointer to the new target window. When a new selection is set anywhere else on your screen, the current text selection will be redrawn using the inactive-highlight color as the textbox loses selection ownership. In most Cinelerra themes, the drag selection text-highlight color is BLUE ($\#0000FF$), the selected-highlight color is SLBLUE ($\#6040C0$) -- really sort of purple, and the inactive-highlight color is MEGREY ($\#AFAFAF$).
\section{Playing is Different than Seeking/Positioning!}%
\label{sec:playing_seeking_positioning}
Since some users prefer the insertion pointer to reflect the same as the Compositor a choice is available. For playing forward, there is a preference option which results in what looks like 1 was added to the frame displayed in the Compositor window. To enable this mode, check the box \texttt{Always show next frame}, and this will be saved to \texttt{.bcast5}. The option checkbox is in the \texttt{Settings $\rightarrow$ Preferences $\rightarrow$ Appearance} tab and when checked, any forward \textit{plays} in the Compositor window show the same frame as you would with a seek. Reverse plays and plays using a selection or In/Out pointers (with \texttt{Ctrl}) work the same as without this preference set. But you will no longer see the odd behavior where if you frame advance forward and then frame advance backward, the displayed frame does not change -- instead it will change and look more natural.
A color indicator that shows in the main track canvas timeline and the compositor timeline reminds the user which mode is currently active. The cursor in the compositor turns \textit{red} for default mode and \textit{white} for \textit{Always show next frame} mode. The top portion of the insertion cursor in the track canvas mirrors this, with red for default and white otherwise.
-Figure~\ref{fig:cursor01} using the default \textit{playing} method where the frame in the compositor is the one that was just played; in this case play was in the forward direction. Note that the insertion pointer in the main track canvas shows 01:20 but the compositor show 01:19 so you know what you last saw. Also, the cursor/cursor tops in both windows is red.\todo{I make copy/paste from your examples; but no arrow is displayed}
+Figure~\ref{fig:cursor01} using the default \textit{playing} method where the frame in the compositor is the one that was just played; in this case play was in the forward direction. Note that the insertion pointer in the main track canvas shows 01:20 but the compositor show 01:19 so you know what you last saw. Also, the cursor/cursor tops in both windows is red.
\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]{images/cursor01.png}};
- \node [yshift=-20mm, xshift=-1cm,anchor=east] at (img1.north west) (Compositor) {Red cursor in Compositor};
- \node [yshift=-26mm, xshift=-1cm,anchor=east] at (img1.north west) (Timeline) {red cursor in Timeline};
- \end{tikzpicture}
- \caption{"Default" mode with red cursors}
- \label{fig:cursor01}
+ \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]{images/cursor01.png}};
+ \node [yshift=-20mm, xshift=-1cm,anchor=east] at (img1.north west) (Compositor) {Red cursor in Compositor};
+ \node [yshift=-26mm, xshift=-1cm,anchor=east] at (img1.north west) (Timeline) {red cursor in Timeline};
+ \draw [->, line width=1mm] (Compositor) edge ([yshift=-20mm] img1.north west);
+ \draw [->, line width=1mm] (Timeline) edge ([yshift=-26mm] img1.north west);
+ \end{tikzpicture}
+ \caption{"Default" mode with red cursors}
+ \label{fig:cursor01}
\end{figure}
Figure~\ref{fig:cursor02} using the \textit{Always show next frame} method where the frame in the compositor is the same one that would have shown with a seek; in this case play was in the forward direction. Note that the insertion pointer in the main track canvas shows 01:20 and the compositor shows 01:20. Also, the cursor/cursor tops in both windows is white.
\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]{images/cursor02.png}};
- \node [yshift=-21mm, xshift=-1cm,anchor=east] at (img1.north west) (Compositor) {White cursor in Compositor};
- \node [yshift=-27mm, xshift=-1cm,anchor=east] at (img1.north west) (Timeline) {White cursor in Timeline};
- \end{tikzpicture}
- \caption{"Always show next frame" mode with white cursors}
- \label{fig:cursor02}
+ \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]{images/cursor02.png}};
+ \node [yshift=-21mm, xshift=-1cm,anchor=east] at (img1.north west) (Compositor) {White cursor in Compositor};
+ \node [yshift=-27mm, xshift=-1cm,anchor=east] at (img1.north west) (Timeline) {White cursor in Timeline};
+ \draw [->, line width=1mm] (Compositor) edge ([yshift=-21mm] img1.north west);
+ \draw [->, line width=1mm] (Timeline) edge ([yshift=-27mm] img1.north west);
+ \end{tikzpicture}
+ \caption{"Always show next frame" mode with white cursors}
+ \label{fig:cursor02}
\end{figure}
\subsection{Seeking Issues}%
The cause of the issue is that X11 is RGB only and it is used to draw the \textit{refresh frame}. So single step is always drawn in RGB. To make a YUV frame into RGB, a color model transfer function is used. The math equations are based on color\_space and color\_range. In this case, color\_range is the cause of the \textit{gray} offset. The \textit{YUV mpeg} color range is $[16..235]$ for Y, $[16..240]$ for UV, and the color range used by \textit{YUV jpeg} is $[0..255]$ for YUV.
+\begin{wrapfigure}[11]{O}{0.5\textwidth}
+ \vspace{-5ex}
+ \centering
+ \includegraphics[width=0.5\textwidth,keepaspectratio]{images/color.png}
+ \caption{Color space and Color range}
+ \label{fig:color}
+\end{wrapfigure}
+
The mpeg YUV color range $[16..235]$ looks sort of like an old TV if it is viewed on a display with jpeg range $[0..255]$. A common expression for the short \textit{mpeg} color range is \textit{compressed} color range. If you are using color compressed data with no display decompression, or using uncompressed data and the display is configured to use compression, the color range will appear \textit{squished} or \textit{stretched}, as too gray or too much contrast.
The \texttt{use X11 direct when possible} preference with X11 as your video driver, generally means that you value speed over color range. When you use this feature and the color range preference is mismatched, the color switch offsets will still appear. This is a personal choice solely for improved speed.
\item[YUV color range] default choice is JPEG, alternate is MPEG
\end{description}
-
-\begin{figure}[htpb]
- \centering
- \includegraphics[width=0.6\linewidth,keepaspectratio]{images/color.png}
- \captionsetup{labelformat=empty, textformat=empty}
- \caption[Color space and Color range]{No text}
- \label{fig:color}
-\end{figure}
-
\section{Simple Animation (Festival)}%
\label{sec:simple_animation_festival}
-This functionality was added to cinelerra by the original author to create simple animation. The file type for this animation is \textit{Scene}.
+This functionality was added to Cinelerra by the original author to create simple animation. The file type for this animation is \textit{Scene}.
To get started making a simple animated movie copy from the directory: \texttt{<cin\_path>/cinelerra/tests} the \texttt{text2movie} and \texttt{text2movie.xml}. You can see what this does via \texttt{File $\rightarrow$ Load\dots $\rightarrow$ text2movie.xml}. The file text2movie acts like a normal asset, except changes to it are immediately reflected on the timeline without reloading and the length is infinite. You can just edit the text2movie file to change the script. If the length of the movie increases, drag the right edit handle to extend the edit or use the pulldown \texttt{Edit $\rightarrow$ edit length}. There is one audio channel created for every character. The frame rate, sample rate, frame size, and camera angles are fixed. To see these values, right click on the asset and look at the \textit{Asset info}.
projects / goodguy / cin-manual-latex.git / blobdiff