| 1 |
< |
.\" RCSid "$Id" |
| 1 |
> |
.\" RCSid "$Id$" |
| 2 |
|
.TH RTRACE 1 10/17/97 RADIANCE |
| 3 |
|
.SH NAME |
| 4 |
|
rtrace - trace rays in RADIANCE scene |
| 89 |
|
.IP |
| 90 |
|
w weight |
| 91 |
|
.IP |
| 92 |
+ |
W contribution |
| 93 |
+ |
.IP |
| 94 |
|
l effective length of ray |
| 95 |
|
.IP |
| 96 |
|
L first intersection distance |
| 97 |
|
.IP |
| 98 |
+ |
c local (u,v) coordinates |
| 99 |
+ |
.IP |
| 100 |
|
p point of intersection |
| 101 |
|
.IP |
| 102 |
|
n normal at intersection (perturbed) |
| 107 |
|
.IP |
| 108 |
|
m modifier name |
| 109 |
|
.IP |
| 110 |
+ |
M material name |
| 111 |
+ |
.IP |
| 112 |
+ |
- dash (end of trace marker) |
| 113 |
+ |
.IP |
| 114 |
|
If the letter 't' appears in |
| 115 |
|
.I spec, |
| 116 |
|
then the fields following will be printed for every ray traced, |
| 117 |
|
not just the final result. |
| 118 |
+ |
If the capital letter 'T' is given instead of 't', then all rays will |
| 119 |
+ |
be reported, including shadow testing rays to light sources. |
| 120 |
|
Spawned rays are indented one tab for each level. |
| 121 |
+ |
The dash marker ('-') is a handy way of differentiating the final ray |
| 122 |
+ |
value from traced values preceeding it, and should appear immediately |
| 123 |
+ |
after the |
| 124 |
+ |
.I \-o |
| 125 |
+ |
and before the rest of the specification. |
| 126 |
+ |
E.g., |
| 127 |
+ |
.I \-o-vTmW |
| 128 |
|
.IP |
| 129 |
|
Note that there is no space between this option and its argument. |
| 130 |
|
.TP |
| 131 |
< |
.BI -te \ mat |
| 131 |
> |
.BI -te \ mod |
| 132 |
|
Append |
| 133 |
< |
.I mat |
| 133 |
> |
.I mod |
| 134 |
|
to the trace exclude list, |
| 135 |
|
so that it will not be reported by the trace option |
| 136 |
|
.I (\-o*t*). |
| 137 |
|
Any ray striking an object having |
| 138 |
< |
.I mat |
| 138 |
> |
.I mod |
| 139 |
|
as its modifier will not be reported to the standard output with |
| 140 |
|
the rest of the rays being traced. |
| 141 |
< |
This option has no effect unless the 't' option has been given as |
| 142 |
< |
part of the output specifier. |
| 143 |
< |
Any number of excluded materials may be given, but each |
| 141 |
> |
This option has no effect unless either the 't' or 'T' |
| 142 |
> |
option has been given as part of the output specifier. |
| 143 |
> |
Any number of excluded modifiers may be given, but each |
| 144 |
|
must appear in a separate option. |
| 145 |
|
.TP |
| 146 |
< |
.BI -ti \ mat |
| 146 |
> |
.BI -ti \ mod |
| 147 |
|
Add |
| 148 |
< |
.I mat |
| 148 |
> |
.I mod |
| 149 |
|
to the trace include list, |
| 150 |
< |
so that it will be considered during the indirect calculation. |
| 150 |
> |
so that it will be reported by the trace option. |
| 151 |
|
The program can use either an include list or an exclude |
| 152 |
|
list, but not both. |
| 153 |
|
.TP |
| 154 |
|
.BI -tE \ file |
| 155 |
|
Same as |
| 156 |
|
.I \-te, |
| 157 |
< |
except read materials to be excluded from |
| 157 |
> |
except read modifiers to be excluded from |
| 158 |
|
.I file. |
| 159 |
|
The RAYPATH environment variable determines which directories are |
| 160 |
|
searched for this file. |
| 161 |
< |
The material names are separated by white space in the file. |
| 161 |
> |
The modifier names are separated by white space in the file. |
| 162 |
|
.TP |
| 163 |
|
.BI -tI \ file |
| 164 |
|
Same as |
| 165 |
|
.I \-ti, |
| 166 |
< |
except read materials to be included from |
| 166 |
> |
except read modifiers to be included from |
| 167 |
|
.I file. |
| 168 |
|
.TP |
| 169 |
|
.BR \-i |
| 442 |
|
.I Getinfo(1) |
| 443 |
|
may be used to print out this information. |
| 444 |
|
.TP |
| 445 |
< |
.BI -ae \ mat |
| 445 |
> |
.BI -ae \ mod |
| 446 |
|
Append |
| 447 |
< |
.I mat |
| 447 |
> |
.I mod |
| 448 |
|
to the ambient exclude list, |
| 449 |
|
so that it will not be considered during the indirect calculation. |
| 450 |
|
This is a hack for speeding the indirect computation by |
| 451 |
|
ignoring certain objects. |
| 452 |
|
Any object having |
| 453 |
< |
.I mat |
| 453 |
> |
.I mod |
| 454 |
|
as its modifier will get the default ambient |
| 455 |
|
level rather than a calculated value. |
| 456 |
< |
Any number of excluded materials may be given, but each |
| 456 |
> |
Any number of excluded modifiers may be given, but each |
| 457 |
|
must appear in a separate option. |
| 458 |
|
.TP |
| 459 |
< |
.BI -ai \ mat |
| 459 |
> |
.BI -ai \ mod |
| 460 |
|
Add |
| 461 |
< |
.I mat |
| 461 |
> |
.I mod |
| 462 |
|
to the ambient include list, |
| 463 |
|
so that it will be considered during the indirect calculation. |
| 464 |
|
The program can use either an include list or an exclude |
| 467 |
|
.BI -aE \ file |
| 468 |
|
Same as |
| 469 |
|
.I \-ae, |
| 470 |
< |
except read materials to be excluded from |
| 470 |
> |
except read modifiers to be excluded from |
| 471 |
|
.I file. |
| 472 |
|
The RAYPATH environment variable determines which directories are |
| 473 |
|
searched for this file. |
| 474 |
< |
The material names are separated by white space in the file. |
| 474 |
> |
The modifier names are separated by white space in the file. |
| 475 |
|
.TP |
| 476 |
|
.BI -aI \ file |
| 477 |
|
Same as |
| 478 |
|
.I \-ai, |
| 479 |
< |
except read materials to be included from |
| 479 |
> |
except read modifiers to be included from |
| 480 |
|
.I file. |
| 481 |
|
.TP |
| 482 |
|
.BI -me " rext gext bext" |
| 607 |
|
.SH ENVIRONMENT |
| 608 |
|
RAYPATH the directories to check for auxiliary files. |
| 609 |
|
.SH FILES |
| 610 |
< |
/usr/tmp/rtXXXXXX common header information for picture sequence |
| 610 |
> |
/tmp/rtXXXXXX common header information for picture sequence |
| 611 |
|
.SH DIAGNOSTICS |
| 612 |
|
If the program terminates from an input related error, the exit status |
| 613 |
|
will be 1. |
| 622 |
|
Greg Ward |
| 623 |
|
.SH "SEE ALSO" |
| 624 |
|
getinfo(1), lookamb(1), oconv(1), pfilt(1), pinterp(1), |
| 625 |
< |
pvalue(1), rpict(1), rview(1), vwrays(1), ximage(1) |
| 625 |
> |
pvalue(1), rpict(1), rvu(1), vwrays(1), ximage(1) |
