| 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 |
|
|
| 48 |
|
curiosity in the main trad window. |
| 49 |
|
(In general, only active windows are given help file links -- click |
| 50 |
|
on these rather than the text labels.) |
| 51 |
+ |
Additional search capabilities are available over all topics using |
| 52 |
+ |
the "Grep" button. |
| 53 |
|
|
| 54 |
|
For help on the help facility itself, Control-click on the problem |
| 55 |
|
help widget or on the window title in the upper right corner for |
| 57 |
|
(To get back to trad-specific help, press the "HELP" button in the |
| 58 |
|
main trad window or Control-click on a trad widget.) |
| 59 |
|
|
| 58 |
– |
Once the help window has been displayed, it is usually best to |
| 59 |
– |
lower or iconify it rather than dismissing it if further help is |
| 60 |
– |
needed. |
| 61 |
– |
This way, you will not have to wait for the help file to be read in |
| 62 |
– |
all over again every time you have a question. |
| 63 |
– |
|
| 60 |
|
.Trad.Messages |
| 61 |
|
|
| 62 |
|
Informative messages, commands executed by rad, and errors |
| 644 |
|
space between it and whatever follows. |
| 645 |
|
|
| 646 |
|
Hitting return in the "Options" window is equivalent to pressing the |
| 647 |
< |
"Add" button. |
| 647 |
> |
"Add" button followed by the "Clear" button. |
| 648 |
|
|
| 649 |
|
.Views.Add |
| 650 |
|
|
| 875 |
|
Normally, progress reports and errors during batch renderings |
| 876 |
|
are sent to the error file given by the root of the rad input |
| 877 |
|
file name followed by the ".err" suffix. |
| 878 |
< |
(See the "Errors" topic under the "Action" screen category.) |
| 878 |
> |
(See the "CheckErr" topic under the "Action" screen category.) |
| 879 |
|
If you wish these reports and errors to be directed to a different |
| 880 |
|
file, follow the time interval by a space and a file name. |
| 881 |
|
|
| 1055 |
|
Other views may be accessed within rview using the "L name" |
| 1056 |
|
command, and new views can be added with the "V name" |
| 1057 |
|
command. |
| 1058 |
+ |
|
| 1059 |
+ |
When using the "V" command to change an existing view, do not |
| 1060 |
+ |
give it a name because the previous view will not be overridden. |
| 1061 |
+ |
Instead, give it a new name (or no name, which will show up as |
| 1062 |
+ |
a number later), then use the Views screen to override the previous |
| 1063 |
+ |
view definition with the new one. |
| 1064 |
|
(See the rview(1) man page and the "View" topic in the current |
| 1065 |
|
help category for more information.) |
| 1066 |
|
|
| 1077 |
|
If the special entry "ALL" is selected, then every view in the |
| 1078 |
|
current list will be rendered if it hasn't been already. |
| 1079 |
|
|
| 1080 |
+ |
The view menu next to the "rview" button will be disabled if there |
| 1081 |
+ |
is only one view to choose from. |
| 1082 |
+ |
The view menu next to the "Start" button will be disabled if there |
| 1083 |
+ |
is a batch job in progress, and thus the view cannot be changed. |
| 1084 |
+ |
|
| 1085 |
|
The batch rendering view menu also selects the view or views |
| 1086 |
|
to use in producing a script during a dry run. |
| 1087 |
|
|
| 1102 |
|
the error file periodically. |
| 1103 |
|
(This file is named by the root of the rad input file followed by |
| 1104 |
|
".err".) |
| 1105 |
< |
When a batch process is started or already running, this button |
| 1106 |
< |
will be disabled. |
| 1105 |
> |
When a batch process is started or already running, or when a |
| 1106 |
> |
process is on another host and its status is unknown, |
| 1107 |
> |
this button will be disabled. |
| 1108 |
|
|
| 1109 |
|
The background process can be killed during this or later |
| 1110 |
|
invocations of trad using the "Kill" button. |
| 1111 |
+ |
If the process was started on another machine and the status is unknown, |
| 1112 |
+ |
it will be necessary to run trad from the other host or remove the error |
| 1113 |
+ |
file manually before starting a background process on this machine. |
| 1114 |
+ |
This is to protect you from the great confusion that results when two |
| 1115 |
+ |
machines are working from the same project file. |
| 1116 |
|
|
| 1117 |
|
.Action.Kill |
| 1118 |
|
|
| 1127 |
|
rendering, though some new startup costs will be incurred. |
| 1128 |
|
|
| 1129 |
|
The "Kill" button is disabled if no running batch process is |
| 1130 |
< |
detected. |
| 1130 |
> |
detected on the current host machine. |
| 1131 |
|
|
| 1132 |
|
.Action.CheckErr |
| 1133 |
|
|
