From 4909c6d244b37bfb828e3e2518f14b41c2e391c9 Mon Sep 17 00:00:00 2001 From: Good Guy Date: Mon, 22 Jul 2024 18:47:30 -0600 Subject: [PATCH] Credit Andrea - minor improvements + removed quotes from around git clone statements --- parts/Developer.tex | 4 ++-- parts/Plugins.tex | 4 ++-- parts/Quickstart.tex | 4 ++-- parts/Rendering.tex | 15 ++++++++++----- 4 files changed, 16 insertions(+), 11 deletions(-) diff --git a/parts/Developer.tex b/parts/Developer.tex index 34d355f..bca56dc 100644 --- a/parts/Developer.tex +++ b/parts/Developer.tex @@ -754,7 +754,7 @@ This follows four steps: Start by downloading the \CGG{} source from Cinelerra's git. The last parameter is a directory name of your choice, the directory must not exist. As example, the name \textit{cinelerra5} is used. \begin{lstlisting}[numbers=none] - git clone --depth 1 "git://git.cinelerra-gg.org/goodguy/cinelerra.git" cinelerra5 + git clone --depth 1 git://git.cinelerra-gg.org/goodguy/cinelerra.git cinelerra5 \end{lstlisting} The source will be in a subdirectory \texttt{cinelerra-5.1} of the directory created by the \textit{git clone} operation. @@ -762,7 +762,7 @@ The source will be in a subdirectory \texttt{cinelerra-5.1} of the directory cre If context-sensitive help is needed, download the manual sources too, with a different destination directory. \begin{lstlisting}[numbers=none] - git clone --depth 1 "git://git.cinelerra-gg.org/goodguy/cin-manual-latex.git" cin-manual-latex + git clone --depth 1 git://git.cinelerra-gg.org/goodguy/cin-manual-latex.git cin-manual-latex \end{lstlisting} Then move to the \texttt{/\{path to cinelerra-5.1}/\} directory. diff --git a/parts/Plugins.tex b/parts/Plugins.tex index 7b2c191..d5703ce 100644 --- a/parts/Plugins.tex +++ b/parts/Plugins.tex @@ -389,7 +389,7 @@ NOTE: The capability to put the expanders.txt file in \texttt{./bcast5} (see \na For users running \CGG{} using the AppImage, to make an initial copy of expanders.txt, execute the following lines on /tmp: \begin{lstlisting}[numbers=none] - git clone --depth 1 "git://git.cinelerra-gg.org/goodguy/cinelerra.git" cinelerra5 + git clone --depth 1 git://git.cinelerra-gg.org/goodguy/cinelerra.git cinelerra5 cp /tmp/cinelerra5/cinelerra-5.1/expanders.txt $HOME/.bcast5/expanders.txt \end{lstlisting} @@ -3983,7 +3983,7 @@ cp Makefile.devel Makefile To build findobject and the other plugins using OpenCV, access the src using git: \begin{lstlisting}[style=sh] -git clone --depth 1 "git://git.cinelerra-gg.org/goodguy/cinelerra.git" cinelerra5 +git clone --depth 1 git://git.cinelerra-gg.org/goodguy/cinelerra.git cinelerra5 \end{lstlisting} To use the latest version, the method for creating a tarball is: diff --git a/parts/Quickstart.tex b/parts/Quickstart.tex index aec2992..8035678 100644 --- a/parts/Quickstart.tex +++ b/parts/Quickstart.tex @@ -328,9 +328,9 @@ These are also called Delivery codecs. They are the most used and widespread bei \item[MP4] The most popular. Many other formats belong to this family (MPEG); \newline h264 is actually x264, open, highly configurable and documented; h265/HEVC is actually x265, open, highly configurable and documented. x264-5 is for encoding only. \newline Presets: \textit{h265, h265, mjpeg, mpeg2, obs2youtube} - \item[WEBM] Open; similar to mp4 but not as widespread (it is used by YouTube). It belongs to the Matroska family. In \CGG{} there are specific Presets with \texttt{.youtube} extension, but they are still webm. + \item[WEBM] Open; similar to mp4 but not as widespread (it is used by YouTube). It belongs to the Matroska family. In \CGG{} there are specific Presets with \texttt{.youtube} extension, but they are still webm. For VP9 and AV1 presets, two pass rendering is recommended, which provides higher quality. \newline Presets: \textit{VP8, VP9, AV1} - \item[MKV] Open, highly configurable and widely documented. It might have seeking problems. It belongs to the Matroska family. + \item[MKV] Open, highly configurable and widely documented. It might have seeking problems. It belongs to the Matroska family. For VP9 presets, two pass rendering is recommended, which provides higher quality. \newline Presets: \textit{Theora, VP8, VP9} \item[AVI] Old and limited format (no multistreams, no subtitles, limited metadata) but with high compatibility. \newline Presets: \textit{asv, DV, mjpeg, xvid} diff --git a/parts/Rendering.tex b/parts/Rendering.tex index 053096c..c978d72 100644 --- a/parts/Rendering.tex +++ b/parts/Rendering.tex @@ -222,8 +222,13 @@ used.\\ Example: \textit{cin\_sample\_fmt=s16} \textit{wrench} in addition to the \textit{View} button, which allows more global options and changes to the formats, there is an additional \textit{Format} button that allows you to modify the -Private Options, i.e.\ relating to specific muxing formats. More -information on all these options can be found at +Private Options, i.e.\ relating to specific muxing formats. You can list private options available in a encoder with: + +\begin{lstlisting}[style=sh] + $ /path/to/cin/thirdparty/ffmpeg-X.Y/ffmpeg -h encoder='libcodec' (i.e. libx265) +\end{lstlisting} + +More information on all these options can be found at \href{https://ffmpeg.org/ffmpeg-all.html#Format-Options}{ffmpeg.org} sections 19 and 21. See also \nameref{sub:modifying_ffmpeg_cinelerra}. @@ -233,7 +238,7 @@ Render presets in \CGG{} should work Out Of the Box. You can still configure the \label{sec:some_specific_rendering} \noindent The next few pages relate to rendering for specific common -cases. +cases. Also see: \small\url{https://gist.github.com/dexeonify/ed31c7d85fcf7297719e2ec4740fafda}) \subsection{FFmpeg Common H.264 Rendering}% \label{sub:ffmpeg_h264_rendering} @@ -561,9 +566,9 @@ considered open source, the \textsc{Webm} container is based on \textsc{Matroska} for video and \textsc{Opus} for audio. There are some common \textsc{VP9} rendering options files that support creation of video for YouTube, -Dailymotion, and other online video services. +Dailymotion, and other online video services. YouTube easy startup steps are documented above. -YouTube easy startup steps are documented above. +Note: For VP9 and AV1 presets, two pass rendering is recommended, which provides higher quality. Below is one of the \textsc{VP9} rendering options file with documentation for specifics: -- 2.26.2