--- ray/src/util/trad.hlp 1995/08/18 10:34:56 2.12 +++ ray/src/util/trad.hlp 1995/10/05 13:03:04 2.16 @@ -1,4 +1,4 @@ - $Id: trad.hlp,v 2.12 1995/08/18 10:34:56 greg Exp $ + $Id: trad.hlp,v 2.16 1995/10/05 13:03:04 greg 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 @@ -490,7 +490,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 @@ -707,7 +707,7 @@ 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. @@ -746,17 +746,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 +1270,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 +1359,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.