add missing paragraph to Overlay plugin
authorGood Guy <[email protected]>
Sat, 5 Nov 2022 18:07:51 +0000 (12:07 -0600)
committerGood Guy <[email protected]>
Sat, 5 Nov 2022 18:07:51 +0000 (12:07 -0600)
parts/Plugins.tex

index 511e0313457c70d30d5640be5552714651821e97..42a954e78a7e6c2157fa48b45f4fcb17cc1bf9fe 100644 (file)
@@ -2522,7 +2522,8 @@ This effect makes video tracks appears as a painting. It can be controlled by \t
 \label{sub:overlay}
 \index{overlay video}
 
-This effect can combine several tracks by using the so called Overlayer. This is a basic internal device normally used by \CGGI{} to create the dissolve transitions and for compositing the final output of every track onto the output bitmap. The Overlayer has the ability to combine one or several image layers on top of a bottom layer. It can do this combining of images in several different (and switchable) output modes such as \textit{Normal}, \textit{Additive}, \textit{Subtractive}, \textit{Multiply} (Filter), \textit{Divide}, \textit{Max} and \textit{Replace}. For a detailed list refer to the on \hyperref[cha:overlays]{Overlays} chapter  -- PorterDuff.
+This effect can combine several tracks by using the Overlayer. This is a basic internal device normally used by \CGGI{} to create the dissolve transitions and for compositing the final output of every track onto the output bitmap. The Overlayer has the ability to combine one or several image layers on top of a "bottom layer". It can do this combining of images in several different (and switchable) output modes such as \textit{Normal}, \textit{Addition}, \textit{Subtract}, \textit{Multiply} (Filter), \textit{Divide}, \textit{Max} and \textit{Replace}. For a detailed list refer to the on \hyperref[cha:overlays]{Overlays} chapter  -- PorterDuff.
+
 
 The \textit{overlay} plugin enables the use of this Overlayer device in the middle of any plugin stack, opening endless filtering and processing possibilities. It is only useful as a \textit{shared plugin} (i.e.\ a multitrack plugin). To use the overlay plugin:
 
@@ -2533,6 +2534,14 @@ The \textit{overlay} plugin enables the use of this Overlayer device in the midd
     \item Manipulate the plugin parameters in Track A.
 \end{enumerate}
 
+In the Overlay plugin's parameter window you can choose the overlay order
+to select which track plays the role of the "bottom layer" and which plays the
+role of the "top layer". For some overlay modes this can make quite a
+difference, for example the top layer is subtracted from the bottom layer for
+"Subtract" mode. Also in the parameter window, you can choose on which of the tracks
+to overlay the combined output. (Hint: in most cases, you will want to mute
+the other track so you only see the combined output).
+
 \subsection{Perspective}%
 \label{sub:perspective}
 \index{perspective}