update image sequence list creationg
[goodguy/cin-manual-latex.git] / parts / AuxilaryPrograms.tex
index 033a0037d438a4c90bc916e7a85abf0d95a17f80..1385c58e6c3102cc17481aa49f3390789a79376a 100644 (file)
@@ -60,18 +60,21 @@ Now render yourfile using different quality levels and run ydiff to compare the
 \label{sec:image_sequence_creation}
 \index{image sequence}
 
-Example script to create a jpeglist sequence file is next:
+Example script to create a jpeglist sequence file is next.  It can be modified to instead
+create a list for \textit{exr}, \textit{gif}, \textit{ppm}, \textit{png}, \textit{tga}, or \textit{tiff}
+sequences instead by changing JPEGLIST
+to be EXRLIST, GIFLIST, PPMLIST, PNGLIST, TGALIST, or TIFFLIST.
 \begin{lstlisting}[numbers=none]
 #!/bin/bash
 out="$1"
 dir=$(dirname "$out")
 shift
-geom=$(jpegtopnm "$1" | head -2 | tail -1)
+geom=$(anytopnm "$1" | head -2 | tail -1)
 w="$(echo $geom | cut -d " " -f1)"
 h="$(echo $geom | cut -d " " -f2)"
 exec > $out
 echo "JPEGLIST"
-echo "# First line is always JPEGLIST"
+echo "# First line is always format_typeLIST"
 echo "# Frame rate:"
 echo "29.970030"
 echo "# Width:"
@@ -90,10 +93,15 @@ while [ $# -gt 0 ]; do
 done
 \end{lstlisting}
 To use this script, you will have to install the package on your operating system that
-includes \textit{jpegtopnm} which is ususally \textit{netpbm}.
+includes \textit{anytopnm} which is ususally \textit{netpbm}.
 Example usage of this script follows:
 
-\qquad \texttt{jpeglist.sh outfile infiles*.jpg}
+\qquad \texttt{./jpeglist.sh outfile infiles/*.jpg}
+
+where \textit{jpeglist.sh} is just the name chosen for this script which could
+be anything but has to be executable, \textit{outfile} is the sequence list
+that is created, \textit{infiles} is the directory containing the 
+format\_type files such as \textit{jpg} in this example.
 
 \section{Details about .bcast5 Files}
 \label{sec:details_.bcast5_files}
@@ -109,7 +117,7 @@ The following extensions of files in \CGG{}'s \texttt{.bcast5} directory are exp
        \item [.rc] rc stands for \textit{run commands} so basically represents a script
        \item [.toc] toc is \textit{table of contents} file for MPEG video files (a type of index)
        \item [Cinelerra\_plugins] a list of the currently loaded plugins available in your \CGG{} session
-       \item [Cinelerra{}\_rc] the user's preferences and settings are saved in this file to be used on startup
+       \item [Cinelerra{}\_rc] the user's preferences and settings are saved in this file to be used on startup.  This file can be carefully edited to change startup values for certain parameters, but if you inadvertently set up something incorrectly, you may end up crashing the program.
        \item [ladspa\_plugins{\dots}] list of currently loaded ladspa plugins for each version of \CGG{} being used
        \item [layout\#...\_rc] user-defined window layout setup with the layout name as part of the file name
        \item [.xml] used for various backups or for the current settings of plugins that you have used