From: Good Guy Date: Sun, 8 Aug 2021 23:25:35 +0000 (-0600) Subject: minor changes for clarification X-Git-Tag: 2021-08~7 X-Git-Url: https://cinelerra-gg.org/git/?a=commitdiff_plain;h=ca6c9ca2def538d58143f0b7c07b7a5bcea7c241;p=goodguy%2Fcin-manual-latex.git minor changes for clarification --- diff --git a/parts/Editing.tex b/parts/Editing.tex index 2f73e60..93a6a27 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} @@ -378,6 +380,11 @@ operate as set in the Master Track. For example, if when in \textit{Gang Channe 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}% diff --git a/parts/Plugins.tex b/parts/Plugins.tex index 18ca71e..026f6f2 100644 --- a/parts/Plugins.tex +++ b/parts/Plugins.tex @@ -44,7 +44,7 @@ Note that when you change the plugin icons, your session will automatically save \section{How to Use Plugins}% \label{sec:how_use_plugins} -\textit{Realtime} effect plugins are listed in the Resources window as \textit{Audio} Effects and \textit{Video} Effects. Effect plugins are used by dragging them from the Resources window onto an audio track if it is an audio effect or video track if it is a video effect. You will see a colored bar \index{plugins!toolbar} appear beneath the track with the plugin name on it. If there is data on the destination track, the effect is applied to the entire track, unless a edit or a region of the track is selected in which case the effect is pasted into that region only. If there is no data on the track the effect is not added. +\textit{Realtime} effect plugins are listed in the Resources window as \textit{Audio} Effects and \textit{Video} Effects. Effect plugins are used by dragging them from the Resources window onto an audio track if it is an audio effect or video track if it is a video effect. You will see a colored bar \index{plugins!toolbar} appear beneath the track with the plugin name on it. If there is data on the destination track, the effect is applied to the entire track, unless a edit or a region of the track is selected in which case the effect is pasted into that region only. If there is no data on the track or no selected region set, the effect is not added. Plugins are layered under the track they apply to. When dragging more than one effect onto a track, you will see the effects layering from \textit{top to bottom}, on the bottom of that track. When the track is played back, effects are processed from \textit{top to bottom}. The output of the top effect becomes the input of the bottom effect and so on. "The pipeline in Cinelerra's\protect\footnote{credit to Original Creator} plugin design is the \textit{pull} method. The rendering pipeline starts at the final output and the final steps in the rendering pipeline are reading the data from disk. Every step in the rendering chain involves requesting data from the previous step. When the rendering pipeline eventually requests data from a plugin chain, each plugin requests data from the plugin before it. This is less intuitive than the push method but is much more powerful. Realtime plugins written using the pull method can change the rate data is presented to the viewer and the direction of playback. The pull method allows plugins to take in data at a higher rate than they send it out." Side note: if you want to avoid the automatic \textit{top to bottom} application of plugins, you can take advantage of \textit{nested assets} to manipulate the order the plugins are applied (see @@ -52,6 +52,8 @@ plugins, you can take advantage of \textit{nested assets} to manipulate the orde Instead of dragging from the Resources window, effects may be applied to a track via a popup menu. Right click on a track and select \textit{Attach effect} \index{plugins!attch effect} from the popup. The attach effect dialog gives you more capability than just dragging and dropping. For example, the attach effect dialog lets you attach two more types of effects: \textit{shared effects} and \textit{shared tracks} which are explained in a later section. Select a plugin from the Plugins column and hit the green colored checkmark under the plugins column to attach it. The result is the same as if the effect was dragged from the Resources window. + +One more method to apply an effect is to use the Video or Audio pulldown \textit{Attach Effect} option. This brings up a menu which has a useful checkbox to \textit{Attach single standalone and share others} (see \ref{sec:shared_effect_tracks}). The default setting is checked on. After attaching an effect to a track, it often needs to be configured. There are two ways to get to the configuration controls. Click on the magnifying glass \index{plugins!show controls} symbol on the right side of the effect bar -- this is the middle symbol on the bar as you can see in the picture below. Alternatively, you can right click on the effect bar to bring up the effect popup which has a \textit{Show} option. Either method causes the GUI for the effect to appear in a separate window. There will not be a popup if the plugin has no GUI.