--- ray/src/util/trad.hlp	1995/08/18 10:34:56	2.12
+++ ray/src/util/trad.hlp	1998/10/20 11:52:15	2.18
@@ -1,4 +1,4 @@
-	$Id: trad.hlp,v 2.12 1995/08/18 10:34:56 greg Exp $
+	$Id: trad.hlp,v 2.18 1998/10/20 11:52:15 gwlarson Exp $
 
 This help file is associated with the trad interface to the Radiance
 rad(1) program.  Trad consists of trad.wsh and one do_*.tcl file for
@@ -398,11 +398,26 @@ long as the overall size of the given box is close to 
 size of the space.
 
 The Zone entry windows may be manipulated in the following ways.
-Control-U clears the current window.
 Control-V pastes the contents of the current selection at the
 insertion point.
 Return moves the focus to the next window in the chain.
 
+The "Auto" button may be used to set these values based on the bounding
+box of one or more Radiance scene files.
+
+.Zone.Auto
+
+Use this button to automatically determine the bounding box for this
+zone, based on the output of the "getbbox" command run on one or
+more Radiance scene files.
+The appropriate scene files are entered via a file
+selection dialogue box, which comes up after the button is pressed.
+
+The reason for selecting specific files rather than running getbbox
+on the entire scene is that a zone usually does not include large
+external objects, which may be present in the complete scene
+description.
+
 .Zone.Detail
 
 The "Detail" setting indicates the relative level
@@ -490,7 +505,7 @@ tot_flux is given in watts.
 (Divide total lumens by 179 lumens/watt to get watts.)
 
 The exposure value may either be given as a positive real value, or
-as a real value preceeded by a '+' or '-' indicating a positive or
+as a real value preceded by a '+' or '-' indicating a positive or
 negative number of f-stops (powers of two) from the original value.
 
 If no exposure is given, pfilt will automatically compute the
@@ -682,9 +697,6 @@ The "Clear" button simply clears the "Name" and "Optio
 for the convenience of entering a new view.
 It has no effect on the rad input variables.
 
-Note that Control-U will always clear an entry box whose cursor is
-active.
-
 .Views.Default
 
 The "Set Default" button may be used to make the selected view the
@@ -707,10 +719,19 @@ The standard view up vector may be set to the positive
 the positive Y axis (+Y), the positive Z axis (+Z), the negative
 X axis (-X), the negative Y axis (-Y), or the negative Z axis (-Z).
 
-This setting may always be overriden by the "-vu xd yd zd" option,
+This setting may always be overridden by the "-vu xd yd zd" option,
 and will be altered for a particular view if it happens to be
 parallel to the view direction.
 
+.Views.Eyesep
+
+The eye separation is used for generating stereo views of
+the scene.
+It is the measured distance between a viewer's pupils in world
+coordinate units.
+It is not used directly by rad, but should be set for other programs
+that need it, such as rholo and glrad.
+
 .Views.Picture
 
 The root picture file name is given in the "Picture" entry window.
@@ -746,17 +767,41 @@ to maintain a specific pixel aspect ratio (1 by defaul
 
 The default value for this variable is "512".
 
-.Views.Rawsave
+.Views.Rawfile
 
-The "Rawsave" check box determines whether or not the raw output picture
+The "Rawfile" entry window determines if and where the raw output picture
 from rpict will be saved.
-The default action (box unchecked) is to remove this file, since it
+If the entry is empty, the file will be removed after rendering and
+filtering.
+This is the normal action, since the raw file
 takes up disk space and is not generally useful.
-However, if you wish to perform some special filtering function on
-the file, this file can be renamed instead of removed by checking this box.
-The final name in this case will be the same as the finished
-picture, except with a ".rwp" suffix.
+However, if you wish to perform some special filtering function,
+this file can be renamed instead of removed by giving a
+root file name in this entry window.
+The final name in this case will be the given root plus and
+underscore plus the view name followed by a ".pic" suffix.
 
+In the special case when the raw file name and picture file name are
+the same, the raw file is saved and no filtering takes place.
+
+.Views.Zfile
+
+The "Zfile" entry window gives the root name of the file in which to
+store the raw (binary floating point) distances to pixels in the
+original generated image.
+If this entry is empty, then no z-file will be saved.
+
+The final z-file name will be the given root plus an underscore plus
+the view name plus a ".zbf" suffix.
+
+To convert this image to human-readable form, the program "od" will
+work on some systems, or the Radiance "pvalue" program may be used
+to first convert it to a greyscale Radiance picture using the
+options "-r -h -b -df `getinfo -d < pictname`" where "pictname" is
+replaced by the raw picture file name.
+(Getinfo simply gets the original image dimensions, which are not
+stored in the z-file.)
+
 .Views.Copy
 
 The "Copy" button in the Views screen permits those variables
@@ -1246,6 +1291,8 @@ has completed since the Results screen was brought up.
 
 The "Delete" button on the Results screen is used to remove the
 selected picture files from the filesystem.
+Associated raw picture and z-buffer files
+will also be deleted if they exist.
 Verification is required before any action is taken.
 
 .Results.Display
@@ -1333,10 +1380,13 @@ details.)
 The print command window on the Results screen contains the system
 command to use in printing out finished Radiance pictures.
 The "%s" format field, which must appear somewhere in the command,
-is replaced by the selected Radiance picture file name(s).
+is replaced by the selected Radiance picture file name.
+This command is executed multiple times if multiple files are
+selected.
 
 The default command is "ra_ps %s | lpr", which converts the Radiance
 picture to a black and white PostScript file and sends it to the lpr
 print spooler.
+Add a "-c" option to "ra_ps" if the printer supports color.
 If your printer does not understand PostScript, or your system does
 not support lpr, this command must obviously be changed.
