Videoscope update by Andrea and some minor changes

diff --git a/images/compositor_window.png b/images/compositor_window.png
index b5b3e525893876a5bcd72e308cce864385a2dd16..20299e15f473570eeec19855f969b1cbec05d3d9 100644 (file)
Binary files a/images/compositor_window.png and b/images/compositor_window.png differ

diff --git a/images/timebar1.png b/images/timebar1.png
index edc474140935cd431929db4f12175340f289c8ca..9c8603f7be453cdaf0e0ce68a4a2b804cd961590 100644 (file)
Binary files a/images/timebar1.png and b/images/timebar1.png differ

diff --git a/images/timebar2.png b/images/timebar2.png
index 43622c299184a14b4c4a1b0015ebae64dbd41727..325f9c445856502cc759aebc891b02335fef6895 100644 (file)
Binary files a/images/timebar2.png and b/images/timebar2.png differ

diff --git a/images/timebar3.png b/images/timebar3.png
index bf26361eec449bfd8cf1c52bb6bc96c9549eace7..741ad5361c768cd2fb0966a0f46d438fafd0e492 100644 (file)
Binary files a/images/timebar3.png and b/images/timebar3.png differ

diff --git a/images/timebar4.png b/images/timebar4.png
index 630b4443eb027e59b61170f11589ff4e00c2658a..c78281bb264fa1a5a103d05d053cdf01e3aacddf 100644 (file)
Binary files a/images/timebar4.png and b/images/timebar4.png differ

diff --git a/images/videoscope01.png b/images/videoscope01.png
index 637c20afa263ff512f075a5d3d90a1e7e59f754f..8a8d38428fc16832cc7a725ef493baa64d39b7de 100644 (file)
Binary files a/images/videoscope01.png and b/images/videoscope01.png differ

diff --git a/images/videoscope02.png b/images/videoscope02.png
index 2b4bf716e9a77d5bcd9b208b78c88f8ff07378cc..fc35a1e5d092c171def310bdc4f3c477e5f0b947 100644 (file)
Binary files a/images/videoscope02.png and b/images/videoscope02.png differ

diff --git a/images/videoscope03.png b/images/videoscope03.png
index 18ff78d596919c7757d58092039f0ce09b7f5be1..a8fed2471142e672347e6a20bae15774dadb1982 100644 (file)
Binary files a/images/videoscope03.png and b/images/videoscope03.png differ

diff --git a/images/videoscope05.png b/images/videoscope05.png
new file mode 100644 (file)
index 0000000..ac77df8
Binary files /dev/null and b/images/videoscope05.png differ

diff --git a/images/viewer_window.png b/images/viewer_window.png
index 7257b7a209c2e5c8e11648a298ced943965f7e6b..5f9101496f568b415a747d1b9edb9b32a45980db 100644 (file)
Binary files a/images/viewer_window.png and b/images/viewer_window.png differ

diff --git a/parts/Introduction.tex b/parts/Introduction.tex
index 475f8aaf94c266ea48e009aa2904e7da34309edf..114060ec56ce179e171692d2e67e0d46ffcdd8e1 100644 (file)
--- a/parts/Introduction.tex
+++ b/parts/Introduction.tex
@@ -128,6 +128,8 @@ programmers.
                     \item Title plugin virtually unlimited script size with many changeable attributes such as size, blink, color.
                     \item Motion Graphics using the Sketcher plugin to create elements such as ellipses, rectangles and shapes for simpler motion graphics.
                     \item Open EDL for editing clips, nested clips, and xml files while working on a Project.
                     \item Title plugin virtually unlimited script size with many changeable attributes such as size, blink, color.
                     \item Motion Graphics using the Sketcher plugin to create elements such as ellipses, rectangles and shapes for simpler motion graphics.
                     \item Open EDL for editing clips, nested clips, and xml files while working on a Project.

+                    \item The Vectorscope option in the Videoscope plugin allows for the use of any number
+of user-supplied grid patterns as an Overlay.

                 \end{itemize}
 \end{description}
 
                 \end{itemize}
 \end{description}
 

diff --git a/parts/Plugins.tex b/parts/Plugins.tex
index 74023261a74288f254bcc8852de50470bf8e8448..ce576fe6eddf73efba77e1fb90a6712d5f4d6cd5 100644 (file)
--- a/parts/Plugins.tex
+++ b/parts/Plugins.tex
@@ -2857,35 +2857,36 @@ This effect applies a traditional \textit{darkroom} technique, the so called \te
 \subsection{Videoscope}%
 \label{sub:videoscope}
 
 \subsection{Videoscope}%
 \label{sub:videoscope}
 

-Videoscope summarizes intensity and color on a calibrated display. The Videoscope can be used in conjunction with other \CGG{} plugins such as \textit{Color 3 Way}, \textit{YUV}, \textit{Brightness}, \textit{Color Balance} or \textit{Histogram} to accurately correct video for contrast, clarity, conformance (to normalize various videos shot under different light settings), or for cinematic purposes. The human eye is not specialized to match precise level of light and color, but Videoscope is. Videoscope contains three displays: the waveform scope and the vectorscope, plus the histograms (figure~\ref{fig:videoscope01}).
+Videoscope summarizes intensity and color on a calibrated display. The Videoscope can be used in conjunction with other \CGG{} plugins such as \textit{Color 3 Way}, \textit{YUV}, \textit{Brightness}, \textit{Color Balance} or \textit{Histogram} to accurately correct video for contrast, clarity, conformance (to normalize various videos shot under different light settings), or for cinematic purposes. The human eye is not specialized to match precise level of light and color, but Videoscope is. Videoscope contains three displays: the waveform scope and the vectorscope, plus the histograms (figure~\ref{fig:videoscope01}). Instead of applying the plugin to the tracks/edits we want to examine, we can use the Videoscope button in the Composer and Viewer windows. The Videoscope menu window has many options. From the pulldown menu (\textit{Scopes}) we can choose between two histograms (Histogram and Histogram RGB); three waveforms (Waveform, Waveform RGB and Waveform Ply) and two vectorscopes (Vectorscope and VectorWheel). The \textit{Smooth} checkbox serves to make the graph more homogeneous while the \textit{sliders} allow for varying the 'solidity' of the dots shown. You can get to the subpixel
+level for precision.

 
 \begin{figure}[hbtp]
     \centering
 
 \begin{figure}[hbtp]
     \centering

-    \includegraphics[width=0.8\linewidth]{videoscope01.png}
+    \includegraphics[width=1.0\linewidth]{videoscope01.png}

     \caption{GUI of the Videoscope. You see Histogram, RGB Parade and Vectorscope}
     \label{fig:videoscope01}
 \end{figure}
 
     \caption{GUI of the Videoscope. You see Histogram, RGB Parade and Vectorscope}
     \label{fig:videoscope01}
 \end{figure}
 

-\subsubsection*{Waveform/RGB Parade}%
-\label{ssub:waveform_rgb_parade}
+\subsubsection*{Waveform/RGB Parade/Waveform Ply}%
+\label{ssub:waveform_rgb_parade_ply}

 
 

-The \textit{Waveform Scope} displays image intensity (luminance) versus image $X$ position. The \textit{RGB Parade Scope} displays image RGB intensity versus image $X$ position (one graph per channel). The Waveform Scope appears on the left side or in the middle of the Videoscope window. The display is calibrated vertically from $0\%$ intensity (black) at the bottom up to $100\%$ intensity (white) at the top. Each column of pixels in the image corresponds to one column of pixels in the Waveform Scope (figure~\ref{fig:videoscope02}). Note that the height of the values of a waveform/RGB Parade corresponds exactly to the values on the $x\, axis$ in the \textit{histogram}. A vertical/horizontal correspondence is therefore obtained.
+The \textit{Waveform Scope} displays image intensity (luminance) versus image $X$ position. The \textit{Waveform RGB} (or RGB Parade) displays image RGB intensity versus image $X$ position (one graph per channel). The \textit{Waveform Ply} shows the three channels in a single graph. The Waveform Scope appears on the left side or in the middle of the Videoscope window. The display is calibrated vertically from $0\%$ intensity (black) at the bottom up to $100\%$ intensity (white) at the top. Each column of pixels in the image corresponds to one column of pixels in the Waveform Scope (figure~\ref{fig:videoscope02}). Note that the height of the values of a waveform/RGB Parade corresponds exactly to the values on the $x\, axis$ in the \textit{histogram}. A vertical/horizontal correspondence is therefore obtained.

 
 \begin{figure}[hbtp]
     \centering
 
 \begin{figure}[hbtp]
     \centering

-    \includegraphics[width=0.9\linewidth]{videoscope02.png}
+    \includegraphics[width=1.0\linewidth]{videoscope02.png}

     \caption{Colortest 75\% with RGB Parade (left) and Waveform (right)}
     \label{fig:videoscope02}
 \end{figure}
 
 On the left is shown RGB Parade: instead of the color shadows as in figure~\ref{fig:videoscope01}, we have lines representing the color bar test at $75\%$. They are pure colors, so all pixels have the same value. In fact, they are all at the level of $75\%$ except for the $100\%$ white band and the $0\%$ black band. In the waveform on the right, we have the same behavior with regard to luminance: the white band is $100\%$; the black band is $0\%$ and all the others $75\%$.
 
     \caption{Colortest 75\% with RGB Parade (left) and Waveform (right)}
     \label{fig:videoscope02}
 \end{figure}
 
 On the left is shown RGB Parade: instead of the color shadows as in figure~\ref{fig:videoscope01}, we have lines representing the color bar test at $75\%$. They are pure colors, so all pixels have the same value. In fact, they are all at the level of $75\%$ except for the $100\%$ white band and the $0\%$ black band. In the waveform on the right, we have the same behavior with regard to luminance: the white band is $100\%$; the black band is $0\%$ and all the others $75\%$.
 

-The Waveform scope helps correct image light levels for contrast range or for conforming light levels on various scenes originally shot on different light settings (figure~\ref{fig:videoscope03}).
+The Waveform scope helps correct image light levels for contrast range or for conforming light levels on various scenes originally shot on different light settings (figure~\ref{fig:videoscope03}). The same can be done with RGB Parade or the convenient overlapping representation (Waveform Ply).

 
 \begin{figure}[hbtp]
     \centering
 
 \begin{figure}[hbtp]
     \centering

-    \includegraphics[width=0.7\linewidth]{videoscope03.png}
-    \caption{Example of waveform}
+    \includegraphics[width=1.0\linewidth]{videoscope03.png}
+    \caption{Examples of waveform, waveform RGB and waveform Ply}

     \label{fig:videoscope03}
 \end{figure}
 
     \label{fig:videoscope03}
 \end{figure}
 


@@ -2894,13 +2895,13 @@ The Waveform scope helps correct image light levels for contrast range or for co
 
 \begin{enumerate}
     \item Add the \textit{Brightness/Contrast}, \textit{Histogram}, \textit{Color 3 Way} or another video adjustment effect on your track/edit.
 
 \begin{enumerate}
     \item Add the \textit{Brightness/Contrast}, \textit{Histogram}, \textit{Color 3 Way} or another video adjustment effect on your track/edit.

-    \item Add the Videoscope effect on the track below. Make sure that it is placed below so it can see the adjustment effect's results. If it is not, right-click and move it down.
+    \item Add the Videoscope effect on the track below. Make sure that it is placed below so it can see the adjustment effect's results. If it is not, right-click and move it down. Or do not use the plugin but activate the Videoscope button in the Compositor window.

     \item Show both the effect and Videoscope.
     \item Adjust the contrast while observing the waveform to match the desired light level.
     \item Show both the effect and Videoscope.
     \item Adjust the contrast while observing the waveform to match the desired light level.

-    \item Precise adjustments can be made by measuring the values on the waveform with the crosshair (by click with LMB, and reading numeric values on top left of the window) and reporting these numbers in the effects window (\textit{Histogram Bézier}, for example).
+    \item Precise adjustments can be made by measuring the values on the waveform with the crosshair (by clicking LMB, and reading numeric values on top left of the window) and reporting these numbers in the effects window (\textit{Histogram Bézier}, for example).

 \end{enumerate}
 
 \end{enumerate}
 

-For instance, if you are looking for maximum contrast range, adjust the \textit{Brightness/Contrast} levels to align the darkest point on the scope with the $0\%$ level and the brightest portion with $100\%$. Anything above $100\%$ is over saturated. Limits which may be highlighted with checkbox controls.
+For example, if you are looking for maximum contrast range, adjust the \textit{Brightness/Contrast} levels to align the darkest point on the scope with the $0\%$ level and the brightest portion with $100\%$. Anything above $100\%$ is over saturated. Limits may be highlighted with checkbox controls.

 
 \subsubsection*{HDTV or sRGB (ITU-R BT.709)}%
 \label{ssub:hdtv_srgb_bt709}
 
 \subsubsection*{HDTV or sRGB (ITU-R BT.709)}%
 \label{ssub:hdtv_srgb_bt709}


@@ -2920,9 +2921,33 @@ If you are producing a video for NTSC television broadcast, keep the intensity b
 \subsubsection*{Vectorscope}%
 \label{ssub:Vectorscope}
 
 \subsubsection*{Vectorscope}%
 \label{ssub:Vectorscope}
 

-The Vectorscope displays \textit{hue} (angle on the color wheel) and \textit{saturation} (radius). Each pixel in the source image is drawn as a point on the color wheel. The distance from the center is the color saturation. Gray values are close to the center, and high saturation values are near the perimeter ($100\%$). In the center there is pure white ($0\%$). By clicking with the mouse on the color wheel appear radius and circle whose values of hue and saturation are shown at the top left of the window, similar to the values of $X$ and luminance of the Waveform and RGB Parade (figure~\ref{fig:videoscope04}).
+The Vectorscope displays \textit{hue} (angle on the color wheel) and \textit{saturation} (radius). Each pixel in the source image is drawn as a point on the color wheel. The distance from the center is the color saturation. Gray values are close to the center, and high saturation values are near the perimeter ($100\%$). In the center there is pure white ($0\%$). By clicking with the mouse on the color wheel a radius and circle 
+will appear whose values of hue and saturation are shown at the top left of the window, similar to the values of $X$ and luminance of the Waveform and RGB Parade (figure~\ref{fig:videoscope05}).

 
 

-Vectorscope is used as monitor with other plugins to correct color, adjust image tint, and apply other effects for cinematic effects, image correction, or to conform images to look the same. For example, skin tones are found along an axis (\textit{+ I-line}) between yellow and red, and between $0$ and $50\%$ saturation values. The blue of the sky is more or less along the opposite axis to that of the skin (\textit{- I-line}), with a much wider saturation range.
+\begin{figure}[hbtp]
+       \centering
+       \includegraphics[width=0.9\linewidth]{videoscope05.png}
+       \caption{Vectorscope (with I-Line) and VectorWheel (with IQ-Hue-Tics reticule)}
+       \label{fig:videoscope05}
+\end{figure}
+
+Note that when you choose \textit{VectorWheel} from \textit{Scopes} pulldown, the \textit{Overlay} pulldown
+appears where you can choose between different grids. In addition, any number of user-supplied grid patterns
+can be added in the form of a square image of type png.  The user can design and maintain individual grid
+overlays for various purposes.  The user would keep their overlays in a safe spot on their disk and make
+a copy of them in the \{cinelerra\_pathname\}/bin/plugins/scopes every time a new version of \CGG{} is installed.
+
+Generally the Vectorscope has the following uses:
+
+\begin{enumerate}
+       \item Compare saturation levels (radius) between Edits.
+       \item Compare the hues (angle) between Edits.
+       \item Compare skin tones, sky and vegetation.
+       \item Display the color balance or color cast.
+       \item Check the legal limits of the video signal.
+\end{enumerate}
+
+ For example, skin tones are found along an axis (\textit{+ I-line}) between yellow and red, and between $0$ and $50\%$ saturation values. The blue of the sky is more or less along the opposite axis to that of the skin (\textit{- I-line}), with a much wider saturation range.

 
 \begin{figure}[hbtp]
     \centering
 
 \begin{figure}[hbtp]
     \centering

diff --git a/parts/Trouble.tex b/parts/Trouble.tex
index 84d6ec571f19f862e07e8af5bb1b202c77722e44..d2efe4b18028a352c28a69f25d6a222c1e6d3f9d 100644 (file)
--- a/parts/Trouble.tex
+++ b/parts/Trouble.tex
@@ -149,6 +149,13 @@ Some messages you may see in the startup window may or may not be errors. Some e
 This is not a problem. Basically, when you open a file if a stream has a known duration, there is no message. If the duration is unknown, it is estimated by using the File Size and Bitrate to estimate the duration. This may just indicate that the stream number \CGG{} uses versus ffmpeg may be counted differently.
 \bigskip
 
 This is not a problem. Basically, when you open a file if a stream has a known duration, there is no message. If the duration is unknown, it is estimated by using the File Size and Bitrate to estimate the duration. This may just indicate that the stream number \CGG{} uses versus ffmpeg may be counted differently.
 \bigskip
 

+\textit{FFMPEG::scan: codec open failed} followed by
+\newline 
+\textit{FFMPEG::scan:file=} \quad \texttt{your directory/filename}
+
+This is not a problem. \CGG{} is building an index for your file in order to better seek.  In that process, different methods are tried until a successful scan is complete.
+\bigskip
+

 \textit{AudioALSA::write\_buffer err -32(Broken pipe) at sample \#}
 
 This indicates that there is something wrong with the audio. Some reasons for this are:
 \textit{AudioALSA::write\_buffer err -32(Broken pipe) at sample \#}
 
 This indicates that there is something wrong with the audio. Some reasons for this are:

diff --git a/parts/Windows.tex b/parts/Windows.tex
index b662a49fd0a745d057bb33382e80d3d112ca33c8..660f295e68b6157039fbe9fcc07d629e8f597364 100644 (file)
--- a/parts/Windows.tex
+++ b/parts/Windows.tex
@@ -570,7 +570,8 @@ On the bottom of the window, there are many
 of the same transport buttons and controls that are available in the Program window.
 They work the same as in the Program window and also have tooltips that are visible 
 when you mouse over each of the icons so their use is fairly obvious.  However,
 of the same transport buttons and controls that are available in the Program window.
 They work the same as in the Program window and also have tooltips that are visible 
 when you mouse over each of the icons so their use is fairly obvious.  However,

-of particular note is the button \textit{Click to play} which is described in~\ref{sub:click_to_play_in_viewer_and_compositor}.
+of particular note is the button \textit{Click to play} which is described in~\ref{sub:click_to_play_in_viewer_and_compositor}.  Next is the \textit{Videoscope} button which is used to enable the scopes window
+without having to apply the filter to the tracks/edits.

 
 Next to all of these controls all the way to the right side, there is a \textit{zoom menu} and a \textit{tally light}.  The \textit{zoom menu} has a pulldown with different settings that you can choose from
 or you can just use the tumbler arrows to the right. Generally when just getting started, you
 
 Next to all of these controls all the way to the right side, there is a \textit{zoom menu} and a \textit{tally light}.  The \textit{zoom menu} has a pulldown with different settings that you can choose from
 or you can just use the tumbler arrows to the right. Generally when just getting started, you


@@ -1165,7 +1166,7 @@ the timebar above the transport buttons.
 \begin{figure}[htpb]
     \centering
     \includegraphics[width=0.99\linewidth]{viewer_window.png}
 \begin{figure}[htpb]
     \centering
     \includegraphics[width=0.99\linewidth]{viewer_window.png}

-    \caption{Viewer Window - note the green/white arrow "Play" button left of 001484}
+    \caption{Viewer Window - the red arrow "Play" button is left of the Videoscope button}

     \label{fig:viewer_window}
 \end{figure}
 
     \label{fig:viewer_window}
 \end{figure}
 


@@ -1181,9 +1182,10 @@ In order to view media in the window, you have to load it as follows:
 
 Note that you can have multiple Viewer windows open with different or even the same media asset.
 After the media is loaded you can use the transport buttons to play, rewind, stop, and so on, or
 
 Note that you can have multiple Viewer windows open with different or even the same media asset.
 After the media is loaded you can use the transport buttons to play, rewind, stop, and so on, or

-for fast previewing drag with the LMB anywhere on the timebar slider.  A few more options
-available in the Viewer window can be accessed with a RMB click on the display.  These functions
-are listed next.
+for fast previewing drag with the LMB anywhere on the timebar slider.  There is also the Videoscope
+button which is to used to enable the scopes window without having to apply the filter to the tracks/edits.
+A few more options available in the Viewer window can be accessed with a RMB click on the display.
+These functions are listed next.

 
 \begin{enumerate}
     \item  Switch to a fullscreen display by choosing \textit{Fullscreen}.  To switch back, click
 
 \begin{enumerate}
     \item  Switch to a fullscreen display by choosing \textit{Fullscreen}.  To switch back, click


@@ -1265,7 +1267,7 @@ There are either a left or right resize pointer and you can click and drag in ei
 \begin{figure}[htpb]
     \centering
     \includegraphics[width=1.0\linewidth]{timebar2.png}
 \begin{figure}[htpb]
     \centering
     \includegraphics[width=1.0\linewidth]{timebar2.png}

-    \caption{A left-facing arrow on the right side of the blue slider bar is used to drag the bar.}
+    \caption{A left-facing arrow on the right side of the reddish slider bar is used to drag the bar.}

     \label{fig:timebar2}
 \end{figure}
 
     \label{fig:timebar2}
 \end{figure}