more Andrea new images
[goodguy/cin-manual-latex.git] / parts / Plugins.tex
index d4d476fc09341146e3f1790cc6b8c63bb64d8fab..bbce5c8ff1513a76dfcb7473e766ebb5d177a398 100644 (file)
@@ -29,12 +29,12 @@ Note that when you change the plugin icons, your session will automatically save
     \centering
     \begin{tikzpicture}[scale=1, transform shape]
     \node (img1) [yshift=0cm, xshift=0cm, rotate=0] {\includegraphics[width=0.5\linewidth]{plugin-icons.png}};
-    \node [yshift=-8mm, xshift=-1cm,anchor=east] at (img1.north west) (Preferences) {Preferences Window};
-    \node [yshift=-17mm, xshift=-1cm,anchor=east] at (img1.north west) (Tab) {Tab section};
-    \node [yshift=-41mm, xshift=-1cm,anchor=east] at (img1.north west) (Icon) {Plugin icon choices};
-    \draw [->, line width=1mm] (Preferences) edge  ([yshift=-8mm] img1.north west);
-    \draw [->, line width=1mm] (Tab) edge  ([yshift=-17mm] img1.north west);
-    \draw [->, line width=1mm] (Icon) edge    ([yshift=-41mm] img1.north west);
+    \node [yshift=-6mm, xshift=-1cm,anchor=east] at (img1.north west) (Preferences) {Preferences Window};
+    \node [yshift=-14mm, xshift=-1cm,anchor=east] at (img1.north west) (Tab) {Tab section};
+    \node [yshift=-35mm, xshift=-1cm,anchor=east] at (img1.north west) (Icon) {Plugin icon choices};
+    \draw [->, line width=1mm] (Preferences) edge  ([yshift=-6mm] img1.north west);
+    \draw [->, line width=1mm] (Tab) edge  ([yshift=-14mm] img1.north west);
+    \draw [->, line width=1mm] (Icon) edge    ([yshift=-35mm] img1.north west);
     \end{tikzpicture}
     \caption{Screencast showing the screen to change your plugin icons set}
     \label{fig:plugin-icons}
@@ -128,19 +128,18 @@ In order to prevent the shared track from mixing the same data as the original t
 \end{wrapfigure}
 Note that using this is directly changing a keyframe object so you will only want to modify parameters you are familiar with. Most of the data is obvious and safe to change.
 
-A Presets button on the plugin bar to the left of the Controls and On/Off button allows for quick access to this feature. The symbol resembles a gear (figure~\ref{fig:preset02}).
-    %\todo{I can't to remedy}%
+A Presets button on the plugin bar to the left of the Controls and On/Off button allows for quick access to this feature. The symbol resembles a slider (figure~\ref{fig:preset02}).
 
 \begin{figure}[htpb]
     \centering
     \begin{tikzpicture}[scale=1, transform shape]
     \node (img1) [yshift=0cm, xshift=0cm, rotate=0] {\includegraphics[width=0.6\linewidth]{preset02.png}};
-    \node [yshift=-30mm, xshift=-1cm,anchor=east] at (img1.north west) (Green) {A user preset Green};
-    \node [yshift=-101mm, xshift=-1cm,anchor=south east,text width=10em, inner ysep=-3mm] at (img1.north west) (Textbox) {Textbox to type in the title for the chosen preset or name for a new preset.};
-    \node [yshift=-110mm, xshift=-1cm,anchor=north east,text width=10em,inner ysep=-3mm] at (img1.north west) (Save) {Use the Delete, Save or Apply button for operation.};
-    \draw [->, line width=1mm] (Green) edge  ([yshift=-30mm] img1.north west);
-    \draw [->, line width=1mm] (Textbox.south east) --  ([yshift=-101mm] img1.north west);
-    \draw [->, line width=1mm] (Save.north east) --    ([yshift=-110mm] img1.north west);
+    \node [yshift=-20mm, xshift=-1cm,anchor=east] at (img1.north west) (Green) {A user preset Green};
+    \node [yshift=-68mm, xshift=-1cm,anchor=south east,text width=10em, inner ysep=-3mm] at (img1.north west) (Textbox) {Textbox to type in the title for the chosen preset or name for a new preset.};
+    \node [yshift=-80mm, xshift=-1cm,anchor=north east,text width=10em,inner ysep=-3mm] at (img1.north west) (Save) {Use the Delete, Save or Apply button for operation.};
+    \draw [->, line width=1mm] (Green) edge  ([yshift=-20mm] img1.north west);
+    \draw [->, line width=1mm] (Textbox.south east) --  ([yshift=-68mm] img1.north west);
+    \draw [->, line width=1mm] (Save.north east) --    ([yshift=-80mm] img1.north west);
     \end{tikzpicture}
     \caption{Screencast shows 4 Factory presets as preceded by an *.}
     \label{fig:preset02}
@@ -154,11 +153,11 @@ These next few sections explain some details about the plugins that are not dire
 \subsection{How to see short Description of a Plugin}%
 \label{sub:short_description_plugin}
 
-To get a short one or a few lines description of a plugin, right click on that plugin in the Resources window and when the popup menu appears, select \textit{Info}. Some of the plugins may not have any description included. An example screenshot is next (figure~\ref{fig:info-effect}).
+To get a short one or a few lines description of a plugin, mouse over that plugin in the Resources window and a popup appears. You can disable the popup by right-clicking and choosing \textit{Info Off} (shortcut "i"). And again enable it with \textit{Info On}. Some of the plugins may not have any description included. An example screenshot is next (figure~\ref{fig:info-effect}).
 
 \begin{figure}[htpb]
     \centering
-    \includegraphics[width=0.7\linewidth]{info-effect.png}
+    \includegraphics[width=0.8\linewidth]{info-effect.png}
     \caption{Effect Info for Color 3 Way}
     \label{fig:info-effect}
 \end{figure}
@@ -322,7 +321,7 @@ Audio Effects
 \begin{figure}[htpb]
     \centering
     \includegraphics[width=0.8\linewidth]{expander.png}
-    \caption{$\bigtriangledown$, $\rhd$ =expander; "-" = options}
+    \caption{$\triangledown$,$\triangleright$ = expander; "-" = options}
     \label{fig:expander}
 \end{figure}
 
@@ -482,7 +481,7 @@ Graphic equalizer sets the output levels for specified frequency bands. This eff
 
 \begin{figure}[htpb]
     \centering
-    \includegraphics[width=0.7\linewidth]{equalizer.png}
+    \includegraphics[width=0.8\linewidth]{equalizer.png}
     \caption{Graphic Equalizer audio plugin}
     \label{fig:equalizer}
 \end{figure}
@@ -495,7 +494,7 @@ Parametric equalizer shows and outputs levels for \textit{frequency}, \textit{qu
 \begin{figure}[htpb]
        \centering
        \includegraphics[width=0.4\linewidth]{eq_param.png}
-       \caption{Graphic Equalizer audio plugin}
+       \caption{EQ Parametric audio plugin}
        \label{fig:eq_param}
 \end{figure}
 
@@ -553,7 +552,7 @@ The delay introduced consists of two distinct components: the \textit{constant d
 
 \begin{figure}[htpb]
        \centering
-       \includegraphics[width=0.5\linewidth]{flanger.png}
+       \includegraphics[width=0.6\linewidth]{flanger.png}
        \caption{GUI of configuration for Flanger plugin}
        \label{fig:flanger}
 \end{figure}
@@ -636,7 +635,7 @@ The configuration window (figure~\ref{fig:reverb}) shows a graph of the full ban
 
 \begin{figure}[htpb]
        \centering
-       \includegraphics[width=0.5\linewidth]{reverb.png}
+       \includegraphics[width=0.6\linewidth]{reverb.png}
        \caption{GUI of configuration for Reverb plugin}
        \label{fig:reverb}
 \end{figure}
@@ -759,7 +758,7 @@ Below is a screencast showing the auto start gui flag and the \texttt{LV2\_PATH}
 
 \begin{figure}[htpb]
     \centering
-    \includegraphics[width=0.9\linewidth]{reload.png}
+    \includegraphics[width=1.0\linewidth]{reload.png}
     \caption{Reload plugin index in yellow and Auto start lv2 gui unchecked}
     \label{fig:reload}
 \end{figure}
@@ -1185,7 +1184,7 @@ Together with \textit{Histogram Bezier / Curves} Color 3 Way is the main tool of
 
 \begin{figure}[htpb]
     \centering
-    \includegraphics[width=0.8\linewidth]{color3way.png}
+    \includegraphics[width=1.0\linewidth]{color3way.png}
     \caption{Color 3 Way control window}
     \label{fig:color3way}
 \end{figure}
@@ -1247,7 +1246,7 @@ color space  or range so that you can fix it.
 
 \begin{figure}[hbtp]
     \centering
-    \includegraphics[width=0.45\linewidth]{colorspace.png}
+    \includegraphics[width=0.6\linewidth]{colorspace.png}
     \caption{ColorSpace control window}
     \label{fig:colorspace}
 \end{figure}
@@ -1293,14 +1292,14 @@ Figure~\ref{fig:crikey01} and figure~\ref{fig:crikey02} shows how moving the Thr
 
 \begin{figure}[htpb]
     \centering
-    \includegraphics[width=0.8\linewidth]{crikey01.png}
+    \includegraphics[width=0.7\linewidth]{crikey01.png}
     \caption{The screenshot shows the compositor with some default settings in the controls window.}
     \label{fig:crikey01}
 \end{figure}
 
 \begin{figure}[htpb]
     \centering
-    \includegraphics[width=0.8\linewidth]{crikey02.png}
+    \includegraphics[width=0.7\linewidth]{crikey02.png}
     \caption{same screenshot with moving Threshold}
     \label{fig:crikey02}
 \end{figure}
@@ -1352,7 +1351,7 @@ Figure~\ref{fig:descratch01} shows a list of the parameter descriptions:
 
 \begin{figure}[htpb]
     \centering
-    \includegraphics[width=0.8\linewidth]{descratch02.png}
+    \includegraphics[width=0.5\linewidth]{descratch02.png}
     \caption{Various parameters of DeScratch}
     \label{fig:descratch02}
 \end{figure}
@@ -1565,7 +1564,7 @@ incorrect linearization, etc.
 \begin{figure}[htpb]
     \centering
     \includegraphics[width=1.0\linewidth]{gamma01.png}
-    \caption{settting \textit{Maximun} to $0.5900$}
+    \caption{settting \textit{Maximun} to $0.6900$}
     \label{fig:gamma01}
 \end{figure}
 
@@ -1640,7 +1639,7 @@ The histogram allows an immediate view of the contrast amplitude of an image wit
 
 \begin{figure}[htpb]
     \centering
-    \includegraphics[width=0.8\linewidth]{histogram.png}
+    \includegraphics[width=0.9\linewidth]{histogram.png}
     \caption{Master Histogram and RGB Histogram}
     \label{fig:histogram}
 \end{figure}
@@ -1667,7 +1666,7 @@ The input graph is edited by adding and removing any number of points. Click and
 
 \begin{figure}[htpb]
     \centering
-    \includegraphics[width=0.8\linewidth]{bezier.png}
+    \includegraphics[width=0.9\linewidth]{bezier.png}
     \caption{Histogram Bezier / Curves}
     \label{fig:bezier}
 \end{figure}
@@ -1702,7 +1701,7 @@ Curves are generally adjusted by introducing several control points, some to be
 
 \begin{figure}[htpb]
     \centering
-    \includegraphics[width=0.75\linewidth]{ex-bezier.png}
+    \includegraphics[width=0.8\linewidth]{ex-bezier.png}
     \caption{Gain Up/Down; clamp; S-Shaped curve and Luma Key}
     \label{fig:ex-bezier}
 \end{figure}
@@ -2265,15 +2264,15 @@ This plugin allows the user to manipulate an SVG (scalable vector graphics) imag
     \item[Out\_w/Out\_h]  The scaling is controlled by width and height as they are normal parameters to overlay.
 \end{description}
 
-Figure~\ref{fig:svg} shows the menu options plugin window and the SVG image in the Inkscape window.
-
 \begin{figure}[hbtp]
-    \centering
-    \includegraphics[width=1.0\linewidth]{svg.png}
-    \caption{Control window and Inkscape}
-    \label{fig:svg}
+       \centering
+       \includegraphics[width=1.0\linewidth]{svg.png}
+       \caption{Control window and Inkscape}
+       \label{fig:svg}
 \end{figure}
 
+Figure~\ref{fig:svg} shows the menu options plugin window and the SVG image in the Inkscape window.
+
 \subsection{Scale}%
 \label{sub:scale}
 
@@ -2304,8 +2303,8 @@ With the Scale Ratio plugin you can manipulate your video to maintain the pixel
 
 This plugin is designed to smooth out non-moving areas of a video clip (figure~\ref{fig:staveraging}).
 \vspace{2ex}
-\begin{wrapfigure}[20]{O}{0.4\linewidth}
-   % \vspace{-4ex}
+\begin{wrapfigure}[18]{O}{0.4\linewidth}
+   \vspace{-2ex}
     \includegraphics[width=0.9\linewidth]{staveraging.png}
     \caption{STA control window}
     \label{fig:staveraging}
@@ -2496,18 +2495,18 @@ This effect is basically a primitive \textit{luminance key} to produce a \textit
 \subsection{Time average}%
 \label{sub:time_average}
 
+\begin{wrapfigure}[18]{O}{0.35\linewidth}
+       \vspace{-2ex}
+       \includegraphics[width=0.9\linewidth]{timeaverage.png}
+       \caption{GUI for Time Average}
+       \label{fig:timeaverage}
+\end{wrapfigure}
+
 Time average is one effect which has many uses besides creating trail patterns of moving objects (figure~\ref{fig:timeaverage}).
 The main use is reducing noise in still images (or in the motionless parts of a video). Merely point a video camera at a stationary subject for $30$ frames, capture the frames, and average them using time average and you will have a high quality print. In floating point color models, time average can increase the dynamic range of low quality cameras.
 
 Inside the time average effect is an accumulation buffer and a divisor. A number of frames are accumulated in the \textit{accumulation} buffer and divided by the divisor to get the average (for $10$ accumulated frames the divisor is $10$). Because the time average can consume large amounts of memory, it is best applied by first disabling playback for the track, dropping the time average in it, configuring time average for the desired number of frames, and re-enabling playback for the track.
 
-\begin{figure}[hbtp]
-    \centering
-    \includegraphics[width=0.35\linewidth]{timeaverage.png}
-    \caption{GUI for Time Average}
-    \label{fig:timeaverage}
-\end{figure}
-
 \begin{description}
     \item[Frames count] this determines the number of frames to be accumulated in the accumulation buffer. Ranges from $1 to 1024$ frames.
     \item[Accumulate] this outputs the accumulation buffer without dividing it.
@@ -2667,7 +2666,7 @@ Figure~\ref{fig:title03}.
 
 \begin{figure}[hbtp]
     \centering
-    \includegraphics[width=0.9\linewidth]{title03.png}
+    \includegraphics[width=1.0\linewidth]{title03.png}
     \caption{Final result of the exemple}
     \label{fig:title03}
 \end{figure}
@@ -2696,7 +2695,7 @@ The Text Color window has several enhanced features as listed here and seen in f
 
 \begin{figure}[hbtp]
     \centering
-    \includegraphics[width=0.6\linewidth]{title04.png}
+    \includegraphics[width=0.7\linewidth]{title04.png}
     \caption{Screencast showing the Color Picker menu.}
     \label{fig:title04}
 \end{figure}
@@ -2747,18 +2746,18 @@ export BC_FONT_PATH=:/usr/share/fonts #(remove all fonts and then add /usr/shar/
 One last item of information about fonts that may lead to some confusion. The checkbox for Bold and Italic will occasionally be ghosted out if no bold or italic version of the selected font is available. This is no guarantee, but currently as good as it can get due to inconsistency in the creation of fonts. It is mostly just a hint. If boxes are checkmarked, but ghosted, you can not uncheck until you change to a font that does not ghost out the boxes. If you use the popup helper with the boxes checked, and attempt to keyin a font that does not have the bold/italic attribute as checked, the font will be considered illegal.
 Text: chars is output and updated to indicate the number of characters already used. The only limit to the number of characters based on a count of single $8\, bit$ characters is the available resources on the user computer available for \CGG{} use. Keep in mind that unicode or other special characters may consist of $2$ to $4$ $8\,bit$ bytes. Also, newlines are a character and any of the attributes you use count in the total. There is now a horizontal scroll bar as well as the vertical one in the textbox and they only appear when there are more lines or characters that can fit in the original sized textbox.
 
+\begin{figure}[hbtp]
+       \centering
+       \includegraphics[width=0.4\linewidth]{title05.png}
+       \caption{Kerning in action}
+       \label{fig:title05}
+\end{figure}
+
 \subsubsection*{Kerning}%
 \label{ssub:kerning}
 
 When using the Titler, kerning is applied in order to allow parts of a letter to go outside the standard sized letter box.  Kerning is the process of adjusting the space between individual letters.  It is not the same as proportional spacing.  In kerning, a bounding box is allowed to overlay another bounding box.  The philosophy here is to aim at the ability to have boxes overlap in order to make the letters look more visually appealing.  Bounding box and escapement are tracked separately.  In addition to adjusting individual letter spacing, the program will also expand the render box in order to have any parts of the letter extend outside the standard letter box.  Kerning is applied to any and all fonts (figure~\ref{fig:title05}).
 
-\begin{figure}[hbtp]
-    \centering
-    \includegraphics[width=0.5\linewidth]{title05.png}
-    \caption{Kerning in action}
-    \label{fig:title05}
-\end{figure}
-
 \subsection{Tracer}%
 \label{sub:tracer}
 
@@ -2771,6 +2770,13 @@ Tracer creates an outline around an object after a few points are designated, so
        \label{fig:tracer-01}
 \end{figure}
 
+\begin{figure}[hbtp]
+       \centering
+       \includegraphics[width=0.7\linewidth]{tracer-02.png}
+       \caption{Rug in the top picture is traced in order to black it out or replace later}
+       \label{fig:tracer-02}
+\end{figure}
+
 \begin{description}
        \item[New] to create a new point.
        \item[Up/Dn] to move highlighted point up or down.
@@ -2788,12 +2794,7 @@ Tracer creates an outline around an object after a few points are designated, so
 
 Be sure to uncheck \textit{Draw} and \textit{Drag} before rendering so that the lines do not show in the video output.
 
-\begin{figure}[hbtp]
-       \centering
-       \includegraphics[width=0.7\linewidth]{tracer-02.png}
-       \caption{Rug in the top picture is traced in order to black it out or replace later}
-       \label{fig:tracer-02}
-\end{figure}
+
 
 \subsection{Translate}%
 \label{sub:translate}
@@ -2938,7 +2939,7 @@ A corrected video image is shown in the bottom. Now the red and blue colors are
 
 \begin{figure}[hbtp]
     \centering
-    \includegraphics[width=0.7\linewidth]{yuvshift.png}
+    \includegraphics[width=0.8\linewidth]{yuvshift.png}
     \caption{Before and after YUVShift adjusting}
     \label{fig:yuvshift}
 \end{figure}
@@ -3268,9 +3269,6 @@ Figure~\ref{fig:stylize} show the images after adding the 6 various styles.
 
 \section[FFmpeg Audio and Video Plugins]{FFmpeg Audio and Video Plugins}%
 \label{sec:ffmpeg_audio_video_plugins}
-% FIXME not in the section
-% \protect\footnote{credit to WPfilmmaker for the Ffmpeg info
-% description lines taken from his contributed pdf}
 
 \CGGI{} currently comes with more than $140$ of the video plugins and $55$ of the audio plugins developed by the FFmpeg project {\small \url{www.ffmpeg.org}}. These plugins do not have a GUI with buttons like the rest of plugins, therefore to change settings it is necessary to change the variables by hand by highlighting the \textit{option}, typing a value in the \textit{Range} box, and then hitting the \textit{Apply} button. Many of these plugins provide tooltips at the bottom right corner of the window when the option is highlighted. A \textit{slider} bar and a \textit{dial} for numerical values can be used to easily vary the values which take effect immediately.
 
@@ -3303,7 +3301,7 @@ Some of the ffmpeg plugins are not usable with \CGGI{} due to input/output requi
 FFmpeg’s plugin guide is at the link:
 \href{https://ffmpeg.org/ffmpeg-filters.html}{ffmpeg-filters}.
 
-\subsection{FFmpeg Audio Plugins}%
+\subsection{FFmpeg Audio Plugins\protect\footnote{credit to WPfilmmaker}}%
 \label{sub:ffmpeg_audio_plugins}
 
 The following is a list of the integrated audio plug-ins.
@@ -3416,7 +3414,7 @@ The following is a list of the integrated audio plug-ins.
 \item [F\_volumedetect]~\\Detect audio volume.
 \end{description}
 
-\subsection{FFmpeg Video Plugins}%
+\subsection{FFmpeg Video Plugins\protect\footnote{credit to WPfilmmaker}}%
 \label{sub:ffmpeg_video_plugins}
 
 The following is a list of the integrated video plug-ins.
@@ -3653,8 +3651,6 @@ The following is a list of the integrated video plug-ins.
 
 \section[Rendered Effects]{Rendered Effects}%
 \label{sec:rendered_effects}
-% FIXME
-% \protect\footnote{This capability is going to be deleted in the future unless receive notification of need to keep}
 
 Besides the \textit{Realtime} effects, as has been described in the previous sections, another type of effect is performed on a section of the track and the result stored somewhere before it is played back. The result is usually pasted into the track to replace the original data. The rendered effects are not listed in the resources window but instead are accessed through the \texttt{Audio $\rightarrow$ Render effect and Video $\rightarrow$ Render effect} menu options. Each of these menu options brings up a dialog for the rendered effect. In the Select an effect dialog is a list of all the realtime and all the rendered effects. The difference here is that the realtime effects are rendered to disk and not applied under the track. Rendered effects apply to only one type of track, either audio or video. If no tracks of the type exist, an error pops up.