Update Blend Algebra/Program plugin references

diff --git a/parts/Developer.tex b/parts/Developer.tex
index ad804988f4fcdc617da8b84bd93635f7ec01be16..c9f52f3ba71af2de7e76cee81401055fd1a05fca 100644 (file)
--- a/parts/Developer.tex
+++ b/parts/Developer.tex
@@ -1059,7 +1059,8 @@ suffix) as a reference of the modifications done by the user.
 \section{Unique Blend plugins workflow}
 \label{sec:ba_bp_workflow}
 
-The uniqueness of the Blend Algebra/Blend Program plugins, different then most of the other plugins, provides a universal tool for creating new effects and may be handy in unexpected cases. It allows the programmer to more quickly test different combinations without spending time to restart \CGG{}, recompile it, reload your project, reattach plugins, and so on.
+The uniqueness of the Blend Algebra/Blend Program plugins, different then most of the other plugins, provides a universal tool for creating new effects and may be handy in unexpected cases.
+These 2 plugins provide the advanced feature of combining and modifying color pixels and transparencies of several tracks according to a mathematic algorithm written entirely by the user in the form of compact and simple piece of code. Such user defined algorithms (blend functions) are compiled, dynamically linked and immediately executed inside \CGG{} on the fly without the need to restart the application, reload the project, reattach plugins, and so on.
 Because of this uniqueness, the Blend Algebra and Blend Program plugins workflow is documented here to explain how they work. Additional helpful information for developers can be found in the section on the Blend Algebra/Blend Program plugins themselves at \nameref{sub:blend_algebra}. You will most likely need to read parts to get a better understanding.
 
 \subsection{Preparation phase}%

diff --git a/parts/Overlays.tex b/parts/Overlays.tex
index f925763bc7ef64dee8eeb2340f1be160c8847292..dbfb147898335c3b58f58f29992d2c47fc097101 100644 (file)
--- a/parts/Overlays.tex
+++ b/parts/Overlays.tex
@@ -145,6 +145,7 @@ Some notable items that affect the results are listed here.
        \item If comparing results with the original Cinelerra version for Subtract and Divide, you may have to switch the order of the source and destination tracks to see the same output. If you do not want to switch tracks, you can use the \textit{overlay} plugin as shared and change the Layer order and/or Output layer. The reason for having to switch tracks to get equivalent output is because of differences in the math formulas used.  Subtract exactly matches the original Cinelerra version if you switch the 2 tracks; Divide matches in one order only.
        \item Instead of using the patchbay overlays, you may prefer to use the \textit{overlay} plugin instead.
        \item If you see undesirable results, always check under Settings->Format and check your Color Model as that will vary or interfere with the look.
+       \item There are Gimp-like options for Addition, Subtraction, Divide and Multiply available through the use of the Blend Algebra plugin as documented with accompanying programs \href{https://cinelerra-gg.org/download/testing/BlendPluginExamples/gimp\_.zip}{here}.  To use, reference the section \nameref{sub:blend_algebra}. 
 \end{enumerate}
 
 % Leave the word Group in due to latex2html dual name conflict

diff --git a/parts/Plugins.tex b/parts/Plugins.tex
index 964c59e3f809e847863166a54d9060834db8082e..a04852c99c84d27ab3dcc491f75cf6f8f17edd86 100644 (file)
--- a/parts/Plugins.tex
+++ b/parts/Plugins.tex
@@ -967,6 +967,8 @@ Automatically scale to a specified size.
 \label{sub:blend_algebra}
 \index{blend algebra}
 
+The Blend Algebra/Blend Program plugins provide the advanced feature of combining and modifying color pixels and transparencies of several tracks according to a mathematic algorithm written entirely by the user in the form of compact and simple piece of code. Such user defined algorithms (blend functions) are compiled, dynamically linked and immediately executed inside \CGG{} on the fly without the need to restart the application, reload the project, reattach plugins, and so on.
+
 The following description is based on the \texttt{~/cinelerra-5.1/doc/README.blendalg} that accompanies the code by the author of both the code and the document.  It is the authoriative documentation; the most detailed/original source and has additional commentary and programming information. If you encounter problems or confusion when using these plugins, always refer directly to that document \href{https://cinelerra-gg.org/download/testing/BlendPluginExamples/README.blendalg}{here}.  If running \CGG{} from an \textit{AppImage}, testing has shown that it should work  as well as if run from a build - just be aware of filename extensions that appear by default in the input field for the funtion name and change them accordingly.
 
 The idea behind these plugins\protect\footnote{credit to Georgy} is that the user can program sufficiently short and simple blending algorithms, called \textit{Functions}, by following detailed instructions with very little programming skills required.
@@ -1330,6 +1332,7 @@ The current implementation should be portable as long as you have a working C co
 
 NOTE: For developers who want to take advantage of creating a plugin to generate an effect in the same manner as Blend Algebra/Blend Program, please reference \nameref{sec:ba_bp_workflow}. This methodology makes it easier for the programmer to more quickly test different combinations without spending time to restart \CGG{}, recompile it, reload your project, reattach plugins, and so on.
 
+
 \subsection{Blue Banana}%
 \label{sub:blue_banana}
 \index{blue banana}