From: Good Guy Date: Wed, 5 Apr 2023 19:12:24 +0000 (-0600) Subject: Andrea improvement + Mailing List notes X-Git-Tag: 2023-04~3 X-Git-Url: https://git.cinelerra-gg.org/git/?p=goodguy%2Fcin-manual-latex.git;a=commitdiff_plain;h=936402b387ebe7a11f5abc039312d5860d22bd53 Andrea improvement + Mailing List notes --- diff --git a/common/title.tex b/common/title.tex index b88b4d5..ef44c18 100644 --- a/common/title.tex +++ b/common/title.tex @@ -97,7 +97,7 @@ % The following is an example that needs to be adapted to the % respective conditions. % -Maintained and published by Phyllis Smith\\[+1.2em] +Maintained and published by Phyllis Smith (phylsmith2017@gmail.com)\\[+1.2em] Copyright~\copyright{} 2023 The \CGG{} Community\par Please report errors in the book to our \href{https://www.cinelerra-gg.org/bugtracker/}{bug tracker} or the \href{https://www.cinelerra-gg.org/forum/}{user forum}\par % Contributing authors: \textsc{Phyllis Smith, Andrea Paz, Andrey}\par diff --git a/parts/Quickstart.tex b/parts/Quickstart.tex index b5a951d..652e8be 100644 --- a/parts/Quickstart.tex +++ b/parts/Quickstart.tex @@ -301,8 +301,8 @@ High quality formats are also called Mezzanine codecs, Digital Intermediate, Pre \newline Presets: \textit{DNxHR, ffv1, AVC\_Intra\_100} \item[MOV] Created by Apple. It is a suitable format for editing because it organizes the files within the container into hierarchically structured \textit{atoms} described in a header. This brings simplicity and compatibility with various software and does not require continuous encoding/decoding in the timeline. \newline Presets: \textit{DNxHR, ffv1, CineformHD, huffyuv} - \item[PRO] Different extension, but it is still mov. Prores is proprietary and there are no official encoders except the original Adobe one. The engine used by ffmpeg is the result of reverse engineering and, according to Adobe, does not guarantee the same quality and performance of the original\protect\footnote{https://support.apple.com/en-us/HT200321}. - \newline Presets: \textit{ProRes} + \item[PRO] Different extension, but it is still mov. Prores is proprietary and there are no official encoders except the original Adobe one. The engine used by ffmpeg is the result of reverse engineering and, according to Adobe, does not guarantee the same quality and performance of the original\protect\footnote{https://support.apple.com/en-us/HT200321}. Option \textit{vendor=apl0} is used to make it appear that the original Apple engine was used. + \newline Presets: \textit{ProRes; ProRes\_ks} \item[QT] Different extension, but it is always mov. \newline Presets: \textit{DNxHD, magicyuv, raw, utvideo} \item[MP4] mostly used for General Purpose. It belongs to the large MPEG family. @@ -342,7 +342,7 @@ These are also called Delivery codecs. They are the most used and widespread bei \label{ssub:note_mkv_container} \index{mkv} -Matroska is a modern universal container that is Open Source so there is lots of ongoing development with community input along with excellent documentation. Also derived from this format is the \textit{Webm} container used by Google and YouTube, which use the VP8-9 and AV1 codecs. Although using in \CGG{} is highly recommended, you may have seeking problems during playback. The internal structure of matroskas is sophisticated but requires exact use of internal keyframes (I-frame; B-frame and P-frame) otherwise playback on the timeline may be subject to freeze and drop frames. The mkv format can be problematic if the source encoding is not done well by the program (for example, OBS Studio). For an easy but accurate introduction of codecs and how they work see: \url{https://ottverse.com/i-p-b-frames-idr-keyframes-differences-usecases/}. +Matroska is a modern universal container that is Open Source so there is lots of ongoing development with community input along with excellent documentation. Also derived from this format is the \textit{Webm} container used by Google and YouTube, which use the VP8-9 and AV1 codecs. Although using in \CGG{} is highly recommended, you may have seeking problems during playback. The internal structure of matroskas is sophisticated but requires exact use of internal keyframes (I-frame; B-frame and P-frame) otherwise playback on the timeline may be subject to freeze and drop frames. The mkv format can be problematic if the source encoding is not done well by the program (for example, OBS Studio). For an easy but accurate introduction of codecs and how they work see: {\small\url{https://ottverse.com/i-p-b-frames-idr-keyframes-differences-usecases/}}. To find out the keyframe type (I, P, B) of your media you can use ffprobe: @@ -366,7 +366,7 @@ To find out the keyframe type (I, P, B) of your media you can use ffprobe: \textbf{input.mkv:} is the media to be analyzed (it can be any container and codec). -(see \url{https://ffmpeg.org/ffprobe.html} for more details) +(see {\small\url{https://ffmpeg.org/ffprobe.html}} for more details) We thus obtain a list of all frames in the analyzed media and their type. For example: @@ -384,7 +384,7 @@ There are also 2 useful scripts that not only show the keyframe type but also sh {\small\url{https://cinelerra-gg.org/download/testing/iframe-probe_byUseSparingly.tar.gz}} We can now look at the timeline of \CGG{} to see the frames that give problems in playback. Using a codec of type Long GOP, it is probably the rare I-frames that give the freezes. -To find a solution you can use MKVToolNix (\url{https://mkvtoolnix.download/}) to correct and insert new keyframes into the mkv file (matroska talks about \textit{cues data}). It can be done even without new encoding. Or you can use the \texttt{Transcode} tool within \CGG{} because during transcoding new keyframes are created that should correct errors. +To find a solution you can use MKVToolNix ({\small\url{https://mkvtoolnix.download/}}) to correct and insert new keyframes into the mkv file (matroska talks about \textit{cues data}). It can be done even without new encoding. Or you can use the \texttt{Transcode} tool within \CGG{} because during transcoding new keyframes are created that should correct errors. \subsubsection{Image Sequences} \label{ssub:ffmpeg_image_sequences} diff --git a/parts/Trouble.tex b/parts/Trouble.tex index 8f8506a..dce311c 100644 --- a/parts/Trouble.tex +++ b/parts/Trouble.tex @@ -93,15 +93,21 @@ You can report potential problems, bugs, and crashes to the \CGG{} website at: \end{center} Here you can log the problem into the MantisBT bugtracker, or use the forum Q\&A for help from other users, or email the -problem using the address:{\small \href{mailto:cin@lists.cinelerra-gg.org}{cin@lists.cinelerra-gg.org}} It is usually more +problem to the Mailing List using the address:{\small \href{mailto:cin@lists.cinelerra-gg.org}{cin@lists.cinelerra-gg.org}}. It is usually more helpful if instead of starting \CGG{} from its application icon, start from a window so that if there are error messages related to the problem, they can be captured from the screen and emailed or logged. The command to run from a window is: \texttt{/bin/cin} -- for example if -installed in \texttt{/mnt0/build5/cinelerra-5.1}, you would execute the following command to start the program:\\ -\texttt{/mnt0/build5/cinelerra-5.1/bin/cin} \\ +installed in \texttt{/mnt0/build5/cinelerra-5.1}, you would execute the following command to start the program: +\newline \hspace*{1cm} \texttt{/mnt0/build5/cinelerra-5.1/bin/cin} \\ The problem you are experiencing may be as simple as an error due to the settings in your \texttt{\$HOME/.bcast5} subdirectory so you may want to first rename your current \texttt{.bcast5} in order to start with default settings. By renaming the directory instead of deleting it, you will be able to put it back and not lose all of your preferences. -However, there are some easy things to do to fix errors that may have resulted from media problems, +A note about using the Mailing List {\small \href{mailto:cin@lists.cinelerra-gg.org}{cin@lists.cinelerra-gg.org}} +is that to avoid receiving spam, it will require you to subscribe. But it is also easy to unsubscribe once you have +the information you need. The Mailing List, although routinely used by developers or contributors to discuss +changes, can provide more technical answers in some cases and the email goes directly to individuals who are quite +likely sitting at their computers depending on the timezone. + +There are some easy things to do to fix errors that may have resulted from media problems, computer problems, or operational missteps so you can proceed without having to wait for help. These are outlined in \ref{cha:when_things_go_wrong} - be sure to read down through \textit{Common Problems} where some exact error messages are mentioned along with their cause or solution. Other @@ -243,7 +249,7 @@ option "only allow with this IP address" needs to be disabled, then the bug trac \begin{enumerate} \item If you can not register your username in the website's Forum, it could be -because the protection measures against spammers also is in effect with real users, so sometimes the website blocks the registration for the forum. This often affects email addresses of well-known email providers. Send email to the mailing list (({\small \url{https://lists.cinelerra-gg.org/mailman/listinfo/cin}}) so that you can be added to the forum manually as long as +because the protection measures against spammers also is in effect with real users, so sometimes the website blocks the registration for the forum. This often affects email addresses of well-known email providers. Send email to the mailing list which requires you to subscribe (({\small \url{https://lists.cinelerra-gg.org/mailman/listinfo/cin}}) so that you can be added to the forum manually as long as you confirm that you agree with the terms of use of this website and the forum. \item In the website's Forum, use of unacceptable characters or strings can result in the error message "A potentially unsafe operation has been detected in your request to this site". You lose what