63 |
|
|
64 |
|
.Trad.Messages |
65 |
|
|
66 |
< |
Informative messages, commands executed by rad, and errors |
66 |
> |
Informative messages, commands executed by rad, and errors |
67 |
|
appear in the message window at the bottom of the trad frame. |
68 |
< |
Growing the trad window means growing this message window, and |
68 |
> |
Growing the trad window means growing this message window, and |
69 |
|
not much else. |
70 |
|
This is not really necessary, since the window will be grown |
71 |
|
automatically if the message requires it. |
339 |
|
|
340 |
|
.Scene.Revert |
341 |
|
|
342 |
< |
The "Revert" button is a convenient way to revert to the original |
342 |
> |
The "Revert" button is a convenient way to revert to the original |
343 |
|
values in the rad input file. |
344 |
|
Only the variables on the Scene screen will be affected, but any changes |
345 |
|
to these variables since the last save will be lost. |
353 |
|
walls, as it is used primarily to set rendering parameters and |
354 |
|
standard viewpoints. |
355 |
|
|
356 |
< |
An interior zone means that standard viewpoints will be selected |
356 |
> |
An interior zone means that standard viewpoints will be selected |
357 |
|
from the inside of this box. |
358 |
|
An exterior zone means that standard viewpoints will be selected |
359 |
|
from the outside of this box. |
360 |
< |
The default zone is an exterior one computed from the bounding box |
360 |
> |
The default zone is an exterior one computed from the bounding box |
361 |
|
of the entire scene. |
362 |
|
(Note that this is not usually desirable.) |
363 |
|
|
371 |
|
|
372 |
|
.Zone.Type |
373 |
|
|
374 |
< |
There are two types of zones understood by rad, "Interior" and |
374 |
> |
There are two types of zones understood by rad, "Interior" and |
375 |
|
"Exterior". |
376 |
< |
An interior zone is indicated when renderings generally take place |
376 |
> |
An interior zone is indicated when renderings generally take place |
377 |
|
inside a specified 3-d box. |
378 |
|
A typical example might be a single room or auditorium. |
379 |
|
An exterior zone is indicated when renderings generally take place |
505 |
|
|
506 |
|
The "Copy" button on the Zone screen takes all values for this |
507 |
|
screen from another rad input file, replacing the current values. |
508 |
< |
Specifically, the rad variables "ZONE, DETAIL, INDIRECT, |
508 |
> |
Specifically, the rad variables "ZONE, DETAIL, INDIRECT, |
509 |
|
VARIABILITY and EXPOSURE" will be copied from the named file. |
510 |
|
|
511 |
|
All other variables will be left untouched. |
512 |
|
|
513 |
|
.Zone.Revert |
514 |
|
|
515 |
< |
The "Revert" button is a convenient way to revert to the original |
515 |
> |
The "Revert" button is a convenient way to revert to the original |
516 |
|
values in the rad input file. |
517 |
|
Only the variables on the Zone screen will be affected, but any changes |
518 |
|
to these variables since the last save will be lost. |
524 |
|
"view" variable. |
525 |
|
Each view setting is listed by name, or by number if no name has |
526 |
|
been assigned. |
527 |
< |
To add a new view, enter a unique name and specify the view |
527 |
> |
To add a new view, enter a unique name and specify the view |
528 |
|
options, |
529 |
|
then press the "Add" or "Set Default" button. |
530 |
|
If a view with the same name already exists, it is unconditionally |
534 |
|
To remove an unwanted view, select it and press the "Delete" button. |
535 |
|
To undo this action, simply press the "Add" button again. |
536 |
|
|
537 |
< |
The first view in the list is the default given to rview during |
537 |
> |
The first view in the list is the default given to rview during |
538 |
|
interactive rendering, and is the first view rendered in a batch run. |
539 |
|
To change the default view, select the newly desired view and press |
540 |
|
the "Set Default" button. |
569 |
|
|
570 |
|
Each view has a unique name, which may be chosen at the user's |
571 |
|
discretion or taken from a list of standard views, described below. |
572 |
< |
An invented name should be kept as short as possible, since it is |
572 |
> |
An invented name should be kept as short as possible, since it is |
573 |
|
added to the picture file name along with the standard ".pic" suffix. |
574 |
|
|
575 |
|
The standard views are specified by strings of the form |
582 |
|
The final letter is the view type, where 'v' is perspective (the |
583 |
|
default), 'l' is parallel, 'a' is angular fisheye, and 'h' is |
584 |
|
hemispherical fisheye. |
585 |
< |
A perspective view from maximum X, minimum Y would be "Xy" or |
585 |
> |
A perspective view from maximum X, minimum Y would be "Xy" or |
586 |
|
"Xyv". |
587 |
|
A parallel view from maximum Z would be "Zl". |
588 |
|
If "ZONE" is an interior zone, the standard views will |
624 |
|
Just briefly, the "-vt?" option sets the view type, where "?" is |
625 |
|
replaced by one of the letters "v, l, a or h", corresponding to |
626 |
|
perspective, parallel, angular and hemispherical fisheye, respectively. |
627 |
< |
The "-vp x y z" option sets the view position (eyepoint), where "x y z" |
627 |
> |
The "-vp x y z" option sets the view position (eyepoint), where "x y z" |
628 |
|
is replaced by the position in 3-space. |
629 |
|
The "-vd xd yd zd" option sets the view direction, where "xd yd zd" |
630 |
|
is a vector pointing in the desired direction. |
633 |
|
unnecessary.) |
634 |
|
The "-vh horiz" and "-vv vert" options set the horizontal and |
635 |
|
vertical view sizes, respectively. |
636 |
< |
For perspective views, these correspond to full camera angles in |
636 |
> |
For perspective views, these correspond to full camera angles in |
637 |
|
degrees. |
638 |
|
For parallel views (using the "-vtl" option), they correspond to |
639 |
|
image plane size in world coordinates. |
761 |
|
|
762 |
|
.Views.Revert |
763 |
|
|
764 |
< |
The "Revert" button is a convenient way to revert to the original |
764 |
> |
The "Revert" button is a convenient way to revert to the original |
765 |
|
values in the rad input file. |
766 |
|
Only the variables on the Views screen will be affected, but any changes |
767 |
|
to these variables since the last save will be lost. |
820 |
|
|
821 |
|
.Options.Penumbras |
822 |
|
|
823 |
< |
The "Penumbras" setting determines whether or not Radiance will |
823 |
> |
The "Penumbras" setting determines whether or not Radiance will |
824 |
|
make a special effort to generate soft shadows from area light sources. |
825 |
|
Since this is a potentially expensive calculation, penumbras should |
826 |
|
only be switched "On" when they are really needed. |
848 |
|
|
849 |
|
.Options.AmbDelete |
850 |
|
|
851 |
< |
The "Delete" button next to the "Ambfile" window on the Options |
851 |
> |
The "Delete" button next to the "Ambfile" window on the Options |
852 |
|
screens allows you to remove the named ambient file. |
853 |
|
This is usually done when a change to one or more rad variables |
854 |
|
casts doubt on the accuracy of the values stored in this file. |
884 |
|
file, follow the time interval by a space and a file name. |
885 |
|
|
886 |
|
No setting on this variable means do not report rendering progress. |
887 |
< |
A zero setting means the same thing, and may be used when a |
887 |
> |
A zero setting means the same thing, and may be used when a |
888 |
|
separate error file is desired but progress reports are not. |
889 |
|
|
890 |
|
.Options.Oconv |
925 |
|
|
926 |
|
The "render opts" window is used to specify additional options to |
927 |
|
the rview(1) and rpict(1) rendering programs. |
928 |
< |
Most of the important parameters are computed by rad, so this |
928 |
> |
Most of the important parameters are computed by rad, so this |
929 |
|
window is usually used to override specific parameters or to give |
930 |
|
additional information, such as which materials to exclude from the |
931 |
|
interreflection calculation. |
978 |
|
The next set of buttons provides for the control of a batch |
979 |
|
rendering process, taking place in the background. |
980 |
|
Finally, the bottom set of buttons allows you to preview what would |
981 |
< |
happen during a batch rendering, or (equivalently) make a script of |
981 |
> |
happen during a batch rendering, or (equivalently) make a script of |
982 |
|
UNIX commands for later execution. |
983 |
|
|
984 |
|
When the Action screen is first brought up, the message window |
1053 |
|
|
1054 |
|
.Action.Rview |
1055 |
|
|
1056 |
< |
The "rview" button on the Action screen starts an interactive |
1057 |
< |
rendering for the selected view, indicated by the menu button |
1056 |
> |
The "rview" button on the Action screen starts an interactive |
1057 |
> |
rendering for the selected view, indicated by the menu button |
1058 |
|
just to the right. |
1059 |
< |
Other views may be accessed within rview using the "L name" |
1060 |
< |
command, and new views can be added with the "V name" |
1059 |
> |
Other views may be accessed within rview using the "L name" |
1060 |
> |
command, and new views can be added with the "V name" |
1061 |
|
command. |
1062 |
< |
(See the rview(1) man page and the "View" topic in the current |
1062 |
> |
(See the rview(1) man page and the "View" topic in the current |
1063 |
|
help category for more information.) |
1064 |
|
|
1065 |
< |
If the octree is out-of-date, it will be rebuilt before rendering |
1065 |
> |
If the octree is out-of-date, it will be rebuilt before rendering |
1066 |
|
begins. |
1067 |
|
|
1068 |
|
.Action.View |
1069 |
|
|
1070 |
|
The Action screen contains two menus for selecting views. |
1071 |
< |
The top menu, next to the "rview" button, sets the view to start |
1071 |
> |
The top menu, next to the "rview" button, sets the view to start |
1072 |
|
with in rview, and is selected from the current view list. |
1073 |
< |
The second view menu, next to the "Start" button for batch |
1073 |
> |
The second view menu, next to the "Start" button for batch |
1074 |
|
rendering, selects the view or views to render in batch mode. |
1075 |
< |
If the special entry "ALL" is selected, then every view in the |
1075 |
> |
If the special entry "ALL" is selected, then every view in the |
1076 |
|
current list will be rendered if it hasn't been already. |
1077 |
|
|
1078 |
< |
The batch rendering view menu also selects the view or views |
1078 |
> |
The batch rendering view menu also selects the view or views |
1079 |
|
to use in producing a script during a dry run. |
1080 |
|
|
1081 |
|
.Action.Start |
1082 |
|
|
1083 |
< |
The "Start" button for batch rendering on the Action screen |
1084 |
< |
initiates a rad rendering process in the background using the |
1083 |
> |
The "Start" button for batch rendering on the Action screen |
1084 |
> |
initiates a rad rendering process in the background using the |
1085 |
|
selected view or views shown on the menu button to the right. |
1086 |
|
|
1087 |
|
If any of the rad variables have been changed since the |
1090 |
|
If you discard these changes, then the batch rendering will be |
1091 |
|
conducted using the previously saved values. |
1092 |
|
|
1093 |
< |
Once a background process is going, the "Start" button is |
1094 |
< |
disabled, and rendering progress can be monitored by checking |
1093 |
> |
Once a background process is going, the "Start" button is |
1094 |
> |
disabled, and rendering progress can be monitored by checking |
1095 |
|
the error file periodically. |
1096 |
< |
(This file is named by the root of the rad input file followed by |
1096 |
> |
(This file is named by the root of the rad input file followed by |
1097 |
|
".err".) |
1098 |
< |
When a batch process is started or already running, this button |
1098 |
> |
When a batch process is started or already running, this button |
1099 |
|
will be disabled. |
1100 |
|
|
1101 |
< |
The background process can be killed during this or later |
1101 |
> |
The background process can be killed during this or later |
1102 |
|
invocations of trad using the "Kill" button. |
1103 |
|
|
1104 |
|
.Action.Kill |
1105 |
|
|
1106 |
< |
The batch rendering "Kill" button kills the |
1106 |
> |
The batch rendering "Kill" button kills the |
1107 |
|
background process started earlier with the "Start" button. |
1108 |
< |
The rad process id is taken from the first line of the error file, |
1108 |
> |
The rad process id is taken from the first line of the error file, |
1109 |
|
and this process and all its children are killed when the |
1110 |
|
button is pressed. |
1111 |
|
|
1112 |
< |
So long as there is an ambient file specified in the Options |
1113 |
< |
screen, no data is lost by killing and restarting a batch |
1112 |
> |
So long as there is an ambient file specified in the Options |
1113 |
> |
screen, no data is lost by killing and restarting a batch |
1114 |
|
rendering, though some new startup costs will be incurred. |
1115 |
|
|
1116 |
< |
The "Kill" button is disabled if no running batch process is |
1116 |
> |
The "Kill" button is disabled if no running batch process is |
1117 |
|
detected. |
1118 |
|
|
1119 |
|
.Action.CheckErr |
1120 |
|
|
1121 |
|
Pressing the "Check errors" button |
1122 |
< |
displays the contents of the batch rendering error file, named |
1123 |
< |
by the root of the current rad input file followed by the ".err" |
1122 |
> |
displays the contents of the batch rendering error file, named |
1123 |
> |
by the root of the current rad input file followed by the ".err" |
1124 |
|
suffix. |
1125 |
< |
This file will contain the command lines executed by rad so far, |
1126 |
< |
and may or may not contain additional progress reports from |
1125 |
> |
This file will contain the command lines executed by rad so far, |
1126 |
> |
and may or may not contain additional progress reports from |
1127 |
|
rpict, depending on the initial setting of the "REPORT" variable. |
1128 |
|
|
1129 |
|
If no error file exists, this button will be disabled. |
1131 |
|
.Action.Script |
1132 |
|
|
1133 |
|
The dry run "Script" button runs rad with the |
1134 |
< |
"-n" option so that you may see the commands that would be |
1134 |
> |
"-n" option so that you may see the commands that would be |
1135 |
|
executed during a batch run without actually executing them. |
1136 |
< |
If a file is named in the window next to this button, the output |
1136 |
> |
If a file is named in the window next to this button, the output |
1137 |
|
will simply be written to that file. |
1138 |
< |
If no file is named, a temporary file is created and an editor |
1138 |
> |
If no file is named, a temporary file is created and an editor |
1139 |
|
window is opened on it. |
1140 |
|
|
1141 |
|
Producing a dry run also writes the "Optfile" if one is specified |
1143 |
|
This may be useful for computing rendering parameters for rtrace(1) |
1144 |
|
or rpiece(1). |
1145 |
|
|
1146 |
< |
The view or views are selected by the same menu used for |
1146 |
> |
The view or views are selected by the same menu used for |
1147 |
|
batch rendering. |
1148 |
< |
(See the "View" topic under the current help category for more |
1148 |
> |
(See the "View" topic under the current help category for more |
1149 |
|
information.) |
1150 |
|
|
1151 |
|
.Action.Edit |
1152 |
|
|
1153 |
< |
The dry run "Edit" button is used to edit the named script file |
1153 |
> |
The dry run "Edit" button is used to edit the named script file |
1154 |
|
created by pressing the "Script" button. |
1155 |
|
If no file is named, this button is ineffective. |
1156 |
|
|
1157 |
|
.Action.Delete |
1158 |
|
|
1159 |
< |
The "Delete" button removes the named script file, created by the |
1159 |
> |
The "Delete" button removes the named script file, created by the |
1160 |
|
"Script" button. |
1161 |
< |
If no file is named, or the named file does not exist, this button has |
1161 |
> |
If no file is named, or the named file does not exist, this button has |
1162 |
|
no effect. |
1163 |
|
|
1164 |
|
.Results.Intro |
1165 |
|
|
1166 |
|
This button selects the trad Results screen. |
1167 |
< |
This screen permits rendered pictures to be displayed, |
1167 |
> |
This screen permits rendered pictures to be displayed, |
1168 |
|
converted to other image formats, and printed. |
1169 |
< |
Only finished pictures may be converted or printed, but |
1170 |
< |
incomplete pictures (i.e. aborted renderings or renderings in |
1169 |
> |
Only finished pictures may be converted or printed, but |
1170 |
> |
incomplete pictures (i.e. aborted renderings or renderings in |
1171 |
|
progress) may be displayed interactively. |
1172 |
|
|
1173 |
|
The left-hand window shows a list of completed views, and the |
1174 |
< |
right-hand window shows views that have been started but not |
1174 |
> |
right-hand window shows views that have been started but not |
1175 |
|
finished. |
1176 |
< |
Note that other views may not even be started, thus may not |
1176 |
> |
Note that other views may not even be started, thus may not |
1177 |
|
appear in either list. |
1178 |
< |
Also, just because a view appears on the Results screen, it does |
1179 |
< |
not mean that view is up-to-date with respect to the Radiance |
1178 |
> |
Also, just because a view appears on the Results screen, it does |
1179 |
> |
not mean that view is up-to-date with respect to the Radiance |
1180 |
|
input files. |
1181 |
< |
(The best way currently to tell which pictures are out-of-date |
1182 |
< |
is to press the "Script" button on the Action screen and examine |
1181 |
> |
(The best way currently to tell which pictures are out-of-date |
1182 |
> |
is to press the "Script" button on the Action screen and examine |
1183 |
|
the output.) |
1184 |
|
|
1185 |
|
.Results.Finished |
1212 |
|
|
1213 |
|
.Results.Rescan |
1214 |
|
|
1215 |
< |
The "Rescan" button on the Results screen is used to update the |
1216 |
< |
finished and unfinished view lists, in case one or more pictures |
1215 |
> |
The "Rescan" button on the Results screen is used to update the |
1216 |
> |
finished and unfinished view lists, in case one or more pictures |
1217 |
|
has completed since the Results screen was brought up. |
1218 |
|
|
1219 |
|
.Results.Delete |