| 9 |
|
][ |
| 10 |
|
.B \-V |
| 11 |
|
][ |
| 12 |
+ |
.B "\-t secs" |
| 13 |
+ |
][ |
| 14 |
|
.B "\-c count" |
| 15 |
|
][ |
| 16 |
|
.B \-fo |
| 17 |
|
| |
| 18 |
|
.B \-r |
| 19 |
|
][ |
| 18 |
– |
.B "\-e expr" |
| 19 |
– |
][ |
| 20 |
– |
.B "\-f source" |
| 21 |
– |
][ |
| 20 |
|
.B "\-o ospec" |
| 21 |
|
][ |
| 22 |
|
.B "\-p p1=V1,p2=V2" |
| 41 |
|
.B octree |
| 42 |
|
.br |
| 43 |
|
.B "rcontrib [ options ] \-defaults" |
| 44 |
+ |
.br |
| 45 |
+ |
.B "rcontrib \-features [feat1 ..]" |
| 46 |
|
.SH DESCRIPTION |
| 47 |
|
.I Rcontrib |
| 48 |
|
computes ray coefficients |
| 119 |
|
.I \-c |
| 120 |
|
set to zero. |
| 121 |
|
.PP |
| 122 |
+ |
Output flushing at fixed intervals may be enabled with the |
| 123 |
+ |
.I \-x |
| 124 |
+ |
option, which specifies the number of records |
| 125 |
+ |
(-c accumulations) before each flush. |
| 126 |
+ |
If the |
| 127 |
+ |
.I \-y |
| 128 |
+ |
option is also set, then periodic flushing is disabled and the |
| 129 |
+ |
output size for an RGB image is the taken from the x and y dimensions. |
| 130 |
+ |
In lieu of periodic flushing, a flush may be forced as mentioned above |
| 131 |
+ |
by sending a sample with a zero direction vector, although you |
| 132 |
+ |
must still send a full record of rays before output occurs. |
| 133 |
+ |
.PP |
| 134 |
+ |
If progress reports are desired, the |
| 135 |
+ |
.I \-t |
| 136 |
+ |
option specifies a time interval in seconds for reports sent to |
| 137 |
+ |
standard error. |
| 138 |
+ |
This requires that the number of input samples is known, meaning a |
| 139 |
+ |
.I \-y |
| 140 |
+ |
parameter has been specified. |
| 141 |
+ |
.PP |
| 142 |
|
The output of |
| 143 |
|
.I rcontrib |
| 144 |
|
has many potential uses. |
| 204 |
|
.I \-o |
| 205 |
|
options to the left of each |
| 206 |
|
.I \-m |
| 207 |
< |
setting are the ones used for that modifier. |
| 207 |
> |
name are the ones used for that modifier. |
| 208 |
> |
Any |
| 209 |
> |
.I \-cs |
| 210 |
> |
option changing the number of spectral color |
| 211 |
> |
samples must appear before the first modifier. |
| 212 |
|
The ordering of other options is unimportant, except for |
| 213 |
|
.I \-x |
| 214 |
|
and |
| 235 |
|
with a |
| 236 |
|
.I \-p |
| 237 |
|
option, which contains a list of variable names and assigned values, separated |
| 238 |
< |
by commas or semicolons. |
| 238 |
> |
by commas, colons, or semicolons. |
| 239 |
|
The computed bin value will be |
| 240 |
|
rounded to the nearest whole number. |
| 241 |
|
(Negative bin values will be silently ignored.)\0 |
| 250 |
|
described in the |
| 251 |
|
.I rcalc(1) |
| 252 |
|
man page. |
| 253 |
< |
Like |
| 230 |
< |
.I rcalc, |
| 253 |
> |
Like the other rendering tools, |
| 254 |
|
.I rcontrib |
| 255 |
< |
will search the RADIANCE library directories for each file given in a |
| 255 |
> |
will search the |
| 256 |
> |
.I RAYPATH |
| 257 |
> |
library directories for each file given in a |
| 258 |
|
.I \-f |
| 259 |
|
option. |
| 260 |
+ |
However, a special evaluation context is set for the |
| 261 |
+ |
.I \-f |
| 262 |
+ |
and |
| 263 |
+ |
.I \-e |
| 264 |
+ |
definitions, so attach a back-quote ('`') to variable and function names |
| 265 |
+ |
you wish these to apply at the global evaluation level and used by all |
| 266 |
+ |
materials and modifiers during rendering. |
| 267 |
|
.PP |
| 268 |
|
If no |
| 269 |
|
.I \-o |
| 334 |
|
is clamped accordingly and a warning is issued. |
| 335 |
|
.SH EXAMPLES |
| 336 |
|
To compute the proportional contributions from sources modified |
| 337 |
< |
by "light1" vs. "light2" on a set of illuminance values: |
| 337 |
> |
by "light1" vs. "light2" on a set of irradiance values: |
| 338 |
|
.IP "" .2i |
| 339 |
|
rcontrib \-I+ @render.opt \-o c_%s.dat \-m light1 \-m light2 scene.oct < test.dat |
| 340 |
|
.PP |
| 350 |
|
.IP "" .2i |
| 351 |
|
pcomb \-c 100 90 75 c_light1.hdr \-c 50 55 57 c_light2.hdr > combined.hdr |
| 352 |
|
.PP |
| 353 |
< |
To compute an array of illuminance contributions according to a Tregenza sky: |
| 353 |
> |
To compute an array of irradiance contributions according to a Tregenza sky: |
| 354 |
|
.IP "" .2i |
| 355 |
|
rcontrib \-I+ \-f tregenza.cal \-b tbin \-bn Ntbins \-o sky.dat \-m skyglow |
| 356 |
|
\-b 0 \-o ground.dat \-m groundglow @render.opt scene.oct < test.dat |
| 370 |
|
.SH AUTHOR |
| 371 |
|
Greg Ward |
| 372 |
|
.SH "SEE ALSO" |
| 373 |
< |
cnt(1), genklemsamp(1), getinfo(1), mkpmap(1), pcomb(1), pfilt(1), |
| 374 |
< |
ra_rgbe(1), rcalc(1), rfluxmtx(1), rmtxop(1), rpict(1), rsensor(1), |
| 375 |
< |
rtrace(1), total(1), vwrays(1), ximage(1) |
| 373 |
> |
cnt(1), dctimestep(1), genklemsamp(1), getinfo(1), mkpmap(1), pcomb(1), pfilt(1), |
| 374 |
> |
pvsum(1), ra_rgbe(1), rcalc(1), rcomb(1), rfluxmtx(1), rmtxop(1), rpict(1), |
| 375 |
> |
rsensor(1), rtrace(1), rxfluxmtx(1), total(1), vwrays(1), ximage(1) |
| 376 |
|
|
