From: Good Guy Date: Fri, 17 Apr 2020 23:44:43 +0000 (-0600) Subject: Videoscope update by Andrea and some minor changes X-Git-Tag: 2021-05~91 X-Git-Url: http://git.cinelerra-gg.org/git/?a=commitdiff_plain;h=d846ffb18f5ae4aa00e8df3f23cfb18b77a0cf30;p=goodguy%2Fcin-manual-latex.git Videoscope update by Andrea and some minor changes --- diff --git a/images/compositor_window.png b/images/compositor_window.png index b5b3e52..20299e1 100644 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 edc4741..9c8603f 100644 Binary files a/images/timebar1.png and b/images/timebar1.png differ diff --git a/images/timebar2.png b/images/timebar2.png index 43622c2..325f9c4 100644 Binary files a/images/timebar2.png and b/images/timebar2.png differ diff --git a/images/timebar3.png b/images/timebar3.png index bf26361..741ad53 100644 Binary files a/images/timebar3.png and b/images/timebar3.png differ diff --git a/images/timebar4.png b/images/timebar4.png index 630b444..c78281b 100644 Binary files a/images/timebar4.png and b/images/timebar4.png differ diff --git a/images/videoscope01.png b/images/videoscope01.png index 637c20a..8a8d384 100644 Binary files a/images/videoscope01.png and b/images/videoscope01.png differ diff --git a/images/videoscope02.png b/images/videoscope02.png index 2b4bf71..fc35a1e 100644 Binary files a/images/videoscope02.png and b/images/videoscope02.png differ diff --git a/images/videoscope03.png b/images/videoscope03.png index 18ff78d..a8fed24 100644 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 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 7257b7a..5f91014 100644 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 475f8aa..114060e 100644 --- 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 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} diff --git a/parts/Plugins.tex b/parts/Plugins.tex index 7402326..ce576fe 100644 --- 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} -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 - \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} -\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 - \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\%$. -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 - \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} @@ -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. - \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 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} -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} @@ -2920,9 +2921,33 @@ If you are producing a video for NTSC television broadcast, keep the intensity b \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 diff --git a/parts/Trouble.tex b/parts/Trouble.tex index 84d6ec5..d2efe4b 100644 --- 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 +\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: diff --git a/parts/Windows.tex b/parts/Windows.tex index b662a49..660f295 100644 --- 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 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 @@ -1165,7 +1166,7 @@ the timebar above the transport buttons. \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} @@ -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 -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 @@ -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} - \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}