SGE work to get Glossary working +
[goodguy/cin-manual-latex.git] / parts / Introduction.tex
index 4a68dd40ea19bd462a2fdb9f8fb8e55d14063055..55f131d2bd37054c47934dd92135eed354311e8a 100644 (file)
@@ -16,49 +16,34 @@ new features were added.  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 for several years has been
-adding numerous features, updates, and fixes.  All of these software
-contributions are appreciated and each individual is thanked and
-commended for their efforts.  The \CGG{} software is under \href{https://www.gnu.org/licenses/old-licenses/gpl-2.0-standalone.html}{GPLv2+}
-license.
-
-As for this manual, the
-\href{https://www.gnu.org/licenses/fdl-1.3.en.html}{GNU Free
-  Documentation License} (GNU FDL or simply GFDL) is a copyleft
-license for free documentation, designed by the Free Software
-Foundation (FSF) for the GNU Project. It is similar to the GNU
-General Public License, giving readers the rights to copy,
-redistribute, and modify (except for ``variant sections'') a work
-and requires all copies and derivatives to be available under the
-same license.  The GFDL was designed for manuals, textbooks, other
-reference and instructional materials, and documentation which often
-accompanies GNU software.
-
-% FIXME The sense behind this is not apparent.
-% \textbf{This is a copy of the header from the original source code.}
-% % \begin{lstlisting}[basicstyle=\footnotesize]
-% {\small
-% \begin{verbatim}
-% *
-% * CINELERRA
-% * Copyright (C) 1997-2012 Adam Williams <broadcast at earthling dot net>
-% *
-% * This program is free software; you can redistribute it and/or modify
-% * it under the terms of the GNU General Public License as published by
-% * the Free Software Foundation; either version 2 of the License, or
-% * (at your option) any later version.
-% *
-% * This program is distributed in the hope that it will be useful,
-% * but WITHOUT ANY WARRANTY; without even the implied warranty of
-% * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
-% * GNU General Public License for more details.
-% *
-% * You should have received a copy of the GNU General Public License
-% * along with this program; if not, write to the Free Software
-% * Foundation, Inc., 59 Temple Place, Suite 330, Boston
-% \end{verbatim}
-% % \end{lstlisting}
-% }
+possible, into this \CGG{} version and has 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.}
+
+The \CGG{} software is under
+\href{https://www.gnu.org/licenses/old-licenses/gpl-2.0-standalone.html}{GPLv2+}
+license. A notice of this is included in the software and shown here.
+
+\begin{lstlisting}[basicstyle=\footnotesize]
+*
+* CINELERRA
+* Copyright (C) 1997-2012 Adam Williams <broadcast at earthling dot net>
+*
+* This program is free software; you can redistribute it and/or modify
+* it under the terms of the GNU General Public License as published by
+* the Free Software Foundation; either version 2 of the License, or
+* (at your option) any later version.
+*
+* This program is distributed in the hope that it will be useful,
+* but WITHOUT ANY WARRANTY; without even the implied warranty of
+* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+* GNU General Public License for more details.
+*
+* You should have received a copy of the GNU General Public License
+* along with this program; if not, write to the Free Software
+* Foundation, Inc., 59 Temple Place, Suite 330, Boston
+\end{lstlisting}
 
 \section*{\CGG{} Overview}%
 \label{sec:cinelerra_overview}
@@ -139,12 +124,17 @@ programmers.
             \item[Innovative New Features]~\\
                 \begin{itemize}
                     \item Inter-View mode as invented through a collaborative effort by a user and the developer.
-                    \item Proxy settings for large formatted media with the coveted Scalar option and proxy quick switch.
+                    \item Proxy settings for large formatted media with the coveted Scalar option and proxy quick switch.  Includes a 1:1 proxy setting used to save CPU time with a reduced bitrate.
                     \item Multiple cameras / Mixer Viewer with the number of cameras only limited by the resources on the user’s computer (on a large system, 50 are known to work).
+                    \item Audio/Video sync via waveforms, or timecodes to include syncing with externally recorded audio.
                     \item DVD/bluray creation, editing, and copying for non-commercial media greatly enhanced for usability.
                     \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 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.
                 \end{itemize}
 \end{description}
 
@@ -172,15 +162,20 @@ And which chapters are important for beginning to learn to use \CGG{}. At the en
 
     \item[Chapter~\ref{cha:load_save_and_the_EDL}] \nameref{cha:load_save_and_the_EDL}.
 
+               The EDL is the list of changes that \CGG{} would make to the original media in order to produce the desired output
         Since this is important to not losing your work, you should read this chapter for some basic usage concepts and for some lesser used functions that may come in handy.
         Besides how to Load and Save files, there is also information on using raw camera formats.
-        Helpful hints on working with image sequences, such as a bunch of pictures from your camera all loaded at once, is a time saver.
-
+        Helpful hints on working with image sequences, such as a bunch of pictures from your camera all loaded at once, is a time saver. Understanding that the EDL is the list of changes that would be made to the original media in order to produce the desired output is key to ensuring that that media remains intact.
+        
     \item[Chapter~\ref{cha:editing}] \nameref{cha:editing}.
 
         New and occasional users will find it necessary to read this chapter. However, you can decide which editing mode you prefer and concentrate on reading that section.
         Even seasoned users will want to read this chapter in order to take advantage of features that have been newly implemented or may be less familiar due to infrequent usage.
         Anyone who wants the editing capabilities that comes with use of the Shuttle Jog Wheel, will initially need to read that section to become familiar with its usage.
+        
+     \item[Chapter~\ref{cha:advanced_editing}] \nameref{cha:advanced_editing}.
+     
+       Many tools for the advanced editing: Proxy, Nesting; Trimming; Multi-Cam; Audio/Video sync and Transcoding. \CGG{} offers many possibilities and sophisticated alternatives for editing, but they are complex tools. Here we deepen their knowledge and use.
 
     \item[Chapter~\ref{cha:rendering}] \nameref{cha:rendering}.
 
@@ -192,7 +187,7 @@ And which chapters are important for beginning to learn to use \CGG{}. At the en
     \item[Chapter~\ref{cha:keyframes}] \nameref{cha:keyframes}.
 
         This is a more advanced topic but extremely useful to know.
-        Keyframes are data values that have been associated to the timeline that affect the media presentation.
+        Keyframes are data values that have been associated to media on the timeline that affect the media presentation.
         You can go for years without knowing all of the nuances but you will most likely have a need to use and understand them sooner or later.
 
     \item[Chapter~\ref{cha:ffmpeg_interactions}] \nameref{cha:ffmpeg_interactions}.
@@ -219,18 +214,13 @@ And which chapters are important for beginning to learn to use \CGG{}. At the en
 
     \item[Chapter~\ref{cha:capturing_recording_media}] \nameref{cha:capturing_recording_media}.
 
-        This chapter is helpful in learning how to capture and record media from various sources.  A section on using \CGG{} with broadcast TV is especially useful.
+        This chapter is helpful in learning how to capture and record media from various sources.  A section on using \CGG{} with broadcast TV (NTSC) is especially useful.
 
     \item[Chapter~\ref{cha:dvd_bluray_creation}] \nameref{cha:dvd_bluray_creation}.
 
         If this is what you want to do, then read this chapter.
         In the case of DVD media creation it includes many examples and lots of tips for checking your methods.
 
-    \item[Chapter~\ref{cha:multi_5}] \nameref{cha:multi_5}.
-
-        For using multiple cameras in your video creation, this chapter is a must read. Otherwise, just refer
-        to the section that becomes pertinent as you familiarize yourself with using \CGG{}.
-
     \item[Chapter~\ref{cha:shortcuts}] \nameref{cha:shortcuts}.
 
         Everyone will want to use this chapter to speed up their editing sessions.
@@ -270,6 +260,10 @@ And which chapters are important for beginning to learn to use \CGG{}. At the en
     \item[Appendix~\ref{cha:auxiliary_programs}] \nameref{cha:auxiliary_programs}.
 
         This is a catch-all for any useful programs that may need to be included, mostly for analysis.
+        
+     \item[Appendix~\ref{cha:editing_real_world_usage}] \nameref{cha:editing_real_world_usage}.
+    
+       Our users illustrate in-depth examples of their workflows by showing their editing in real use cases.
 
 \end{description}