| 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 |
| 398 |
|
size of the space. |
| 399 |
|
|
| 400 |
|
The Zone entry windows may be manipulated in the following ways. |
| 405 |
– |
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" |
| 660 |
|
space between it and whatever follows. |
| 661 |
|
|
| 662 |
|
Hitting return in the "Options" window is equivalent to pressing the |
| 663 |
< |
"Add" button. |
| 663 |
> |
"Add" button followed by the "Clear" button. |
| 664 |
|
|
| 665 |
|
.Views.Add |
| 666 |
|
|
| 697 |
|
for the convenience of entering a new view. |
| 698 |
|
It has no effect on the rad input variables. |
| 699 |
|
|
| 688 |
– |
Note that Control-U will always clear an entry box whose cursor is |
| 689 |
– |
active. |
| 690 |
– |
|
| 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 |
| 932 |
|
Normally, progress reports and errors during batch renderings |
| 933 |
|
are sent to the error file given by the root of the rad input |
| 934 |
|
file name followed by the ".err" suffix. |
| 935 |
< |
(See the "Errors" topic under the "Action" screen category.) |
| 935 |
> |
(See the "CheckErr" topic under the "Action" screen category.) |
| 936 |
|
If you wish these reports and errors to be directed to a different |
| 937 |
|
file, follow the time interval by a space and a file name. |
| 938 |
|
|
| 1112 |
|
Other views may be accessed within rview using the "L name" |
| 1113 |
|
command, and new views can be added with the "V name" |
| 1114 |
|
command. |
| 1062 |
– |
(See the rview(1) man page and the "View" topic in the current |
| 1063 |
– |
help category for more information.) |
| 1115 |
|
|
| 1116 |
+ |
When using the "V" command to change an existing view, do not |
| 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 "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. |
| 1127 |
|
|
| 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 |
| 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. |
| 1142 |
+ |
|
| 1143 |
|
The batch rendering view menu also selects the view or views |
| 1144 |
|
to use in producing a script during a dry run. |
| 1145 |
|
|
| 1160 |
|
the error file periodically. |
| 1161 |
|
(This file is named by the root of the rad input file followed by |
| 1162 |
|
".err".) |
| 1163 |
< |
When a batch process is started or already running, this button |
| 1164 |
< |
will be disabled. |
| 1163 |
> |
When a batch process is started or already running, or when a |
| 1164 |
> |
process is on another host and its status is unknown, |
| 1165 |
> |
this button will be disabled. |
| 1166 |
|
|
| 1167 |
|
The background process can be killed during this or later |
| 1168 |
|
invocations of trad using the "Kill" button. |
| 1169 |
+ |
If the process was started on another machine and the status is unknown, |
| 1170 |
+ |
it will be necessary to run trad from the other host or remove the error |
| 1171 |
+ |
file manually before starting a background process on this machine. |
| 1172 |
+ |
This is to protect you from the great confusion that results when two |
| 1173 |
+ |
machines are working from the same project file. |
| 1174 |
|
|
| 1175 |
|
.Action.Kill |
| 1176 |
|
|
| 1185 |
|
rendering, though some new startup costs will be incurred. |
| 1186 |
|
|
| 1187 |
|
The "Kill" button is disabled if no running batch process is |
| 1188 |
< |
detected. |
| 1188 |
> |
detected on the current host machine. |
| 1189 |
|
|
| 1190 |
|
.Action.CheckErr |
| 1191 |
|
|
| 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. |
