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

Comparing ray/src/util/trad.hlp (file contents):
Revision 2.8 by greg, Tue Dec 6 13:00:26 1994 UTC vs.
Revision 2.18 by gwlarson, Tue Oct 20 11:52:15 1998 UTC

# Line 398 | Line 398 | long as the overall size of the given box is close to
398   size of the space.
399  
400   The Zone entry windows may be manipulated in the following ways.
401 Control-U clears the current window.
401   Control-V pastes the contents of the current selection at the
402   insertion point.
403   Return moves the focus to the next window in the chain.
404  
405 + The "Auto" button may be used to set these values based on the bounding
406 + box of one or more Radiance scene files.
407 +
408 + .Zone.Auto
409 +
410 + Use this button to automatically determine the bounding box for this
411 + zone, based on the output of the "getbbox" command run on one or
412 + more Radiance scene files.
413 + The appropriate scene files are entered via a file
414 + selection dialogue box, which comes up after the button is pressed.
415 +
416 + The reason for selecting specific files rather than running getbbox
417 + on the entire scene is that a zone usually does not include large
418 + external objects, which may be present in the complete scene
419 + description.
420 +
421   .Zone.Detail
422  
423   The "Detail" setting indicates the relative level
# Line 490 | Line 505 | tot_flux is given in watts.
505   (Divide total lumens by 179 lumens/watt to get watts.)
506  
507   The exposure value may either be given as a positive real value, or
508 < as a real value preceeded by a '+' or '-' indicating a positive or
508 > as a real value preceded by a '+' or '-' indicating a positive or
509   negative number of f-stops (powers of two) from the original value.
510  
511   If no exposure is given, pfilt will automatically compute the
# Line 569 | Line 584 | An invented name should be kept as short as possible,
584   added to the picture file name along with the standard ".pic" suffix.
585  
586   The standard views are specified by strings of the form
587 < "[Xx]?[Yy]?[Zz]?[vlah]?".
587 > "[Xx]?[Yy]?[Zz]?[vlahc]?".
588   (That is, an optional upper or lower case X followed by an optional
589   upper or lower case Y followed by an optional upper or lower case Z
590 < followed by an optional lower case V, L, A or H.)
590 > followed by an optional lower case V, L, A, H or C.)
591   The letters indicate the desired view position, where upper case "X"
592   means maximum X, lower case "y" means minimum Y and so on.
593   The final letter is the view type, where 'v' is perspective (the
594 < default), 'l' is parallel, 'a' is angular fisheye, and 'h' is
595 < hemispherical fisheye.
594 > default), 'l' is parallel, 'a' is angular fisheye, 'h' is
595 > hemispherical fisheye and 'c' is for cylindrical panorama.
596   A perspective view from maximum X, minimum Y would be "Xy" or
597   "Xyv".
598   A parallel view from maximum Z would be "Zl".
# Line 618 | Line 633 | interaction mode for trad.
633   Consult the rpict(1) manual page for a full description of the various
634   view options, all of which begin with "-v".
635   Just briefly, the "-vt?" option sets the view type, where "?" is
636 < replaced by one of the letters "v, l, a or h", corresponding to
637 < perspective, parallel, angular and hemispherical fisheye, respectively.
636 > replaced by one of the letters "v, l, a, h or c", corresponding to
637 > perspective, parallel, angular fisheye, hemispherical fisheye
638 > and cylindrical panorama, respectively.
639   The "-vp x y z" option sets the view position (eyepoint), where "x y z"
640   is replaced by the position in 3-space.
641   The "-vd xd yd zd" option sets the view direction, where "xd yd zd"
# Line 681 | Line 697 | The "Clear" button simply clears the "Name" and "Optio
697   for the convenience of entering a new view.
698   It has no effect on the rad input variables.
699  
684 Note that Control-U will always clear an entry box whose cursor is
685 active.
686
700   .Views.Default
701  
702   The "Set Default" button may be used to make the selected view the
# Line 706 | Line 719 | The standard view up vector may be set to the positive
719   the positive Y axis (+Y), the positive Z axis (+Z), the negative
720   X axis (-X), the negative Y axis (-Y), or the negative Z axis (-Z).
721  
722 < This setting may always be overriden by the "-vu xd yd zd" option,
722 > This setting may always be overridden by the "-vu xd yd zd" option,
723   and will be altered for a particular view if it happens to be
724   parallel to the view direction.
725  
726 + .Views.Eyesep
727 +
728 + The eye separation is used for generating stereo views of
729 + the scene.
730 + It is the measured distance between a viewer's pupils in world
731 + coordinate units.
732 + It is not used directly by rad, but should be set for other programs
733 + that need it, such as rholo and glrad.
734 +
735   .Views.Picture
736  
737   The root picture file name is given in the "Picture" entry window.
# Line 745 | Line 767 | to maintain a specific pixel aspect ratio (1 by defaul
767  
768   The default value for this variable is "512".
769  
770 + .Views.Rawfile
771 +
772 + The "Rawfile" entry window determines if and where the raw output picture
773 + from rpict will be saved.
774 + If the entry is empty, the file will be removed after rendering and
775 + filtering.
776 + This is the normal action, since the raw file
777 + takes up disk space and is not generally useful.
778 + However, if you wish to perform some special filtering function,
779 + this file can be renamed instead of removed by giving a
780 + root file name in this entry window.
781 + The final name in this case will be the given root plus and
782 + underscore plus the view name followed by a ".pic" suffix.
783 +
784 + In the special case when the raw file name and picture file name are
785 + the same, the raw file is saved and no filtering takes place.
786 +
787 + .Views.Zfile
788 +
789 + The "Zfile" entry window gives the root name of the file in which to
790 + store the raw (binary floating point) distances to pixels in the
791 + original generated image.
792 + If this entry is empty, then no z-file will be saved.
793 +
794 + The final z-file name will be the given root plus an underscore plus
795 + the view name plus a ".zbf" suffix.
796 +
797 + To convert this image to human-readable form, the program "od" will
798 + work on some systems, or the Radiance "pvalue" program may be used
799 + to first convert it to a greyscale Radiance picture using the
800 + options "-r -h -b -df `getinfo -d < pictname`" where "pictname" is
801 + replaced by the raw picture file name.
802 + (Getinfo simply gets the original image dimensions, which are not
803 + stored in the z-file.)
804 +
805   .Views.Copy
806  
807   The "Copy" button in the Views screen permits those variables
# Line 875 | Line 932 | a given rendering has progressed.
932   Normally, progress reports and errors during batch renderings
933   are sent to the error file given by the root of the rad input
934   file name followed by the ".err" suffix.
935 < (See the "Errors" topic under the "Action" screen category.)
935 > (See the "CheckErr" topic under the "Action" screen category.)
936   If you wish these reports and errors to be directed to a different
937   file, follow the time interval by a space and a file name.
938  
# Line 1057 | Line 1114 | command, and new views can be added with the "V name"
1114   command.
1115  
1116   When using the "V" command to change an existing view, do not
1117 < give it a name because the previous view will not be overridden.
1117 > give it an existing name because the previous view will not be overridden.
1118   Instead, give it a new name (or no name, which will show up as
1119   a number later), then use the Views screen to override the previous
1120   view definition with the new one.
1121 < (See the rview(1) man page and the "View" topic in the current
1122 < help category for more information.)
1121 > (See the "View" topic in the current
1122 > help category, the "Change" topic under "Views" and the rview(1)
1123 > manual page for more information.)
1124  
1125   If the octree is out-of-date, it will be rebuilt before rendering
1126   begins.
# Line 1233 | Line 1291 | has completed since the Results screen was brought up.
1291  
1292   The "Delete" button on the Results screen is used to remove the
1293   selected picture files from the filesystem.
1294 + Associated raw picture and z-buffer files
1295 + will also be deleted if they exist.
1296   Verification is required before any action is taken.
1297  
1298   .Results.Display
# Line 1320 | Line 1380 | details.)
1380   The print command window on the Results screen contains the system
1381   command to use in printing out finished Radiance pictures.
1382   The "%s" format field, which must appear somewhere in the command,
1383 < is replaced by the selected Radiance picture file name(s).
1383 > is replaced by the selected Radiance picture file name.
1384 > This command is executed multiple times if multiple files are
1385 > selected.
1386  
1387   The default command is "ra_ps %s | lpr", which converts the Radiance
1388   picture to a black and white PostScript file and sends it to the lpr
1389   print spooler.
1390 + Add a "-c" option to "ra_ps" if the printer supports color.
1391   If your printer does not understand PostScript, or your system does
1392   not support lpr, this command must obviously be changed.

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines