parts/Attributes.tex

   1 \chapter{Project and Media Attributes}%
   2 \label{cha:project_and_media_attributes}
   3
   4 When you play media files in \CGG{}, the media files have a certain
   5 number of tracks, frame size, sample size, and so on.  No matter
   6 what attributes the media file has, it is played back according to
   7 the project attributes.  So, if an audio file's sample rate is
   8 different than the project attributes, it is resampled.  Similarly,
   9 if a video file's frame size is different than the project
  10 attributes, the video is composited on a black frame, either cropped
  11 or bordered with black.
  12
  13 The project attributes are adjusted in \texttt{file $\rightarrow$
  14 Set Format} (figure~\ref{fig:set-format}) or can be created in
  15 \texttt{File $\rightarrow$ New}.  When you adjust project settings
  16 in \texttt{File $\rightarrow$ New}, a new empty timeline is created.
  17 Every timeline created from this point on uses the same settings.
  18 When you adjust settings in \texttt{Settings $\rightarrow$ Format},
  19 media on the timeline is left unchanged.  But every timeline created
  20 from this point uses the same settings.
  21
  22 \begin{figure}[htpb]\centering
  23 \includegraphics[width=0.6\linewidth]{set-format.png}
  24   \caption{Set Format window - note the Audio Channel positions}
  25   \label{fig:set-format}
  26 \end{figure}
  27
  28 In addition to the standard settings for sample rate, frame rate,
  29 and frame size, \CGG{} uses some less traditional settings like
  30 channel positions, color model, and aspect ratio.  The aspect ratio
  31 refers to the screen aspect ratio.
  32
  33 Edit decision lists , the EDL stored in XML, save the project
  34 settings.  Formats which contain media but no edit decisions just
  35 add data to the tracks.  Keep in mind details such as if your
  36 project sample rate is 48\,kHz and you load a sound file with
  37 96\,kHz, you will still be playing it at 48\,kHz.  Or if you load an
  38 EDL file at 96\,kHz and the current project sample rate is 48\,kHz,
  39 you will change it to 96\,kHz.
  40
  41 The New Project window has some options that are different than the
  42 Set Format window as you can see by comparing
  43 figure~\ref{fig:set-format} above with this
  44 figure~\ref{fig:new-project}.  Mostly notably is the field for a
  45 directory path and a Project Name.
  46
  47 \begin{figure}[htpb] \centering
  48 \includegraphics[width=0.7\linewidth]{new-project.png}
  49   \caption{New Project dialog window}
  50   \label{fig:new-project}
  51 \end{figure}
  52
  53 Explanation of the various fields is described next.
  54
  55 \section{Audio attributes}%
  56 \label{sec:audio_attributes}
  57
  58
  59 \begin{description}
  60 \item[Presets:] select an option from this menu to have all the
  61 project settings set to one of the known standards.  Some of the
  62 options are 1080P/24, 1080I, 720P/60, PAL, NTSC, YouTube, and CD
  63 audio.
  64
  65 \item[Tracks:] (in New Project menu only) sets the number of audio
  66 tracks for the new project. Tracks can be added or deleted later,
  67 but this option is on the New Project menu for convenience.
  68
  69 \item[Samplerate:] sets the samplerate of the audio. The project
  70 samplerate does not have to be the same as the media sample rate
  71 that you load. Media is resampled to match the project sample rate.
  72
  73 \item[Channels:] sets the number of audio channels for the new
  74 project. The number of audio channels does not have to be the same
  75 as the number of tracks.
  76
  77 \item[Channel positions:] the currently enabled audio channels and
  78 their positions in the audio panning boxes in the track patchbay are
  79 displayed in the channel position widget in the Set Format window.
  80 You can see this display on the left side in
  81 figure~\ref{fig:set-format} above.  Channel positions are not in New
  82 Project window.
  83
  84   The channels are numbered.  When rendered, the output from channel
  85 1 is rendered to the first output track in the file or the first
  86 sound card channel of the sound card.  Later channels are rendered
  87 to output tracks numbered consecutively.  The audio channel
  88 positions correspond to where in the panning widgets each of the
  89 audio outputs is located.  The closer the panning position is to one
  90 of the audio outputs, the more signal that speaker gets.  Click on a
  91 speaker icon and drag to change the audio channel location.  The
  92 speakers can be in any orientation.  A different speaker arrangement
  93 is stored for every number of audio channels since normally you do
  94 not want the same speaker arrangement for different numbers of
  95 channels.
  96
  97   Channel positions is the only setting that does not affect the
  98 output necessarily.  It is merely a convenience, so that when more
  99 than two channels are used, the pan controls on the timeline can
 100 distinguish between them.  It has nothing to do with the actual
 101 arrangement of speakers.  Different channels can be positioned very
 102 close together to make them have the same output.
 103 \end{description}
 104
 105
 106 \section{Video attributes}%
 107 \label{sec:video_attributes}
 108
 109 \begin{description}
 110 \item[Tracks:] (in New Project menu only) sets the number of video
 111 tracks the new project is assigned.  Tracks can be added or deleted
 112 later, but options are provided here for convenience.
 113
 114 \item[Framerate:] sets the framerate of the video.  The project
 115 framerate does not have to be the same as an individual media file
 116 frame rate that you load.  Media is reframed to match the project
 117 framerate.
 118
 119 \item[Canvas size:] sets the size of the video output.  In addition,
 120 each track also has its own frame size.  Initially, the New Project
 121 dialog creates video tracks whose size match the video output.  The
 122 video track sizes can be changed later without changing the video
 123 output.
 124
 125 \item[Aspect ratio:] sets the aspect ratio; this aspect ratio refers
 126 to the screen aspect ratio.  The aspect ratio is applied to the
 127 video output.  The aspect ratio can be different than the ratio that
 128 results from the formula: $\dfrac{h}{v}$ (the number of horizontal
 129 pixels divided into the number of vertical pixels).  If the aspect
 130 ratio differs from the results of the formula above, your output
 131 will be in non-square pixels.
 132
 133 \item[Auto aspect ratio:] if this option is checked, the Set Format
 134 dialog always recalculates the Aspect ratio setting based upon the
 135 given Canvas size. This ensures pixels are always square.
 136
 137 \item[Color model:] the internal color space of \CGG{} is X11 sRGB
 138 without color profile. \CGG{} always switches to sRGB when applying
 139 filters or using the compositing engine. Different case for
 140 decoding/playback or encoding/output; the project will be stored in
 141 the color model video that is selected in the dropdown.  Color model
 142 is important for video playback because video has the disadvantage
 143 of being slow compared to audio.  Video is stored on disk in one
 144 colormodel, usually a YUV derivative.  When played back, \CGG{}
 145 decompresses it from the file format directly into the format of the
 146 output device.  If effects are processed, the program decompresses
 147 the video into an intermediate colormodel first and then converts it
 148 to the format of the output device.  The selection of an
 149 intermediate colormodel determines how fast and accurate the effects
 150 are.  A list of the current colormodel choices follows.
 151
 152   \begin{description}
 153   \item[RGB-8 bit] Allocates 8\,bits for the R, G, and B channels
 154 and no alpha. This is normally used for uncompressed media with low
 155 dynamic range.
 156   \item[RGBA-8 bit] Allocates an alpha channel to the 8\,bit RGB
 157 colormodel. It can be used for overlaying multiple tracks.
 158   \item[RGB-Float] Allocates a 32\,bit float for the R, G, and B
 159 channels and no alpha. This is used for high dynamic range
 160 processing with no transparency.
 161   \item[RGBA-Float] This adds a 32\,bit float for alpha to
 162 RGB-Float. It is used for high dynamic range processing with
 163 transparency. Or when we don't want to lose data during workflow,
 164 for example in color correction, key extraction and motion
 165 tracking.
 166   \item[YUV-8 bit] Allocates 8\,bits for Y, U, and V. This is used
 167 for low dynamic range operations in which the media is compressed in
 168 the YUV color space. Most compressed media is in YUV and this
 169 derivative allows video to be processed fast with the least color
 170 degradation.
 171   \item[YUVA-8 bit] Allocates an alpha channel to the 8\,bit YUV
 172 colormodel for transparency.
 173   \end{description} In order to do effects which involve alpha
 174 channels, a colormodel with an alpha channel must be selected.
 175 These are RGBA-8 bit, YUVA-8 bit, and RGBA-Float.  The 4 channel
 176 colormodels are slower than 3\,channel colormodels, with the slowest
 177 being RGBA-Float.  Some effects, like fade, work around the need for
 178 alpha channels while other effects, like chromakey, require an alpha
 179 channel in order to be functional.  So in order to get faster
 180 results, it is always a good idea to try the effect without alpha
 181 channels to see if it works before settling on an alpha channel and
 182 slowing it down.
 183
 184   When using compressed footage, YUV colormodels are usually faster
 185 than RGB colormodels.  They also destroy fewer colors than RGB
 186 colormodels.  If footage stored as JPEG or MPEG is processed many
 187 times in RGB, the colors will fade whereas they will not fade if
 188 processed in YUV\@.  Years of working with high dynamic range footage
 189 has shown floating point RGB to be the best format for high dynamic
 190 range.  16 bit integers were used in the past and were too lossy and
 191 slow for the amount of improvement.  RGB float does not destroy
 192 information when used with YUV source footage and also supports
 193 brightness above 100\,\%.  Be aware that some effects, like
 194 Histogram, still clip above 100\,\% when in floating point.
 195
 196 \item[Interlace mode:] this is mostly obsolete in the modern digital
 197 age, but may be needed for older media such as that from broadcast
 198 TV\@.  Interlacing uses two fields to create a frame. One field
 199 contains all odd-numbered lines in the image; the other contains all
 200 even-numbered lines.  Interlaced fields are stored in alternating
 201 lines of interlaced source footage. The alternating lines missing on
 202 each output frame are interpolated.
 203 \end{description}
 204
 205 %%% Local Variables:
 206 %%% mode: latex
 207 %%% TeX-master: "../CinelerraGG_Manual"
 208 %%% End: