Fixes from AndreaPaz
[goodguy/cin-manual-latex.git] / parts / Plugins.tex
index 4f6aa6d6119e8dd13c9d7091a4eaef16e6080b95..80b17ea30c39ec76606f875948a11979d58dcbfd 100644 (file)
@@ -1,7 +1,7 @@
 \chapter{Plugins}%
 \label{cha:plugins}
 
-There are realtime effects --- these are the most useful and probably all you will ever need - and rendered effects. The rendered effects are discussed separately in the Rendered Effects \todo{internal link 1}% 
+There are realtime effects --- these are the most useful and probably all you will ever need --- and rendered effects. The rendered effects are discussed separately in the Rendered Effects \todo{internal link 1}% 
 section. Effect plugins modify the track when played, according to how they are set, with no permanent storage of the output except when the project is rendered. There are many Plugins in Cinelerra-GG Infinity which are actually quite easy to use just by experimenting with them. The plugins are shown and selected from the \textit{Resources window} (figure~\ref{fig:video-plugins}). They are described in more detail later.
 
 \begin{figure}[htpb]
@@ -571,7 +571,7 @@ Ladspa effects are supported in realtime and rendered mode for audio. These audi
 export LADSPA_PATH=/usr/lib/ladspa
 \end{lstlisting}
 
-\section{Audio LV2 / Calf Plugins\protect\footnote{Optional Feature - OS dependent}}%
+\section[Audio LV2 / Calf Plugins]{Audio LV2 / Calf Plugins\protect\footnote{Optional Feature - OS dependent}}%
 \label{sec:audio_lv2_calf_plugins}
 
 LV2 is an open standard for audio plugins using a simple interface with extensions which add functionality to support audio software. These plugins were written by external developers and provide additional audio effects to Cinelerra audio without having to change Cinelerra every time. Because the LV2 plugins are separate from Cinelerra-GG Infinity, if one fails or does not perform as expected, cinelerra should stay running and you will have to contact the programmers responsible for that plugin for a fix.
@@ -647,7 +647,7 @@ For example:
     \label{fig:calf02}
 \end{figure}
 
-\section{Video Effects - Native\protect\footnote{credit to Andrea Paz for reviewing and numerous plugin descriptions and figures}}%
+\section[Video Effects --- Native]{Video Effects --- Native\protect\footnote{credit to Andrea Paz for reviewing and numerous plugin descriptions and figures}}%
 \label{sec:video_effects_native}
 
 \subsection{1080 to 480}%
@@ -1467,10 +1467,30 @@ Curves are used by introducing \textit{control points} simply with the left mous
 
 Curves are generally adjusted by introducing several control points, some to be kept fixed (as anchors) to prevent curve modification beyond them, and others to be dragged to make the desired correction. The power of the curves lies in being able to circumscribe a small interval at will and intervene only on this without involving the remaining parts of the frame. The precision with which you can work is such that you can almost arrive at a secondary color correction.
 
+\begin{figure}[htpb]
+        \centering
+        \includegraphics[width=0.75\linewidth]{images/ex-bezier.png}
+        \caption{Gain Up/Down; clamp; S-Shaped curve and Luma Key}
+        \label{fig:ex-bezier}
+\end{figure}
+
+
 The most used type of modification is to create a \textit{S curve}. There can be a lot of shapes that use the S curve; the simplest is to create a control point in the shadows, one in the midtones (anchors) and one in the highlights. Moving the highlight point upwards and the shadow point downwards increases the contrast, making the image sharper and improving the color rendering. With the type of \textit{linear} curve you can make hard adjustments, similar to the result of the use of \texttt{Color 3 Way}, even if this acts on the color wheel (Hue) while the curves act on individual RGB channels.
 
 The \textit{Polynomial} and \textit{Bézier} types introduce \textit{control handles} that allow for more sophisticated and smoother adjustments. The quality of the result is much better, but they require more experience for their optimal use. Extending the handles away from the control point increases the \textit{radius} of the curve at that point. By varying the angle of the handles we change the \textit{tangent} and thus the curvature of the curve below. The difference between Polynomial and Bézier lies in the underlying mathematics, but for practical purposes the use is similar.
 
+
+Some examples of the use of curves to demonstrate the variety of possible interventions (figure~\ref{fig:ex-bezier}):
+
+\begin{itemize}
+    \item Scale the image values by increasing the white point or decreasing the white point (gain up and gain down). 
+        You can decide the scaling value with the formula: $(Input \div Output) = Scale Factor$
+    \item Limit a value beyond a certain point of brightness (clamp to the value $0.587$ in the figure).
+    \item S-shaped curve to increase contrast without changing the black and white point (i.e. without \textit{clipping}).
+    \item Make a real \textit{Luma Key} by bringing a certain value of gray to $100\%$ (white) and lowering everything else to $0\%$ (black). The slope of the two sides indicates how much we want to fade the edges of the matte obtained.
+\end{itemize}
+
+
 \subsection{HolographicTV}%
 \label{sub:holographictv}