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 |
569 |
|
added to the picture file name along with the standard ".pic" suffix. |
570 |
|
|
571 |
|
The standard views are specified by strings of the form |
572 |
< |
"[Xx]?[Yy]?[Zz]?[vlah]?". |
572 |
> |
"[Xx]?[Yy]?[Zz]?[vlahc]?". |
573 |
|
(That is, an optional upper or lower case X followed by an optional |
574 |
|
upper or lower case Y followed by an optional upper or lower case Z |
575 |
< |
followed by an optional lower case V, L, A or H.) |
575 |
> |
followed by an optional lower case V, L, A, H or C.) |
576 |
|
The letters indicate the desired view position, where upper case "X" |
577 |
|
means maximum X, lower case "y" means minimum Y and so on. |
578 |
|
The final letter is the view type, where 'v' is perspective (the |
579 |
< |
default), 'l' is parallel, 'a' is angular fisheye, and 'h' is |
580 |
< |
hemispherical fisheye. |
579 |
> |
default), 'l' is parallel, 'a' is angular fisheye, 'h' is |
580 |
> |
hemispherical fisheye and 'c' is for cylindrical panorama. |
581 |
|
A perspective view from maximum X, minimum Y would be "Xy" or |
582 |
|
"Xyv". |
583 |
|
A parallel view from maximum Z would be "Zl". |
618 |
|
Consult the rpict(1) manual page for a full description of the various |
619 |
|
view options, all of which begin with "-v". |
620 |
|
Just briefly, the "-vt?" option sets the view type, where "?" is |
621 |
< |
replaced by one of the letters "v, l, a or h", corresponding to |
622 |
< |
perspective, parallel, angular and hemispherical fisheye, respectively. |
621 |
> |
replaced by one of the letters "v, l, a, h or c", corresponding to |
622 |
> |
perspective, parallel, angular fisheye, hemispherical fisheye |
623 |
> |
and cylindrical panorama, respectively. |
624 |
|
The "-vp x y z" option sets the view position (eyepoint), where "x y z" |
625 |
|
is replaced by the position in 3-space. |
626 |
|
The "-vd xd yd zd" option sets the view direction, where "xd yd zd" |
645 |
|
space between it and whatever follows. |
646 |
|
|
647 |
|
Hitting return in the "Options" window is equivalent to pressing the |
648 |
< |
"Add" button. |
648 |
> |
"Add" button followed by the "Clear" button. |
649 |
|
|
650 |
|
.Views.Add |
651 |
|
|
746 |
|
|
747 |
|
The default value for this variable is "512". |
748 |
|
|
749 |
+ |
.Views.Rawsave |
750 |
+ |
|
751 |
+ |
The "Rawsave" check box determines whether or not the raw output picture |
752 |
+ |
from rpict will be saved. |
753 |
+ |
The default action (box unchecked) is to remove this file, since it |
754 |
+ |
takes up disk space and is not generally useful. |
755 |
+ |
However, if you wish to perform some special filtering function on |
756 |
+ |
the file, this file can be renamed instead of removed by checking this box. |
757 |
+ |
The final name in this case will be the same as the finished |
758 |
+ |
picture, except with a ".rwp" suffix. |
759 |
+ |
|
760 |
|
.Views.Copy |
761 |
|
|
762 |
|
The "Copy" button in the Views screen permits those variables |
887 |
|
Normally, progress reports and errors during batch renderings |
888 |
|
are sent to the error file given by the root of the rad input |
889 |
|
file name followed by the ".err" suffix. |
890 |
< |
(See the "Errors" topic under the "Action" screen category.) |
890 |
> |
(See the "CheckErr" topic under the "Action" screen category.) |
891 |
|
If you wish these reports and errors to be directed to a different |
892 |
|
file, follow the time interval by a space and a file name. |
893 |
|
|
1067 |
|
Other views may be accessed within rview using the "L name" |
1068 |
|
command, and new views can be added with the "V name" |
1069 |
|
command. |
1062 |
– |
(See the rview(1) man page and the "View" topic in the current |
1063 |
– |
help category for more information.) |
1070 |
|
|
1071 |
+ |
When using the "V" command to change an existing view, do not |
1072 |
+ |
give it an existing name because the previous view will not be overridden. |
1073 |
+ |
Instead, give it a new name (or no name, which will show up as |
1074 |
+ |
a number later), then use the Views screen to override the previous |
1075 |
+ |
view definition with the new one. |
1076 |
+ |
(See the "View" topic in the current |
1077 |
+ |
help category, the "Change" topic under "Views" and the rview(1) |
1078 |
+ |
manual page for more information.) |
1079 |
+ |
|
1080 |
|
If the octree is out-of-date, it will be rebuilt before rendering |
1081 |
|
begins. |
1082 |
|
|
1090 |
|
If the special entry "ALL" is selected, then every view in the |
1091 |
|
current list will be rendered if it hasn't been already. |
1092 |
|
|
1093 |
+ |
The view menu next to the "rview" button will be disabled if there |
1094 |
+ |
is only one view to choose from. |
1095 |
+ |
The view menu next to the "Start" button will be disabled if there |
1096 |
+ |
is a batch job in progress, and thus the view cannot be changed. |
1097 |
+ |
|
1098 |
|
The batch rendering view menu also selects the view or views |
1099 |
|
to use in producing a script during a dry run. |
1100 |
|
|
1115 |
|
the error file periodically. |
1116 |
|
(This file is named by the root of the rad input file followed by |
1117 |
|
".err".) |
1118 |
< |
When a batch process is started or already running, this button |
1119 |
< |
will be disabled. |
1118 |
> |
When a batch process is started or already running, or when a |
1119 |
> |
process is on another host and its status is unknown, |
1120 |
> |
this button will be disabled. |
1121 |
|
|
1122 |
|
The background process can be killed during this or later |
1123 |
|
invocations of trad using the "Kill" button. |
1124 |
+ |
If the process was started on another machine and the status is unknown, |
1125 |
+ |
it will be necessary to run trad from the other host or remove the error |
1126 |
+ |
file manually before starting a background process on this machine. |
1127 |
+ |
This is to protect you from the great confusion that results when two |
1128 |
+ |
machines are working from the same project file. |
1129 |
|
|
1130 |
|
.Action.Kill |
1131 |
|
|
1140 |
|
rendering, though some new startup costs will be incurred. |
1141 |
|
|
1142 |
|
The "Kill" button is disabled if no running batch process is |
1143 |
< |
detected. |
1143 |
> |
detected on the current host machine. |
1144 |
|
|
1145 |
|
.Action.CheckErr |
1146 |
|
|