Credit Andrea - new color wheel image and explanation for ChromaKeyHSV
[goodguy/cin-manual-latex.git] / parts / Loadandsave.tex
index 1009912b52e6a5cd09dfde399e0c13e221107a5d..f8a0186cdb7179d89828e199d8d6582fd13ec939 100644 (file)
@@ -4,6 +4,8 @@
 \index{save media files}
 \index{EDL}
 
+The media files loaded into the Resources window are called \textit{assets} and are virtual references to the real media files on disk. The original sources are not changed and so we have non-destructive editing.
+
 There are many supported file formats that can be loaded and rendered to, that is to say, imported and exported. 
 The format of the file affects what \CGG{} does with it.  
 Some file formats are very slow to display on the timeline, especially video which is highly compressed.  
@@ -37,7 +39,7 @@ Microsoft WAV,
 Raw DV and PCM,
 MPEG Audio and Video.
 
-\paragraph{Still Images:}  JPEG/EXR/PNG/PPM/TGA/TIFF
+\paragraph{Still Images:}  JPEG/EXR/GIF/PNG/PPM/TGA/TIFF. Note: even if \CGG{} outputs fp32, exr/tiff values there are normalized to 0-1.0f.
 
 \paragraph{MPEG Files:} 
 What is an MPEG file?  A very common file format is MPEG because it works with many cameras and televisions.  Mpeg2 video, an elementary codec stream for mpeg files, is the most common format.  To read this format you need to decode the mpeg stream.  You can read and write mpeg natively.  Mpeg video encoding is done separately from mpeg audio encoding when using the native file format, meaning that 2 passes are required and then they have to be muxed together.  However, if using ffmpeg it is rendered in only 1 pass.  DVD uses MPEG as does NTSC and Pal.
@@ -74,31 +76,30 @@ File lists formats can be utilized in some way for the following list of types o
 \begin{center}
     \begin{tabular}{l l l l}
     PNGLIST = *.png    &       PPMLIST = *.ppm &       TGALIST = *.tga   &  TIFFLIST = *.tiff \\
-    EXALIST = *.exa    &       CR2LIST = *.cr2 &       JPEGLIST = *.jpg        &    GIFLIST = *.gif
+    EXRLIST = *.exr    &       CR2LIST = *.cr2 &       JPEGLIST = *.jpg        &    GIFLIST = *.gif
     \end{tabular}
 \end{center}
 
 %\vspace*{1ex} 
-Using the example of jpeg’s, the jpeg list sequence file type is the easiest and fastest way to access a sequence of jpg images as a single asset.  First build a jpeglist sequence file and name it something like jpeglist.sh.  There is an example script of how to do this in the Auxiliary Programs section of the Appendix (\ref{sec:image_sequence_creation}).  Once the jpeglist.sh file is built you can then run it similar to this line:
+Using the example of jpeg’s, the jpeg list sequence file type is the easiest and fastest way to access a sequence of jpg images as a single asset.  First build a jpeglist sequence file and name it something like jpeglist.sh.  There is an example script of how to do this in the Auxiliary Programs section of the Appendix (\ref{sec:image_sequence_creation}).  Once the jpeglist.sh file is built and made executable you can then run it similar to this line:
 
 \begin{lstlisting}[style=sh]
-jpeglist.sh   /<path>/file.jpg   /<path>/DSC*.jpg
+./jpeglist.sh   /<same_path>/outputfile.jpgs   /<same_path>/inputfilesDSC*.jpg
 \end{lstlisting}
 
-\vspace*{1ex} \noindent If <\texttt{path}> is the same on both outfile and infiles, then file.jpg is created in the same directory as infiles, the directory contains the entire asset, and the file list uses relative paths; otherwise the file list contains absolute paths.   Since this creates outfile list as a single asset, the memory demand and access time is much lower.  When you load the outfile in \CGG{}, you will need to set \textit{Try ffmpeg last} since ffmpeg does not work with jpeglist sequence files.
-
-An example output file from running this script residing in the directory where \texttt{DSC*.jpg} files exist is shown below.
+\vspace*{1ex} \noindent The <\texttt{path}> must be the same on both outputfile and inputfiles so that they can be successfully loaded in \CGG{}.  Since this creates outputfile list as a single asset, the memory demand and access time is much lower.  When you load the outputfile in \CGG{}, you might need to set \textit{Try ffmpeg last} if ffmpeg does not work with that particular type of sequence files.
 
-To use this, turn off ffmpeg probes first, and open \texttt{timelapse.jpg} using File $\rightarrow$ Load files.
+An example output file from running this script residing in the directory where \texttt{DSC*.jpg} files exist is shown below.  To use this, turn off ffmpeg probes first, and open \texttt{outputfile.jpgs} using File $\rightarrow$ Load files.  Of course, you can edit this file to change frame rate or names of files to include. 
+The width and height should always be the same size for each included file and the file type must be the same.  For example, if you include a JPEG file in a GIF list, you will get undesirable results.
 
-\begin{lstlisting}[style=sh,caption={Example: timelapse.jpg},captionpos=t]
+\begin{lstlisting}[style=sh,caption={Example: outputfile.jpgs},captionpos=t]
 JPEGLIST
-# First line is always JPEGLIST
+# First line is always JPEGLIST and all files must be JPEGs
 # Frame rate:
 29.970030
-# Width:
+# Width - all files must be the same size in width:
 6016
-# Height:
+# Height - all files must be the same size in height:
 4016
 # List of image files follows
 ./DSC04948.jpg
@@ -110,6 +111,10 @@ JPEGLIST
 ./DSC04998.jpg
 \end{lstlisting}
 
+Another advantage of using image sequences of exr, jpeg, png, ppm tiff, and tga is that if you
+then render to anoher of the same sequence type, a direct copy speed up can be used for any
+of the unmodified frames.
+
 \subsubsection{Image2ffmpeg}%
 \label{ssub:image2ffmpeg}
 \index{image sequence}