minor changes to attributions
[goodguy/cin-manual-latex.git] / parts / Introduction.tex
index a50836c3bf59439a4ba5272d891a93f3719e6029..dd36a8933a032238a7be5dabc5837404329452fc 100644 (file)
@@ -12,14 +12,23 @@ This manual covers the \CGG{} \INF{} version.  Information
 contained in this manual is a description of the \CGG{} program
 usage and was obtained from various sources to include different
 communication channels, emails, common knowledge, and write-ups as
-new features were added.  The author of the original
+new features were added.  The origin of this manual has always been present in the \CGG{} source code in the doc subdirectory as cinelerral.html and can be found at: \href{https://git.cinelerra-gg.org/git/?p=goodguy/cinelerra.git;a=blob;f=cinelerra-5.1/doc/cinelerra.html;h=f7742b50255d5412af5c4941c5be52bb556d99cd;hb=7fd85fb66168f6b518c5f2d73e04036e87faa0e1}{Secrets of Cinelerra} by the original author Adam Williams.
+Over time his manual was enhanced by Alex Ferrer with Adam's and Alex's work becoming the
+baseline for the CV manual and subsequently that combined work was mostly incorporated into this manual.
+Interestingly, starting from Secrets of Cinelerra which is about 122 full pages, to the CV manual
+of about 212 pages at the time it was incorporated here, this manual has now grown to over 780 pages.
+More information about the manual and source code contributions can be found here: \nameref{cha:contributors}.
+
+The author of the original
 \textsc{Cinelerra} program, Adam Williams, as well as many different
 people have modified the \textsc{Cinelerra} source code over the
-years.  William Morrow merged all of the known changes, whenever
-possible, into this \CGG{} version and has been adding numerous
+years.  William Morrow used Adam's source code as the  baseline and merged all of the known changes at the time, whenever
+possible, into this \CGG{} version and had been adding numerous
 features, updates, and fixes.
 
-{\small NOTE: This manual is a Work in Progress: monthly parts are added to cover the new features introduced in \CGG{}. The texts are continuously revised to make them clearer and more complete. In order to have a better and better product we rely on the suggestions and criticisms of our readers. Do not hesitate to let us know your opinions. For this continuous variability, we recommend that you download the manual at least once a month, during the release of \CGG{}, so that its content is always up to date.}
+{\small \textbf{NOTE1:} This manual is a Work in Progress: monthly parts are added to cover the new features introduced in \CGG{}. The texts are continuously revised to make them clearer and more complete. In order to have a better and better product we rely on the suggestions and criticisms of our readers. Do not hesitate to let us know your opinions. For this continuous variability, we recommend that you download the manual at least once a month, during the release of \CGG{}, so that its content is always up to date.
+
+\textbf{NOTE2}: this manual, in the HTML version present on the website, is the base of the \textit{Context Help} that can be called inside the program. For each window, button and plugins we can open the relative web page of the manual with \texttt{ALT/h} keys. More details in \nameref{sec:help_context_help}.}
 
 The \CGG{} software is under
 \href{https://www.gnu.org/licenses/old-licenses/gpl-2.0-standalone.html}{GPLv2+}
@@ -56,12 +65,6 @@ the \emph{current state} of Linux software, enhanced with additional
 imagined by dedicated users and then implemented by professional
 programmers.
 
-\textit{Context Help} when using \CGG{} accesses pages of the HTML
-version of this manual when requested.  A relevant section of the manual
-can be quickly recalled in the user's configured web browser window by
-pointing with the mouse on the GUI item of interest and pressing the
-hotkey Alt/h. For more detailed information see \ref{sec:help_context_help}.
-
 \begin{description}
     \item[Website] \href{https://www.cinelerra-gg.org}{https://www.cinelerra-gg.org}\\
         The website for the cinelerra-gg software is a good place to start for information, help, and documentation.
@@ -139,13 +142,16 @@ hotkey Alt/h. For more detailed information see \ref{sec:help_context_help}.
                     \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 File by Reference; To be able to modify the original source during editing (which, in this case, becomes destructive).
+                   \item File by Reference; To be able to modify the original source during editing (which in this case, becomes destructive).
                     \item The Vectorscope option in the Videoscope plugin allows for the use of any number of user-supplied grid patterns as an Overlay.
                     \item Hardware acceleration with vaapi and vdpau for computers with graphics hardware meeting certain criteria.
                     \item Bump Autos is a new type of keyframe automation that allows you to easily create and manage keyframes intervals in Speed, Fade and Camera/Projector-XYZ curves.
+                   \item One of the only Linux NLEs that handles and renders RGB, 444, 422 and 420 at 8, 10 and more-bit footage as opposed to working in only 8-bit (which introduces some artifacts like banding); both in Full Range Color and limited Broadcast Range Color.
                 \end{itemize}
 \end{description}
 
+\paragraph{NOTE:}  In \CGG{} the editing workflow is different from the workflow used by other NLEs. It is less intuitive and requires us to think first about what we want to achieve. In fact, it is a workflow based on the tracks in their entirety and not on individual clips. See \href{https://cinelerra-gg.org/download/Workflow.pdf}{workflow        is different!} for a comparison with the Adobe Premiere Pro workflow.
+
 \section*{Chapters Overview}%
 \label{sec:chapters_overview}