From: Good Guy <good1.2guy@gmail.com>
Date: Sat, 5 Nov 2022 18:07:51 +0000 (-0600)
Subject: add missing paragraph to Overlay plugin
X-Git-Tag: 2022-11~5
X-Git-Url: https://cinelerra-gg.org/git/?a=commitdiff_plain;h=72e4cf82f926e6936978e17c013fff54f4f154ac;p=goodguy%2Fcin-manual-latex.git

add missing paragraph to Overlay plugin
---

diff --git a/parts/Plugins.tex b/parts/Plugins.tex
index 511e031..42a954e 100644
--- a/parts/Plugins.tex
+++ b/parts/Plugins.tex
@@ -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}