--- ray/src/util/trad.hlp 1995/07/06 12:23:37 2.11 +++ ray/src/util/trad.hlp 1995/10/05 13:03:04 2.16 @@ -1,4 +1,4 @@ - $Id: trad.hlp,v 2.11 1995/07/06 12:23:37 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 @@ -569,15 +569,15 @@ An invented name should be kept as short as possible, added to the picture file name along with the standard ".pic" suffix. The standard views are specified by strings of the form -"[Xx]?[Yy]?[Zz]?[vlah]?". +"[Xx]?[Yy]?[Zz]?[vlahc]?". (That is, an optional upper or lower case X followed by an optional upper or lower case Y followed by an optional upper or lower case Z -followed by an optional lower case V, L, A or H.) +followed by an optional lower case V, L, A, H or C.) The letters indicate the desired view position, where upper case "X" means maximum X, lower case "y" means minimum Y and so on. The final letter is the view type, where 'v' is perspective (the -default), 'l' is parallel, 'a' is angular fisheye, and 'h' is -hemispherical fisheye. +default), 'l' is parallel, 'a' is angular fisheye, 'h' is +hemispherical fisheye and 'c' is for cylindrical panorama. A perspective view from maximum X, minimum Y would be "Xy" or "Xyv". A parallel view from maximum Z would be "Zl". @@ -618,8 +618,9 @@ interaction mode for trad. Consult the rpict(1) manual page for a full description of the various view options, all of which begin with "-v". Just briefly, the "-vt?" option sets the view type, where "?" is -replaced by one of the letters "v, l, a or h", corresponding to -perspective, parallel, angular and hemispherical fisheye, respectively. +replaced by one of the letters "v, l, a, h or c", corresponding to +perspective, parallel, angular fisheye, hemispherical fisheye +and cylindrical panorama, respectively. The "-vp x y z" option sets the view position (eyepoint), where "x y z" is replaced by the position in 3-space. The "-vd xd yd zd" option sets the view direction, where "xd yd zd" @@ -706,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. @@ -745,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 @@ -1245,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 @@ -1332,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.