minor fixes for image sequences

[goodguy/cin-manual-latex.git] / parts / AuxilaryPrograms.tex

diff --git a/parts/AuxilaryPrograms.tex b/parts/AuxilaryPrograms.tex
index 033a0037d438a4c90bc916e7a85abf0d95a17f80..ef98f7a76bd753692a74a69a3c796692ff7cb450 100644 (file)
--- a/parts/AuxilaryPrograms.tex
+++ b/parts/AuxilaryPrograms.tex
@@ -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 jpeg list sequence file is next.  It can be modified to
+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,17 @@ 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{./imagelist.sh outfile infiles/*.jpg}
+
+where \textit{imagelist.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. The xxxtopnm
+messages that show up can just be ignored such as: jpegtopnm: WRITING PPM FILE and jpegtopnm: Error writing row.
+In addition, you can edit this script as needed.
 
 \section{Details about .bcast5 Files}
 \label{sec:details_.bcast5_files}
@@ -109,7 +119,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