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