X-Git-Url: https://git.cinelerra-gg.org/git/?p=goodguy%2Fcin-manual-latex.git;a=blobdiff_plain;f=parts%2FEditing.tex;h=62c64281bdc9e7c709b67136f043e6fed4fdbd7b;hp=fa08674f653bb2801eb8d4d0caa3b04841a7efe3;hb=82f7f0c08c931927f5363ff9830301d9a6a931e3;hpb=c0e6a7c27df908759c54167cdcb63df2afebb565 diff --git a/parts/Editing.tex b/parts/Editing.tex index fa08674..62c6428 100644 --- a/parts/Editing.tex +++ b/parts/Editing.tex @@ -129,7 +129,9 @@ The 7 \textit{attributes} are described here next followed by the other availabl 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. + the armed tracks will be used as destination tracks. Note that disarming + a track does not prevent you from dragging or attaching an Effect/Plugin + onto a disarmed track - this is not considered an edit in this case. \end{description} \begin{description} @@ -160,7 +162,7 @@ The 7 \textit{attributes} are described here next followed by the other availabl simultaneously. Gang also causes Nudge parameters to synchronize across all the ganged tracks. \item[Master Track] Mark a track as \textit{master} serves when using \textit{Gang Channels} or \textit{Gang Media} mode. See \nameref{sub:displaying_tracks_ganged} -\item[Track Data Height] \index{track height} this up/down toggle symbol to the immediate right +\item[Track Data Height] \index{track!height} this up/down toggle symbol to the immediate right of the 5 attributes, is used to individually resize each track. This makes it very easy to temporarily expand or contract the size of that track either by clickin with the left mouse button or using the middle wheel up/down. @@ -182,7 +184,7 @@ by clickin with the left mouse button or using the middle wheel up/down. with the arm option enabled, the other faders should follow. Hold down the Shift key and drag a fader to center it on the original source value (0 for audio, 100 for video). -\item[Mixer] \index{mixer toggle} in the expanded patchbay for that track designates +\item[Mixer] \index{mixers!toggle} in the expanded patchbay for that track designates the multi-camera mixer mode. \item[Overlay mode] \index{overlay pulldown} in the expanded patchbay is used for porter-duff operations and is full explained in @@ -223,18 +225,18 @@ Press the Tab key while the cursor is anywhere over a track to toggle the track arming status. Press Shift-Tab while the cursor is over a track to toggle the arming status of every other track. -\paragraph{Automatic audio mappings} \index{audio map} Several convenience functions +\paragraph{Automatic audio mappings} \index{audio!map} Several convenience functions are provided for automatically setting the panning to several common standards. They are listed in the Audio menu. These functions only affect armed audio tracks. They are: \begin{description} -\item[Audio~$\rightarrow$~Map 1:1] \index{audio map 1:1} This maps every track to +\item[Audio~$\rightarrow$~Map 1:1] \index{audio!map 1:1} This maps every track to its own channel and wraps around when all the channels are allocated. It is most useful for making 2 tracks with 2 channels map to stereo and for making 6 tracks with 6 channels map to a 6 channel sound card. -\item[Audio~$\rightarrow$~Map 5.1:2] \index{audio map 5.1:2} This maps 6 tracks to 2 +\item[Audio~$\rightarrow$~Map 5.1:2] \index{audio!map 5.1:2} This maps 6 tracks to 2 channels. The project should have 2 channels when using this function. Go to \texttt{Settings $\rightarrow$ Format} to set the output channels to 2. This is most useful for down-mixing 5.1 audio @@ -262,7 +264,7 @@ not store high frequencies in most cases. \section{Manipulating Tracks}% \label{sec:manipulating_tracks} -\index{tracks pulldowns} +\index{track!pulldown} Tracks in \CGG{} either contain audio or video. There is no special designation for tracks other than the type of media they contain. @@ -303,7 +305,7 @@ are armed. the other tracks. \end{description} -The \textbf{Audio} \index{audio pulldowns} and \textbf{Video pulldowns} \index{video pulldowns} each contain an +The \textbf{Audio} \index{audio!pulldowns} and \textbf{Video pulldowns} \index{video!pulldown} each contain an option to add a track of their specific type. In the case of audio, the new track is put on the bottom of the timeline and the output channel of the audio track is incremented by one. In the case of @@ -313,15 +315,14 @@ on top of old tracks. \subsection{Displaying tracks: Ganged mode}% \label{sub:displaying_tracks_ganged} -\index{tracks: ganged mode} +\index{track!ganged mode} Often users working on media where Audio is the main focus, want all of a media's audio channels, whether stereo or 5:1 channels, to be treated as a single unit. They are more familiar with working with a DAW (Digital Audio Workstation software) and find that it takes extra work and a lot more care to have to individually manage audio tracks rather than have them automatically edited as a ganged group. -To get this capability, there is a \textit{Gang Tracks} \index{gang tracks toggle} toggle button on the main timeline controls to switch between 3 modes of working with multiple channels so that the tracks are automatically edited as a single unit. Operations affected include edits such as cuts, moving sections, and adding plugins. Group masters are marked by the \textit{Master Track} \index{master track} toggle in the patchbays \index{patchbay}. A track gang group begins on a master track, and extends to, but not including, the next master track. The 3 \textit{Gang Tracks} modes are: +To get this capability, there is a \textit{Gang Tracks} \index{gang tracks toggle} toggle button on the main timeline controls to switch between 3 modes of working with multiple channels so that the tracks are automatically edited as a single unit. Operations affected include edits such as cuts, moving sections, and adding plugins. In addition to letting you work on the tracks of a group as one, you also get a saving of space on the timeline that makes it easier to view and edit the tracks. Group masters are marked by the \textit{Master Track} \index{master track} toggle in the patchbays \index{patchbay}. A track gang group begins on a master track, and extends to, but not including, the next master track. The 3 \textit{Gang Tracks} modes are: \begin{enumerate} \item \textbf{Gang None:} this is the default mode and is the traditional way Cinelerra operates. If you never toggle the "Gang Tracks" button, everything operates normally as it always has. In this mode, the button icon looks like 3 tracks with $\dots$ on the end and all tracks are visible on the timeline. See figure~\ref{fig:gang-track-01} -\end{enumerate} \begin{figure}[htpb] \centering @@ -329,15 +330,7 @@ To get this capability, there is a \textit{Gang Tracks} \index{gang tracks toggl \caption{Gang None: only the video track is master. We see all tracks both master and non-master (default)} \label{fig:gang-track-01} \end{figure} - -\begin{enumerate}[start=2] - \item \textbf{Gang Channels:} in this mode, all \textit{Master Tracks} -are shown. The exception is when there is no -Master video, no Master audio or no Master subtitle track, in which case for -each the first track of video, audio, and subtitle will be shown. For users who -routinely switch the track order frequently, the patchbay has the \textit{Master Track} icon to set your own preference. -Stereo tracks, or 5:1 channels/any number of audio tracks, are drawn as 1 audio track for the purpose of making changes on that single track which are propagated to all of its other channel tracks automatically. This is the DAW-like mode. The \textit{Gang Tracks} button icon looks like 2 tracks and only the first video and first audio tracks will be shown. See figure~\ref{fig:gang-track-02} -\end{enumerate} + \item \textbf{Gang Channels:} in this mode, all \textit{Master Tracks} are shown. The exception is when there is no Master video, no Master audio or no Master subtitle track, in which case for each the first track of video, audio, and subtitle will be shown. For users who routinely switch the track order frequently, the patchbay has the \textit{Master Track} icon to set your own preference. Stereo tracks, or 5:1 channels/any number of audio tracks, are drawn as 1 audio track for the purpose of making changes on that single track which are propagated to all of its other channel tracks automatically. This is the DAW-like mode. The \textit{Gang Tracks} button icon looks like 2 tracks and only the first video and first audio tracks will be shown. See figure~\ref{fig:gang-track-02} \begin{figure}[htpb] \centering @@ -346,7 +339,6 @@ Stereo tracks, or 5:1 channels/any number of audio tracks, are drawn as 1 audio \label{fig:gang-track-02} \end{figure} -\begin{enumerate}[start=3] \item \textbf{Gang Media:} this mode only shows the \textit{Master Tracks} of the media but changes are propagated to the appropriate other related tracks (even if they are not visible). The \textit{Gang Tracks} button icon looks like a single track. See figure~\ref{fig:gang-track-03} \end{enumerate} @@ -359,7 +351,7 @@ Stereo tracks, or 5:1 channels/any number of audio tracks, are drawn as 1 audio The current \textit{Gang Tracks} mode is saved across sessions and will be saved in your project. Although most likely users will work in the \textit{Gang None} mode, users more familiar with DAW software will tend to use the \textit{Gang Channel}s mode. -More details ares described next about master tracks. Each patchbay has a \textit{Master Track} button on the extreme right of the patchbay. These mark which tracks of the media are master tracks. The span of tracks between the gang group masters are the gang track group. The master track toggles can be disabled/enabled as the user wishes to create the desired track groups. Normal file loads will mark the first stream of each file loaded as a master, if the media is loaded with insertion strategy of\textit{ Replace current project}, \textit{Replace current project and concatenate tracks} or \textit{Append in new tracks}. Frequently, editing is done on video, audio, or audio/video groups to maintain timeline synchronization. By grouping related tracks, this procedure is much more automatic. +More details are described next about master tracks. Each patchbay has a \textit{Master Track} button on the right of the patchbay. These mark which tracks of the media are master tracks. The span of tracks between the gang group masters are the gang track group. The master track toggles can be disabled/enabled as the user wishes to create the desired track groups. Normal file loads will mark the first stream of each file loaded as a master, if the media is loaded with insertion strategy of\textit{ Replace current project}, \textit{Replace current project and concatenate tracks} or \textit{Append in new tracks}. Frequently, editing is done on video, audio, or audio/video groups to maintain timeline synchronization. By grouping related tracks, this procedure is much more automatic. Previously existing projects created before the addition of ganged tracks, will have ALL tracks marked as master tracks and changing the \textit{Gang Tracks} button mode will have no effect. The user will have to properly designate which track is the master track and disabling the others in order to make use of the toggle modes. @@ -367,11 +359,12 @@ There are no restrictions on how you use this feature and there may be variation NOTES: \begin{itemize} - \item When in \textit{Gang Channels} or \textit{Gang Media} mode, if the first audio track is not disarmed, but any of its connected channel tracks are, the disarm of those channels are ignored and all channels are treated as being armed. This is to be consistent with the purpose of using this mode; the purpose being that any edits to the first master track are automatically propagated to all other channels. + \item When in \textit{Gang Channels} or \textit{Gang Media} mode, if the first audio track is not disarmed, but any of its connected channel tracks are, the disarm of those channels are ignored and all channels are treated as being armed. This is to be consistent with the purpose of using this mode; the purpose being that any edits to the first master track are automatically propagated to all other channels. \textit{Warning}: this behavior is contrary to the default of \CGG{} whereby an unarmed track never undergoes any alteration. This exception was made to mimic the behavior of DAWs, where the various channels of an audio track are combined into a single "line", and it makes no sense to talk about armed or unarmed channels. \item It may be better when using the \textit{Gang Channels} or \textit{Gang Media} mode to make any changes to the first audio channel to be automatically duplicated before reverting to the \textit{Gang None} mode to make other changes. Once you start changing individual channels (that is, audio tracks) so that they are no longer coordinated in their edits/plugins, it may be more difficult to switch back to \textit{Gang Channels} mode and get the desired results since the channels may no longer be lined up. - \item Gang modes should not be used with Multi-camera/Mixers because they have very specific -operational capabilities which are not compatible with the way that Ganging works. + \item Gang modes should not be used with Multi-camera/Mixers because they have very specific operational capabilities which are not compatible with the way that Ganging works. + \item Gang flags in the patchbay specifically when in \textit{Gang Channels} or \textit{Gang Media} modes will operate as set in the Master Track. For example, if when in \textit{Gang Channels} mode, you turn off “Play track” on the visible audio track, none of the associated channels (i.e. the other stereo or other 5 channels) will play. And if in \textit{Gang Media} mode, if you turn on “Play track” for the Master Track, all associated video and audio tracks will play unless you turned off “Play track” for some of the associated audio/video slave tracks which will not play. + \item When adding a Plugin/Effect in \textit{Gang Channels} or \textit{Gang Media} mode to the track, highlighted selected region, or In/Out pointers area via dragging the plugin from the Resources Window the plugin will be added on the master and all slave tracks. If using the Audio or Video pulldown, \textit{Attach Effect} option and you want to propagate the effect to all slave tracks, make sure that the checkbox for "Attach single standalone and share others" in the Dialog window is checked. However, currently when using the right mouse button (RMB) on the master track to \textit{Attach effect}, the effect will only be inserted on that track. \end{itemize} \section{Two Screen Editing}% @@ -395,7 +388,7 @@ using the main menu \textbf{File pulldown} and choose \textit{Load timeline stays unchanged while new resources are brought in. Go to the Resources window \index{resources window} and select the Media folder. The newly loaded resources will appear. Double click on a resource or drag it from -the media side of the window over to the Viewer window \index{viewer window}. +the media side of the window over to the Viewer window \index{viewer!window}. Check to make sure there are enough armed tracks on the timeline to put the subsections of source material that you want. Usually this @@ -550,7 +543,7 @@ button to cut it. Move the insertion point to another point in the timeline and select the paste button. Assuming no In/Out points are defined on the timeline this performs a cut and paste operation. -Most editing operations are listed in the \textit{Edit} pulldown \index{edit pulldown}. Some of +Most editing operations are listed in the \textit{Edit} pulldown \index{edit!pulldown}. Some of them have a button on the program control toolbar as well as a keyboard shortcut. The keyboard shortcut is in parenthesis here. @@ -655,7 +648,7 @@ two edits. In order to have the video and audio aligned, it works best to have \texttt{Settings $\rightarrow$ Align cursor on frames} \index{align cursor on frames}. When a blade cut occurs, the edges are created as \textit{hard edges}. \index{hard edge} These are edges that cannot be deleted by -track optimizations \index{timeline optimization}. +track optimizations \index{timeline!optimization}. % \CGG{} has built-in optimization on the timeline. So that whenever two parts on the timeline are sequential frames, it automatically @@ -700,7 +693,7 @@ Resources window \index{resources window}. \begin{enumerate} \item Create some video and audio tracks on the timeline using - the \textit{Video} \index{video pulldown} and \textit{Audio} \index{audio pulldown} pulldowns. + the \textit{Video} \index{video!pulldown} and \textit{Audio} \index{audio!pulldown} pulldowns. \item Open the Media folder in the Resources window. Make sure the necessary tracks are armed and drag a media file from the Resources window to the timeline \index{timeline}. If the media has video, drag it @@ -777,13 +770,13 @@ pulldown to view the list and their keyboard shortcuts. \subsection{Copy/Paste Behavior}% \label{sub:copy_paste_behavior} -\index{drag and drop: MMB options} +\index{drag and drop!MMB options} There are many options for moving, copying, pasting, inserting, and deleting selected \textit{edits}, more commonly referred to by the user as \textit{clips}, when in the Drag and Drop (arrow) editing mode. This makes it easier to avoid constantly having to disarm/arm -tracks. To create a selection \index{edits selection} move the cursor over the clip and +tracks. To create a selection \index{edit!selection} move the cursor over the clip and just click the left mouse button; remove a selection by left mouse button click again. This will mark your selection with a colored border which contains some red. The easiest way to initially use @@ -907,7 +900,7 @@ transition does not drag. \label{syb:snapping_cutting_dragging} \index{snap} -\paragraph{Cutting/Snapping edits} \index{edits: cut with snap} cuts from an edit handle to the +\paragraph{Cutting/Snapping edits} \index{edit!cut with snap} 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. @@ -939,7 +932,7 @@ following keyboard shortcuts to perform the same functions: \end{tabular} \end{center} -\paragraph{Drag Snapping} \index{edits: drag with snap} if you hold down the Ctrl + Alt keys while +\paragraph{Drag Snapping} \index{edit!drag with snap} if you hold down the Ctrl + Alt keys while dragging using the mouse, once the clip gets near to an edit, a label, an in/out pointer or the start/end of the timeline, the dragged clip will snap next to that marker. The 2 will now be @@ -973,7 +966,7 @@ Steps to copy from a source timeline and paste to a target timeline: \subsection{Grouping edits}% \label{sub:grouping_edits} -\index{edits: grouping} +\index{edit!grouping} \CGG{} recognizes as a group, the edits of different armed tracks that have aligned beginnings, regardless of whether they have the @@ -984,7 +977,7 @@ same positions the edit the mouse pointer is currently over. Another method of Grouping of edits is performed as follows: \begin{enumerate} -\item Select \index{edits selection} each of the clips you would like to be part of a +\item Select \index{edit!selection} each of the clips you would like to be part of a group. \item Use the desired Copy mode as described above to get into the buffer. @@ -1025,10 +1018,10 @@ different Group Id and a different color. \subsection{Dragging Groups}% \label{sub:dragging_groups} -\index{edits: dragging group} +\index{edit!dragging group} Dragging while in \textit{Drop and Drag editing mode} (arrow mode) -is really easy. Just select \index{edits selection} the clip or clips you want to drag +is really easy. Just select \index{edit!selection} the clip or clips you want to drag using the left mouse button, then put your cursor over one of them and drag while holding down the left mouse button. Keyframes, autos, labels, and plugins will also be dragged. Dragging honors @@ -1079,7 +1072,7 @@ to drag clips together that are not columnated. \subsection{Selection Methods}% \label{sub:selection_method} -\index{edits selection} +\index{edit!selection} \index{active region} Concerning \textit{Selection} methods, the following information is @@ -1106,7 +1099,7 @@ have a position on the timeline which can be used for editing. This is input for the vertical style cut/paste drag/drop editing. More recently, in addition to the column oriented timeline drag -selection, there is now \textit{group} \index{edits: grouping} capabilities which have +selection, there is now \textit{group} \index{edit!grouping} capabilities which have various \textit{edit} selections. These are created in the Drag and Drop editing mode by clicking edits to toggle select/deselection. These groups are input to a different (more @@ -1154,7 +1147,7 @@ If using certain operating systems (for example Ubuntu and Arch) that might fiel \item Release the Alt key \end{enumerate} -\section{Inter-View Mode\;/\;Identifying Source Targets}% +\section{Inter-View Mode -- Identifying Source Targets}% \label{sec:inter-view_identifying_source_target} \index{inter-view} @@ -1183,6 +1176,11 @@ Inter-View mode mapping preview mini-window. \label{fig:inter-view01} \end{figure} +There is a second usage of Inter-View mode that can be helpful if +some tracks have become misaligned, such as in the case of 2 audio +channels no longer being in sync. You can use this mode to get them +back in alignment. + Explanation of how to use Inter-View mode will be described here next. @@ -1219,7 +1217,7 @@ confusion in the display. \item Ctrl-click on the bottom bar and the timeline and composer are re-positioned to the beginning of that edit. \item Shift-click on the bottom bar and a \textit{selection} is - made of that section in the timeline and the composer is updated + made of that section in the timeline and the compqoser is updated with that start position. \end{itemize} @@ -1248,7 +1246,7 @@ not for Proxy. \subsection{Edit Length}% \label{sub:edit-lenght} -\index{edit length} +\index{edit!length} To set the length of an edit in the timeline, select the region which contains the edit to be modified. Now select the menu bar @@ -1400,11 +1398,11 @@ You can create as many Viewer windows as you want in \CGG{}. These are handy fo \label{fig:multi-view01} \end{figure} -\section[ShuttlePROv2 and ShuttleXpress Jog Wheels for Editing]{ShuttlePROv2 and ShuttleXpress Jog Wheels for Editing\protect\footnote{programmatic specifications from Eric Messick}}% +\section[ShuttlePROv2 and ShuttleXpress Jog Wheels for Editing]{ShuttlePROv2 and ShuttleXpress Jog Wheels for Editing}% \label{sec:shuttle_jog_wheels_editing} \index{shuttle pro v2 and shuttlexpress} -The ShuttlePROv2 and ShuttleXpress are affordable jog wheels which +The ShuttlePROv2 and ShuttleXpress are affordable jog wheels\protect\footnote{programmatic specifications from Eric Messick} which can be useful for working with Cin, especially if you do a lot of playing forward/backward, fast/slow/normal, and single frames (figure~\ref{fig:shuttle}). @@ -1811,7 +1809,10 @@ cat "/sys/kernel/debug/hid/0003:0B33.0030.0006/events" # press keys to see the The following is the default setting for the ShuttlePROv2 and ShuttleXpress (table~\ref{tab:shuttleprov2} and -table~\ref{tab:xpress}): +table~\ref{tab:xpress}). This page can be quickly requested from \CGG{} by +pressing both the left and right Alt keys on the keyboard followed by pressing +any button on the Shuttle. To cancel this mode, press any single modifier key +(\texttt{Alt, \texttt{Ctrl}} or Shift) once. \renewcommand{\arraystretch}{1.15} \begin{table}[ht]