Olaf changes + a couple of rewordings
[goodguy/cin-manual-latex.git] / parts / Attributes.tex
index 79f74f3c5488e99dea92b3955736a19aabcdf4e8..51b84d7da558bb4eb9eb003e9146b5dce0f387e3 100644 (file)
@@ -1,7 +1,7 @@
 \chapter{Project and Media Attributes}%
 \label{cha:project_and_media_attributes}
 
-When you play media files in Cinelerra, the media files have a certain number of tracks, frame size, sample size, and so on. 
+When you play media files in \CGG{}, the media files have a certain number of tracks, frame size, sample size, and so on. 
 No matter what attributes the media file has, it is played back according to the project attributes. 
 So, if an audio file's sample rate is different than the project attributes, it is resampled. 
 Similarly, if a video file's frame size is different than the project attributes, the video is composited on a black frame, either cropped or bordered with black.
@@ -14,12 +14,12 @@ But every timeline created from this point uses the same settings.
 
 \begin{figure}[htpb]
        \centering
-       \includegraphics[width=0.5\linewidth]{images/set-format.png}
+       \includegraphics[width=0.5\linewidth]{set-format.png}
        \caption{Set Format window - note the Audio Channel positions}
        \label{fig:set-format}
 \end{figure}
 
-In addition to the standard settings for sample rate, frame rate, and frame size, Cinelerra uses some less traditional settings like channel positions, color model, and aspect ratio.  
+In addition to the standard settings for sample rate, frame rate, and frame size, \CGG{} uses some less traditional settings like channel positions, color model, and aspect ratio.  
 The aspect ratio refers to the screen aspect ratio.
 
 Edit decision lists , the EDL stored in XML, save the project settings.  
@@ -32,7 +32,7 @@ Mostly notably is the field for a directory path and a Project Name.
 
 \begin{figure}[htpb]
        \centering
-       \includegraphics[width=0.5\linewidth]{images/new-project.png}
+       \includegraphics[width=0.5\linewidth]{new-project.png}
        \caption{New Project dialog window}
        \label{fig:new-project}
 \end{figure}
@@ -106,30 +106,31 @@ Explanation of the various fields is described next.
         if this option is checked, the Set Format dialog always recalculates the Aspect ratio setting based upon the given Canvas size. This ensures pixels are always square.
 
     \item[Color model:]
-        the project will be stored in the color model video that is selected in the dropdown.  
+        the internal color space of \CGG{} is X11 sRGB without color profile. \CGG{} always switches to sRGB when applying filters or using the compositing engine. Different case for decoding/playback or encoding/output; the project will be stored in the color model video that is selected in the dropdown.  
         Color model is important for video playback because video has the disadvantage of being slow compared to audio.  
         Video is stored on disk in one colormodel, usually a YUV derivative. 
-        When played back, Cinelerra decompresses it from the file format directly into the format of the output device. 
+        When played back, \CGG{} decompresses it from the file format directly into the format of the output device. 
         If effects are processed, the program decompresses the video into an intermediate colormodel first and then converts it to the format of the output device. 
         The selection of an intermediate colormodel determines how fast and accurate the effects are.  
         A list of the current colormodel choices follows.
 
         \begin{description}
             \item[RGB-8 bit] 
-                Allocates 8 bits for the R, G, and B channels and no alpha. This is normally used for uncompressed media with low dynamic range.
+                Allocates 8\,bits for the R, G, and B channels and no alpha. This is normally used for uncompressed media with low dynamic range.
             \item[RGBA-8 bit]
-                Allocates an alpha channel to the 8 bit RGB colormodel. It can be used for overlaying multiple tracks.\\
+                Allocates an alpha channel to the 8\,bit RGB colormodel. It can be used for overlaying multiple tracks.\\
             \item[RGB-Float]
-                Allocates a 32 bit float for the R, G, and B channels and no alpha. This is used  for high dynamic range processing with no transparency.
+                Allocates a 32\,bit float for the R, G, and B channels and no alpha. This is used  for high dynamic range processing with no transparency.
             \item[RGBA-Float]
-                This adds a 32 bit float for alpha to RGB-Float. It is used for high dynamic range processing with transparency.\\
+                This adds a 32\,bit float for alpha to RGB-Float. It is used for high dynamic range processing with transparency. Or when we don't want to lose data during workflow, for example in color correction, key extraction and motion tracking. \\
             \item[YUV-8 bit]
-                Allocates 8 bits for Y, U, and V. This is used for low dynamic range operations in which the media is compressed in the YUV color space. Most compressed media is in YUV and this derivative allows video to be processed fast with the least color degradation.
+                Allocates 8\,bits for Y, U, and V. This is used for low dynamic range operations in which the media is compressed in the YUV color space. Most compressed media is in YUV and this derivative allows video to be processed fast with the least color degradation.
             \item[YUVA-8 bit]
-                Allocates an alpha channel to the 8 bit YUV colormodel for transparency.
+                Allocates an alpha channel to the 8\,bit YUV colormodel for transparency.
+        \end{description}       
                 In order to do effects which involve alpha channels, a colormodel with an alpha channel must be selected. 
                 These are RGBA-8 bit, YUVA-8 bit, and RGBA-Float. 
-                The 4 channel colormodels are slower than 3 channel colormodels, with the slowest being RGBA-Float. 
+                The 4 channel colormodels are slower than 3\,channel colormodels, with the slowest being RGBA-Float. 
                 Some effects, like fade, work around the need for alpha channels while other effects, like chromakey, require an alpha channel in order to be functional.  
                 So in order to get faster results, it is always a good idea to try the effect without alpha channels to see if it works before settling on an alpha channel and slowing it down.
 
@@ -140,7 +141,7 @@ Explanation of the various fields is described next.
                 16 bit integers were used in the past and were too lossy and slow for the amount of improvement.  
                 RGB float does not destroy information when used with YUV source footage and also supports brightness above 100\,\%. 
                 Be aware that some effects, like Histogram, still clip above 100\,\% when in floating point.
-        \end{description}
+        
     \item[Interlace mode:]
         this is mostly obsolete in the modern digital age, but may be needed for older media such as that from broadcast TV.  Interlacing uses two fields to create a frame. One field contains all odd-numbered lines in the image; the other contains all even-numbered lines.  Interlaced fields are stored in alternating lines of interlaced source footage. The alternating lines missing on each output frame are interpolated.
 \end{description}