ViewVC Help
View File | Revision Log | Show Annotations | Download File | Root Listing
root/Development/ray/src/util/trad.hlp
(Generate patch)

Comparing ray/src/util/trad.hlp (file contents):
Revision 2.5 by greg, Sun Nov 6 09:39:09 1994 UTC vs.
Revision 2.16 by greg, Thu Oct 5 13:03:04 1995 UTC

# Line 2 | Line 2
2  
3   This help file is associated with the trad interface to the Radiance
4   rad(1) program.  Trad consists of trad.wsh and one do_*.tcl file for
5 < each screen.  There are currently seven such screens:  Action, File,
6 < Options, Results, Scene, Views and Zone.
5 > each screen.  There are currently seven such screens:  File, Scene,
6 > Zone, Views, Options, Action and Results.
7  
8   .Trad.Intro
9  
# Line 490 | Line 490 | tot_flux is given in watts.
490   (Divide total lumens by 179 lumens/watt to get watts.)
491  
492   The exposure value may either be given as a positive real value, or
493 < as a real value preceeded by a '+' or '-' indicating a positive or
493 > as a real value preceded by a '+' or '-' indicating a positive or
494   negative number of f-stops (powers of two) from the original value.
495  
496   If no exposure is given, pfilt will automatically compute the
# Line 569 | Line 569 | An invented name should be kept as short as possible,
569   added to the picture file name along with the standard ".pic" suffix.
570  
571   The standard views are specified by strings of the form
572 < "[Xx]?[Yy]?[Zz]?[vlah]?".
572 > "[Xx]?[Yy]?[Zz]?[vlahc]?".
573   (That is, an optional upper or lower case X followed by an optional
574   upper or lower case Y followed by an optional upper or lower case Z
575 < followed by an optional lower case V, L, A or H.)
575 > followed by an optional lower case V, L, A, H or C.)
576   The letters indicate the desired view position, where upper case "X"
577   means maximum X, lower case "y" means minimum Y and so on.
578   The final letter is the view type, where 'v' is perspective (the
579 < default), 'l' is parallel, 'a' is angular fisheye, and 'h' is
580 < hemispherical fisheye.
579 > default), 'l' is parallel, 'a' is angular fisheye, 'h' is
580 > hemispherical fisheye and 'c' is for cylindrical panorama.
581   A perspective view from maximum X, minimum Y would be "Xy" or
582   "Xyv".
583   A parallel view from maximum Z would be "Zl".
# Line 618 | Line 618 | interaction mode for trad.
618   Consult the rpict(1) manual page for a full description of the various
619   view options, all of which begin with "-v".
620   Just briefly, the "-vt?" option sets the view type, where "?" is
621 < replaced by one of the letters "v, l, a or h", corresponding to
622 < perspective, parallel, angular and hemispherical fisheye, respectively.
621 > replaced by one of the letters "v, l, a, h or c", corresponding to
622 > perspective, parallel, angular fisheye, hemispherical fisheye
623 > and cylindrical panorama, respectively.
624   The "-vp x y z" option sets the view position (eyepoint), where "x y z"
625   is replaced by the position in 3-space.
626   The "-vd xd yd zd" option sets the view direction, where "xd yd zd"
# Line 706 | Line 707 | The standard view up vector may be set to the positive
707   the positive Y axis (+Y), the positive Z axis (+Z), the negative
708   X axis (-X), the negative Y axis (-Y), or the negative Z axis (-Z).
709  
710 < This setting may always be overriden by the "-vu xd yd zd" option,
710 > This setting may always be overridden by the "-vu xd yd zd" option,
711   and will be altered for a particular view if it happens to be
712   parallel to the view direction.
713  
# Line 745 | Line 746 | to maintain a specific pixel aspect ratio (1 by defaul
746  
747   The default value for this variable is "512".
748  
749 + .Views.Rawfile
750 +
751 + The "Rawfile" entry window determines if and where the raw output picture
752 + from rpict will be saved.
753 + If the entry is empty, the file will be removed after rendering and
754 + filtering.
755 + This is the normal action, since the raw file
756 + takes up disk space and is not generally useful.
757 + However, if you wish to perform some special filtering function,
758 + this file can be renamed instead of removed by giving a
759 + root file name in this entry window.
760 + The final name in this case will be the given root plus and
761 + underscore plus the view name followed by a ".pic" suffix.
762 +
763 + In the special case when the raw file name and picture file name are
764 + the same, the raw file is saved and no filtering takes place.
765 +
766 + .Views.Zfile
767 +
768 + The "Zfile" entry window gives the root name of the file in which to
769 + store the raw (binary floating point) distances to pixels in the
770 + original generated image.
771 + If this entry is empty, then no z-file will be saved.
772 +
773 + The final z-file name will be the given root plus an underscore plus
774 + the view name plus a ".zbf" suffix.
775 +
776 + To convert this image to human-readable form, the program "od" will
777 + work on some systems, or the Radiance "pvalue" program may be used
778 + to first convert it to a greyscale Radiance picture using the
779 + options "-r -h -b -df `getinfo -d < pictname`" where "pictname" is
780 + replaced by the raw picture file name.
781 + (Getinfo simply gets the original image dimensions, which are not
782 + stored in the z-file.)
783 +
784   .Views.Copy
785  
786   The "Copy" button in the Views screen permits those variables
# Line 875 | Line 911 | a given rendering has progressed.
911   Normally, progress reports and errors during batch renderings
912   are sent to the error file given by the root of the rad input
913   file name followed by the ".err" suffix.
914 < (See the "Errors" topic under the "Action" screen category.)
914 > (See the "CheckErr" topic under the "Action" screen category.)
915   If you wish these reports and errors to be directed to a different
916   file, follow the time interval by a space and a file name.
917  
# Line 1055 | Line 1091 | just to the right.
1091   Other views may be accessed within rview using the "L name"
1092   command, and new views can be added with the "V name"
1093   command.
1058 – (See the rview(1) man page and the "View" topic in the current
1059 – help category for more information.)
1094  
1095 + When using the "V" command to change an existing view, do not
1096 + give it an existing name because the previous view will not be overridden.
1097 + Instead, give it a new name (or no name, which will show up as
1098 + a number later), then use the Views screen to override the previous
1099 + view definition with the new one.
1100 + (See the "View" topic in the current
1101 + help category, the "Change" topic under "Views" and the rview(1)
1102 + manual page for more information.)
1103 +
1104   If the octree is out-of-date, it will be rebuilt before rendering
1105   begins.
1106  
# Line 1071 | Line 1114 | rendering, selects the view or views to render in batc
1114   If the special entry "ALL" is selected, then every view in the
1115   current list will be rendered if it hasn't been already.
1116  
1117 + The view menu next to the "rview" button will be disabled if there
1118 + is only one view to choose from.
1119 + The view menu next to the "Start" button will be disabled if there
1120 + is a batch job in progress, and thus the view cannot be changed.
1121 +
1122   The batch rendering view menu also selects the view or views
1123   to use in producing a script during a dry run.
1124  
# Line 1091 | Line 1139 | disabled, and rendering progress can be monitored by c
1139   the error file periodically.
1140   (This file is named by the root of the rad input file followed by
1141   ".err".)
1142 < When a batch process is started or already running, this button
1143 < will be disabled.
1142 > When a batch process is started or already running, or when a
1143 > process is on another host and its status is unknown,
1144 > this button will be disabled.
1145  
1146   The background process can be killed during this or later
1147   invocations of trad using the "Kill" button.
1148 + If the process was started on another machine and the status is unknown,
1149 + it will be necessary to run trad from the other host or remove the error
1150 + file manually before starting a background process on this machine.
1151 + This is to protect you from the great confusion that results when two
1152 + machines are working from the same project file.
1153  
1154   .Action.Kill
1155  
# Line 1110 | Line 1164 | screen, no data is lost by killing and restarting a ba
1164   rendering, though some new startup costs will be incurred.
1165  
1166   The "Kill" button is disabled if no running batch process is
1167 < detected.
1167 > detected on the current host machine.
1168  
1169   .Action.CheckErr
1170  
# Line 1216 | Line 1270 | has completed since the Results screen was brought up.
1270  
1271   The "Delete" button on the Results screen is used to remove the
1272   selected picture files from the filesystem.
1273 + Associated raw picture and z-buffer files
1274 + will also be deleted if they exist.
1275   Verification is required before any action is taken.
1276  
1277   .Results.Display
# Line 1303 | Line 1359 | details.)
1359   The print command window on the Results screen contains the system
1360   command to use in printing out finished Radiance pictures.
1361   The "%s" format field, which must appear somewhere in the command,
1362 < is replaced by the selected Radiance picture file name(s).
1362 > is replaced by the selected Radiance picture file name.
1363 > This command is executed multiple times if multiple files are
1364 > selected.
1365  
1366   The default command is "ra_ps %s | lpr", which converts the Radiance
1367   picture to a black and white PostScript file and sends it to the lpr
1368   print spooler.
1369 + Add a "-c" option to "ra_ps" if the printer supports color.
1370   If your printer does not understand PostScript, or your system does
1371   not support lpr, this command must obviously be changed.

Diff Legend

– Removed lines
+ Added lines
< Changed lines
> Changed lines