| 1 |
|
.\" RCSid "$Id$" |
| 2 |
|
.TH RTCONTRIB 1 5/25/05 RADIANCE |
| 3 |
|
.SH NAME |
| 4 |
< |
rtcontrib - compute contributions in a RADIANCE scene |
| 4 |
> |
rtcontrib - compute contribution coefficients in a RADIANCE scene |
| 5 |
|
.SH SYNOPSIS |
| 6 |
|
.B rtcontrib |
| 7 |
|
[ |
| 8 |
|
.B "\-n nprocs" |
| 9 |
|
][ |
| 10 |
+ |
.B \-r |
| 11 |
+ |
][ |
| 12 |
|
.B "\-e expr" |
| 13 |
|
][ |
| 14 |
|
.B "\-f source" |
| 15 |
|
][ |
| 16 |
< |
.B "\-o fspec" |
| 16 |
> |
.B "\-o ospec" |
| 17 |
|
][ |
| 18 |
|
.B "\-b binv" |
| 19 |
|
] |
| 20 |
< |
.B "\-m mod .." |
| 20 |
> |
{ |
| 21 |
> |
.B "\-m mod | \-M file" |
| 22 |
> |
} |
| 23 |
> |
.. |
| 24 |
|
[ |
| 25 |
|
.B $EVAR |
| 26 |
|
] |
| 42 |
|
These modifiers are usually materials associated with |
| 43 |
|
light sources or sky domes, and must directly modify some geometric |
| 44 |
|
primitives to be considered in the output. |
| 45 |
+ |
A modifier list may also be read from a file using the |
| 46 |
+ |
.I \-M |
| 47 |
+ |
option. |
| 48 |
+ |
.PP |
| 49 |
|
The output of |
| 50 |
|
.I rtcontrib |
| 51 |
|
has many potential uses. |
| 60 |
|
.I Rtcontrib |
| 61 |
|
calls |
| 62 |
|
.I rtrace(1) |
| 63 |
< |
to calculate the contributions for each input ray, |
| 64 |
< |
and the output tallies are sent to one or more files according to the |
| 63 |
> |
with the -oTW option to calculate the daughter ray |
| 64 |
> |
contributions for each input ray, and the output tallies |
| 65 |
> |
are sent to one or more destinations according to the given |
| 66 |
|
.I \-o |
| 67 |
|
specification. |
| 68 |
+ |
If a destination begins with an exclamation mark ('!'), then |
| 69 |
+ |
a pipe is opened to a command and data is sent to its standard input. |
| 70 |
+ |
Otherwise, the destination is treated as a file. |
| 71 |
+ |
An existing file of the same name is clobbered, unless the |
| 72 |
+ |
.I \-r |
| 73 |
+ |
option is specified, in which case data recovery is attempted. |
| 74 |
|
If an output specification contains a "%s" format, this will be |
| 75 |
|
replaced by the modifier name. |
| 76 |
|
The |
| 114 |
|
described in the |
| 115 |
|
.I rcalc(1) |
| 116 |
|
man page. |
| 117 |
+ |
Unlike |
| 118 |
+ |
.I rcalc, |
| 119 |
+ |
.I rtcontrib |
| 120 |
+ |
will search the RADIANCE library directories for each file given in a |
| 121 |
+ |
.I \-f |
| 122 |
+ |
option. |
| 123 |
+ |
(No search takes place if a file name begins with a '.', '/' or '~' |
| 124 |
+ |
character.)\0 |
| 125 |
|
.PP |
| 126 |
|
If no |
| 127 |
|
.I \-o |
| 128 |
|
specification is given, results are written on the standard output in order |
| 129 |
|
of modifier (as given on the command line) then bin number. |
| 130 |
< |
Concatenated data is also sent to a lone output file (i.e., an initial |
| 130 |
> |
Concatenated data is also sent to a single destination (i.e., an initial |
| 131 |
|
.I \-o |
| 132 |
|
specification without formatting strings). |
| 133 |
|
If a "%s" format appears but no "%d" in the |
| 204 |
|
.IP "" .2i |
| 205 |
|
rtcontrib -b tbin -o sky.dat -m skyglow -b 0 -o ground.dat -m groundglow |
| 206 |
|
@render.opt -f tregenza.cal scene.oct < test.dat |
| 207 |
+ |
.SH ENVIRONMENT |
| 208 |
+ |
RAYPATH path to search for -f files |
| 209 |
|
.SH AUTHOR |
| 210 |
|
Greg Ward |
| 211 |
|
.SH "SEE ALSO" |
