--- ray/src/util/trad.hlp 1995/08/18 10:34:56 2.12 +++ ray/src/util/trad.hlp 1995/09/13 13:15:29 2.14 @@ -1,4 +1,4 @@ - $Id: trad.hlp,v 2.12 1995/08/18 10:34:56 greg Exp $ + $Id: trad.hlp,v 2.14 1995/09/13 13:15:29 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 @@ -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