--- 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.