| 1 |
< |
$Id$ |
| 1 |
> |
trad.hlp 2.18 10/20/98 |
| 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 |
| 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 |
| 487 |
|
|
| 488 |
|
There are two basic ways to compute the exposure value. |
| 489 |
|
The first is by trial and error, where the value is adjusted up and |
| 490 |
< |
down within rview using the "e = value" command. |
| 490 |
> |
down within rvu using the "e = value" command. |
| 491 |
|
Though it sounds flaky, this is the most reliable way to set the |
| 492 |
|
exposure (and ambient level) in general lighting situations. |
| 493 |
|
|
| 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 |
| 545 |
|
To remove an unwanted view, select it and press the "Delete" button. |
| 546 |
|
To undo this action, simply press the "Add" button again. |
| 547 |
|
|
| 548 |
< |
The first view in the list is the default given to rview during |
| 548 |
> |
The first view in the list is the default given to rvu during |
| 549 |
|
interactive rendering, and is the first view rendered in a batch run. |
| 550 |
|
To change the default view, select the newly desired view and press |
| 551 |
|
the "Set Default" button. |
| 614 |
|
define a view. |
| 615 |
|
|
| 616 |
|
The simplest view specification is of the form "-vf viewfile", where |
| 617 |
< |
"viewfile" is a file created with the rview "view" command, or a |
| 617 |
> |
"viewfile" is a file created with the rvu "view" command, or a |
| 618 |
|
Radiance picture. |
| 619 |
|
This method of naming views, although convenient, is not the best |
| 620 |
|
since it is difficult to know exactly where such a view is by |
| 697 |
|
for the convenience of entering a new view. |
| 698 |
|
It has no effect on the rad input variables. |
| 699 |
|
|
| 685 |
– |
Note that Control-U will always clear an entry box whose cursor is |
| 686 |
– |
active. |
| 687 |
– |
|
| 700 |
|
.Views.Default |
| 701 |
|
|
| 702 |
|
The "Set Default" button may be used to make the selected view the |
| 703 |
|
default view for rendering. |
| 704 |
|
This simply moves the view to the top of the list in the rad input file. |
| 705 |
< |
The default view will be the one normally rendered by rview when rad |
| 705 |
> |
The default view will be the one normally rendered by rvu when rad |
| 706 |
|
is started interactively, and is the first view rendered in a batch |
| 707 |
|
process. |
| 708 |
|
|
| 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. |
| 838 |
|
minutes) between progress reports. |
| 839 |
|
|
| 840 |
|
Other windows allow the user to customize the options to oconv(1), |
| 841 |
< |
mkillum(1), rview(1) and rpict(1), and pfilt(1). |
| 841 |
> |
mkillum(1), rvu(1) and rpict(1), and pfilt(1). |
| 842 |
|
|
| 843 |
|
.Options.Quality |
| 844 |
|
|
| 916 |
|
|
| 917 |
|
The "Optfile" setting assigns a file to hold rendering options, |
| 918 |
|
which may be a convenience when these options are reused for |
| 919 |
< |
rtrace(1) or rpiece(1), or manual invocations of rview or rpict. |
| 919 |
> |
rtrace(1) or rpiece(1), or manual invocations of rvu or rpict. |
| 920 |
|
Using an options file also reduces the size of the command line, |
| 921 |
|
making it a little easier on the eye. |
| 922 |
|
|
| 977 |
|
.Options.Render |
| 978 |
|
|
| 979 |
|
The "render opts" window is used to specify additional options to |
| 980 |
< |
the rview(1) and rpict(1) rendering programs. |
| 980 |
> |
the rvu(1) and rpict(1) rendering programs. |
| 981 |
|
Most of the important parameters are computed by rad, so this |
| 982 |
|
window is usually used to override specific parameters or to give |
| 983 |
|
additional information, such as which materials to exclude from the |
| 1026 |
|
run, usually via rad(1). |
| 1027 |
|
The top row of buttons is used to update the octree following a |
| 1028 |
|
change to one or more input files. |
| 1029 |
< |
The "rview" button starts an interactive rendering in the |
| 1029 |
> |
The "rvu" button starts an interactive rendering in the |
| 1030 |
|
foreground. |
| 1031 |
|
The next set of buttons provides for the control of a batch |
| 1032 |
|
rendering process, taking place in the background. |
| 1104 |
|
(This will still cause the ambient file to be removed, |
| 1105 |
|
unfortunately.) |
| 1106 |
|
|
| 1107 |
< |
.Action.Rview |
| 1107 |
> |
.Action.Rvu |
| 1108 |
|
|
| 1109 |
< |
The "rview" button on the Action screen starts an interactive |
| 1109 |
> |
The "rvu" button on the Action screen starts an interactive |
| 1110 |
|
rendering for the selected view, indicated by the menu button |
| 1111 |
|
just to the right. |
| 1112 |
< |
Other views may be accessed within rview using the "L name" |
| 1112 |
> |
Other views may be accessed within rvu using the "L name" |
| 1113 |
|
command, and new views can be added with the "V name" |
| 1114 |
|
command. |
| 1115 |
|
|
| 1119 |
|
a number later), then use the Views screen to override the previous |
| 1120 |
|
view definition with the new one. |
| 1121 |
|
(See the "View" topic in the current |
| 1122 |
< |
help category, the "Change" topic under "Views" and the rview(1) |
| 1122 |
> |
help category, the "Change" topic under "Views" and the rvu(1) |
| 1123 |
|
manual page for more information.) |
| 1124 |
|
|
| 1125 |
|
If the octree is out-of-date, it will be rebuilt before rendering |
| 1128 |
|
.Action.View |
| 1129 |
|
|
| 1130 |
|
The Action screen contains two menus for selecting views. |
| 1131 |
< |
The top menu, next to the "rview" button, sets the view to start |
| 1132 |
< |
with in rview, and is selected from the current view list. |
| 1131 |
> |
The top menu, next to the "rvu" button, sets the view to start |
| 1132 |
> |
with in rvu, and is selected from the current view list. |
| 1133 |
|
The second view menu, next to the "Start" button for batch |
| 1134 |
|
rendering, selects the view or views to render in batch mode. |
| 1135 |
|
If the special entry "ALL" is selected, then every view in the |
| 1136 |
|
current list will be rendered if it hasn't been already. |
| 1137 |
|
|
| 1138 |
< |
The view menu next to the "rview" button will be disabled if there |
| 1138 |
> |
The view menu next to the "rvu" button will be disabled if there |
| 1139 |
|
is only one view to choose from. |
| 1140 |
|
The view menu next to the "Start" button will be disabled if there |
| 1141 |
|
is a batch job in progress, and thus the view cannot be changed. |
| 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. |
