From: Good Guy Date: Mon, 23 Mar 2020 03:05:15 +0000 (-0600) Subject: Andrea recreated images + some fixups X-Git-Tag: 2021-05~102 X-Git-Url: https://git.cinelerra-gg.org/git/?p=goodguy%2Fcin-manual-latex.git;a=commitdiff_plain;h=6b9ffc5e7544ea2090ef8251d33b2b507974a8ad Andrea recreated images + some fixups --- diff --git a/images/bezier.png b/images/bezier.png index 605e65d..28be2b5 100644 Binary files a/images/bezier.png and b/images/bezier.png differ diff --git a/images/bluebanana.png b/images/bluebanana.png index b69fd29..618aa22 100644 Binary files a/images/bluebanana.png and b/images/bluebanana.png differ diff --git a/images/brightness.png b/images/brightness.png index 1c03f67..f15b367 100644 Binary files a/images/brightness.png and b/images/brightness.png differ diff --git a/images/c41.png b/images/c41.png index 5811dab..ffa5c77 100644 Binary files a/images/c41.png and b/images/c41.png differ diff --git a/images/camera_and_projector.pdf b/images/camera_and_projector.pdf new file mode 100644 index 0000000..41b7c57 Binary files /dev/null and b/images/camera_and_projector.pdf differ diff --git a/images/camera_and_projector.png b/images/camera_and_projector.png deleted file mode 100644 index f2b3180..0000000 Binary files a/images/camera_and_projector.png and /dev/null differ diff --git a/images/chroma-key-hsv.png b/images/chroma-key-hsv.png index c2bbfd3..7208200 100644 Binary files a/images/chroma-key-hsv.png and b/images/chroma-key-hsv.png differ diff --git a/images/chroma-key.png b/images/chroma-key.png index 68a3386..6a9cce3 100644 Binary files a/images/chroma-key.png and b/images/chroma-key.png differ diff --git a/images/crikey.png b/images/crikey.png index 4d837b9..b7a6c2c 100644 Binary files a/images/crikey.png and b/images/crikey.png differ diff --git a/images/crikey01.png b/images/crikey01.png index 44a2f32..7a41692 100644 Binary files a/images/crikey01.png and b/images/crikey01.png differ diff --git a/images/crikey02.png b/images/crikey02.png index 6dd91e3..91b4397 100644 Binary files a/images/crikey02.png and b/images/crikey02.png differ diff --git a/images/deinterlace.png b/images/deinterlace.png index 5c59d7d..ae75ab6 100644 Binary files a/images/deinterlace.png and b/images/deinterlace.png differ diff --git a/images/denoise.png b/images/denoise.png index e1b6522..8279dfe 100644 Binary files a/images/denoise.png and b/images/denoise.png differ diff --git a/images/descratch.png b/images/descratch.png index a467eef..bf0e4dc 100644 Binary files a/images/descratch.png and b/images/descratch.png differ diff --git a/images/descratch01.png b/images/descratch01.png index ba80587..e8d6d7d 100644 Binary files a/images/descratch01.png and b/images/descratch01.png differ diff --git a/images/descratch02.png b/images/descratch02.png index 1e20376..60b0cb9 100644 Binary files a/images/descratch02.png and b/images/descratch02.png differ diff --git a/images/diff-key.png b/images/diff-key.png index fe197f6..9ec120c 100644 Binary files a/images/diff-key.png and b/images/diff-key.png differ diff --git a/images/ex-bezier.png b/images/ex-bezier.png index 3de4f49..991179c 100644 Binary files a/images/ex-bezier.png and b/images/ex-bezier.png differ diff --git a/images/gamma01.png b/images/gamma01.png index 39b224b..6eb695f 100644 Binary files a/images/gamma01.png and b/images/gamma01.png differ diff --git a/images/gamma02.png b/images/gamma02.png index 2ef7485..adac1d9 100644 Binary files a/images/gamma02.png and b/images/gamma02.png differ diff --git a/images/histeq.png b/images/histeq.png index 68208b3..c9b0206 100644 Binary files a/images/histeq.png and b/images/histeq.png differ diff --git a/images/histogram.png b/images/histogram.png index 158ec7a..982d3d2 100644 Binary files a/images/histogram.png and b/images/histogram.png differ diff --git a/images/recording05.png b/images/recording05.png new file mode 100644 index 0000000..0344db6 Binary files /dev/null and b/images/recording05.png differ diff --git a/images/recording06.png b/images/recording06.png new file mode 100644 index 0000000..08122e0 Binary files /dev/null and b/images/recording06.png differ diff --git a/parts/Developer.tex b/parts/Developer.tex index 1744319..a9c18bf 100644 --- a/parts/Developer.tex +++ b/parts/Developer.tex @@ -321,6 +321,42 @@ The rule targets create the set of thirdparty packages which are built from loca 24 cpus & = & 2 mins\\ \end{tabular} + +\section{Using the very latest Libraries} +\label{sec:latest_libraries} + +Using the most current libraries can be a challenge for some of the Operating System distros that use +stable compilers, assemblers, and their own libraries. Because they are stable, they frequently do +not keep up with the very latest of thirdparty libraries. Consequently, some program constructs may +not yet be implemented. + +\CGG{} attempts to upgrade to the latest releases of many thirdparty libraries about every 3-4 +months. But it is often difficult to keep some of these thirdparty libraries up to date as their +developers switch from tried and true standard tools to newer, less standard tools. As a result +in order to build \CGG{} on 2-3 versions of any distro rather than only the most current version, +some thirdparty libraries can not be kept up to date and may even be to the point of no further +updates. In a lot of cases, the updated releases provide little new capabilities but rather +are bug fixes that may not even be relevant to \CGG{}'s use. + +So as a computer savvy user or a developer, if you would like to build \CGG{} with the latest +thirdparty releases for some of the packages here are a few suggestions based on experimentation. + +\textbf{dav1d} +\begin{description} + \item Status - currently \CGG{} is staying at 0.5. This is disappointing because there are speed +up gains in version 0.6 that would be beneficial. + \item Problem - 0.6 dav1d requires NASM 2.14. It also uses meson which is not widely available on all +distros. The only distros that are built for \CGG{} that are at 2.14 are the latest version +of Arch, Debian(10), Gentoo, Tumbleweed, and Fedora(31). The rest are at 2.12 and 2.13 including +the most widely used Ubuntu. + \item Workaround already in use by \CGG{} - a Makefile was generated to replace Meson usage +but has to be continuously updated for new releases. Dav1d 0.5 requires NASM 2.13 so at this level +the newer distros mostly work. The availability of meson and nasm are a significant problem on +many systems which are still in wide use. A request to dav1d developers to consider changes to +ensure their library is more widely usable did not appear to be in their future. It works for +them. +\end{description} + \section{Find Lock Problems with Booby Trap} \label{sec:find_lock_problems_booby_trap} diff --git a/parts/Plugins.tex b/parts/Plugins.tex index 1dca209..7de1994 100644 --- a/parts/Plugins.tex +++ b/parts/Plugins.tex @@ -1184,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} @@ -1246,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} @@ -1292,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} @@ -1351,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} @@ -1564,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} @@ -1639,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} @@ -1666,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} @@ -1701,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} diff --git a/parts/Recording.tex b/parts/Recording.tex index 54d21fb..9a61832 100644 --- a/parts/Recording.tex +++ b/parts/Recording.tex @@ -602,10 +602,15 @@ To review media stored in the \texttt{media.db}, and delete old expired commerci Currently, only a customized \textit{ati-x10} (kernel mod required) radio remote control works. But this can quite readily be modified for other remote control models. -\section{Transfer VHS/DVD Media into \CGG{}}% -\label{sec:transfer_vhs_dvd_into_cinelerra} +\section{Transfer VHS/DVD Media or Video8/Hi8 Tapes into \CGG{}}% +\label{sec:transfer_vhs_dvd_tapes_into_cinelerra} -If you want to transfer the data on a VHS tape or DVD disc into \CGG{}, you can do so by playing the media and recording while playing. This captures the media, which you are able to view as it plays, and writes it to a file so it can be played directly or edited. Because there is so much variation in hardware on both the Computer side and the Media Player side, these \textit{how to} directions are only a guideline. You will most likely still have to do some experimentation and testing to see what works for you. +If you want to transfer the data on a VHS tape, DVD disc, or Video8/Hi8 Tapes into \CGG{}, you +can do so by playing the media and recording while playing. This captures the media, which you +are able to view as it plays, and writes it to a file so it can be played directly or edited. +Because there is so much variation in hardware on both the Computer side and the Media Player side, +these \textit{how to} directions are only a guideline. You will most likely still have to do some +experimentation and testing to see what works for you. The basic strategy consists of 3 operations: connect the relevant outputs to representative inputs, configure the capture card to match the video, and start the Record monitor. Each of these may have to be experimented with to get them correct for your hardware setup. @@ -613,7 +618,7 @@ The basic strategy consists of 3 operations: connect the relevant outputs to re For example in a test case using the \textit{CX23418} capture card (an older/unusual single chip MPEG-2 encoder with integrated analog video/broadcast audio decoder), one end of an S-Video cable was plugged into the back of a DVD player and the other end plugged into this computer’s Capture card; the audio was plugged into the \textit{line in} on the computer sound card. -\textit{Step 2}:Setup \CGG{} and it might be best the first time if you start with a default \texttt{.bcast5} file by using a +\textit{Step 2}: Setup \CGG{} and it might be best the first time if you start with a default \texttt{.bcast5} file by using a command line from a window of \\ \texttt{CIN\_CONFIG=\$HOME/bcast6 {cinelerra\_path}/bin/cin} @@ -621,8 +626,8 @@ command line from a window of \\ \item Choose \texttt{Settings $\rightarrow$ Preferences $\rightarrow$ Recording} tab in the Preferences menu (figure~\ref{fig:recordingx}). \item Choose a \textit{File Format} -- a common suggestion is \textit{ffmpeg} with a \textit{file type} of mp4. In some cases depending on your capture card, the File Format will be set to \textit{MPEG stream} capture. Some formats support MPEG stream capture technique, otherwise the data has to be decoded first and then encoded. \item Check that the \textit{Audio In} section has the \textit{Record Driver} set to \textit{Alsa} with \textit{Device} set to \textit{default} as the Capture Source. If you are using something besides Alsa, change that selection accordingly. This may not always be default and you may have to change to something else based on your specific hardware. It has to match up what you see in our Control Panel on your computer. So for example, if your device is HDMI, than the \textit{default} could be \textit{HDMI}\dots instead. - \item In the \textit{Video In} section, change the\textit{ Record Driver} to whatever makes sense for your capture card. The test case for the CX23418 would use Video4Linux2 MPEG. If unknown what your card uses, you should experiment with Video4Linux2 or Screencapture as good possibilities. - \item Also, \textit{Device path} should be verified to be correct in case you have more than 1 device. + \item In the \textit{Video In} section, change the\textit{ Record Driver} to whatever makes sense for your capture card. The test case for the CX23418 would use Video4Linux2 MPEG. A test case for an EasyCap Model \#DC60 would use Video4Linux2 JPEG. If unknown what your card uses, you should experiment with Video4Linux2 or Screencapture as good possibilities. + \item Also, \textit{Device path} should be verified to be correct in case you have more than 1 device. In the 2 previously mentioned devices, it should proabably be set to /dev/video0. \end{itemize} \begin{figure}[htpb] @@ -666,3 +671,76 @@ There are many more parameters that you may want to vary in the Recording menu o Now you can \textit{Load} the file that you played and recorded via the \textit{Insertion strategy} choices on the bottom of the Recording menu and edit the file as usual. Note, that the audio and video may have started at slightly different times so you might have to initially line them up at the beginning using \texttt{nudge}. Generally once they are correctly aligned they will stay that way. Nudge is in the expanded patchbay. The nudge value is the amount the track is shifted left or right during playback. The track is not displayed shifted on the timeline, but it is shifted when it is played back. +\subsection{Use Case \#1 – EasyCap Model \# DC60} +\label{sub:use_case_easycap_model_dc60} + +A very specific case using an Easy CAPture USB 2.0 Video Adapter with Audio, Model \#DC60 (supports +NTSC and PAL) is shown here next. The setup for this device is seen in figure~\ref{fig:recording-usb}. +A somewhat unusual choice to make note of in this image is the setting for the Video In, Record Driver +of Video4Linux2 JPEG. + +\begin{figure}[htpb] + \centering + \includegraphics[width=0.9\linewidth]{recording05.png} + \caption{Recording setup for EasyCap device} + \label{fig:recording-usb} +\end{figure} + +Output on startup window while playing: +\begin{lstlisting}[style=sh] +DeviceV4L2Base::v4l2_open pixels="MJPG"; res="480x320 640x480 720x480" +DeviceV4L2Base::v4l2_open pixels="YUYV"; res="480x320" +v4l2 s_fmt 640x480 MJPG +DeviceV4L2Base::v4l2_open VIDIOC_S_STD: Inappropriate ioctl for device +DeviceV4L2Base::v4l2_open VIDIOC_G_JPEGCOMP: Inappropriate ioctl for device +DeviceV4L2Base::v4l2_open VIDIOC_S_JPEGCOMP: Inappropriate ioctl for device +[Detaching after vfork from child process 6539] +\end{lstlisting} + +\begin{lstlisting}[style=sh] +Output from "dmesg" for EasyCap - Model \# DC60: + +[ 748.560775] usb 3-1.2: new high-speed USB device number 8 using xhci_hcd +[ 748.574296] usb 3-1.2: New USB device found, idVendor=534d, idProduct=0021, bcdDevice= 1.21 +[ 748.574303] usb 3-1.2: New USB device strings: Mfr=1, Product=2, SerialNumber=3 +[ 748.574307] usb 3-1.2: Product: AV TO USB2.0 +[ 748.574310] usb 3-1.2: Manufacturer: MACROSILICON +[ 748.574313] usb 3-1.2: SerialNumber: 20150130 +[ 748.635600] hid-generic 0003:534D:0021.0008: hiddev97,hidraw0: USB HID v1.10 Device [MACROSILICON AV TO USB2.0] on usb-0000:16:00.3-1.2/input4 +[ 748.698491] mc: Linux media interface: v0.10 +[ 748.727360] videodev: Linux video capture interface: v2.00 +[ 748.796533] usbcore: registered new interface driver snd-usb-audio +[ 748.796660] uvcvideo: Found UVC 1.00 device AV TO USB2.0 (534d:0021) +[ 748.796876] uvcvideo: UVC non compliance - GET_DEF(PROBE) not supported. Enabling workaround. +[ 748.797204] uvcvideo 3-1.2:1.0: Entity type for entity Processing 2 was not initialized! +[ 748.797212] uvcvideo 3-1.2:1.0: Entity type for entity Camera 1 was not initialized! +[ 748.797353] usbcore: registered new interface driver uvcvideo +[ 748.797356] USB Video Class driver (1.1.1) +[ 3982.626522] retire_capture_urb: 7 callbacks suppressed +[ 3982.747515] usb 3-1.2: USB disconnect, device number 8 +[ 4007.286371] usb 3-1.2: new high-speed USB device number 9 using xhci_hcd +[ 4007.302726] usb 3-1.2: New USB device found, idVendor=534d, idProduct=0021, bcdDevice= 1.21 +[ 4007.302732] usb 3-1.2: New USB device strings: Mfr=1, Product=2, SerialNumber=3 +[ 4007.302736] usb 3-1.2: Product: AV TO USB2.0 +[ 4007.302740] usb 3-1.2: Manufacturer: MACROSILICON +[ 4007.302743] usb 3-1.2: SerialNumber: 20150130 +[ 4007.354826] uvcvideo: Found UVC 1.00 device AV TO USB2.0 (534d:0021) +[ 4007.354939] uvcvideo: UVC non compliance - GET_DEF(PROBE) not supported. Enabling workaround. +[ 4007.355252] uvcvideo 3-1.2:1.0: Entity type for entity Processing 2 was not initialized! +[ 4007.355256] uvcvideo 3-1.2:1.0: Entity type for entity Camera 1 was not initialized! +[ 4007.420828] hid-generic 0003:534D:0021.0009: hiddev97,hidraw0: USB HID v1.10 Device [MACROSILICON AV TO USB2.0] on usb-0000:16:00.3-1.2/input4 +\end{lstlisting} + +\subsection{Use Case \#2 – Hauppauge WinTV-HVR} +\label{sub:use_case_wintv} + +In the case of the Hauppauge 9500 WinTV-HVR Hybrid TV stick, the setup is similar as in case +\#1 with the major exception being that the Video In, Record Driver should be Video4Linux2 MPEG. + +\begin{figure}[htpb] + \centering + \includegraphics[width=0.9\linewidth]{recording06.png} + \caption{Two possible capture devices using USB} + \label{fig:recording-usb} +\end{figure} + diff --git a/parts/Rendering.tex b/parts/Rendering.tex index cf8ddc1..1f1646f 100644 --- a/parts/Rendering.tex +++ b/parts/Rendering.tex @@ -933,7 +933,7 @@ for your setup. may want to share these files with the clients on a shared filesystem. More information on index files configuration is outlined in~\ref{sub:index_file_section}. -\item Or, one of the convenient features of Cinelerra is the +\item Or, one of the convenient features of \CGG{} is the redirection of the path via \texttt{CIN\_CONFIG} as in: \begin{lstlisting}[style=sh] CIN_CONFIG="//" cin diff --git a/parts/Windows.tex b/parts/Windows.tex index 2a2de18..9b4b935 100644 --- a/parts/Windows.tex +++ b/parts/Windows.tex @@ -773,7 +773,7 @@ modified, the final image is projected to the compositor so that you now have a \begin{figure}[htpb] \centering - \includegraphics[width=0.8\linewidth]{camera_and_projector.png} + \includegraphics[width=0.8\linewidth]{camera_and_projector.pdf} \caption{Color3way on Temporary} \label{fig:camera_and_projector} \end{figure}