| 21 |
|
][ |
| 22 |
|
.B "\-o ospec" |
| 23 |
|
][ |
| 24 |
+ |
.B "\-p p1=V1,p2=V2" |
| 25 |
+ |
][ |
| 26 |
|
.B "\-b binv" |
| 27 |
|
][ |
| 28 |
|
.B "\-bn nbins" |
| 173 |
|
option. |
| 174 |
|
Since bin numbers start from zero, the bin count is always equal to |
| 175 |
|
the last bin plus one. |
| 174 |
– |
Set the this value to zero if the bin count is unknown (the default). |
| 176 |
|
The most recent |
| 177 |
+ |
.I \-p, |
| 178 |
|
.I \-b, |
| 179 |
|
.I \-bn |
| 180 |
|
and |
| 204 |
|
arguments and files read using the |
| 205 |
|
.I \-f |
| 206 |
|
option. |
| 207 |
+ |
Additional parameter values that apply only to this modifier may be specified |
| 208 |
+ |
with a |
| 209 |
+ |
.I \-p |
| 210 |
+ |
option, which contains a list of variable names and assigned values, separated |
| 211 |
+ |
by commas or semicolons. |
| 212 |
|
The computed bin value will be |
| 213 |
|
rounded to the nearest whole number. |
| 214 |
+ |
(Negative bin values will be silently ignored.)\0 |
| 215 |
+ |
For a single bin, you may specify |
| 216 |
+ |
.I "\-b 0", |
| 217 |
+ |
which is the default. |
| 218 |
|
This mechanism allows the user to define precise regions or directions |
| 219 |
|
they wish to accumulate, such as the Tregenza sky discretization, |
| 220 |
|
which would be otherwise impossible to specify |
| 223 |
|
described in the |
| 224 |
|
.I rcalc(1) |
| 225 |
|
man page. |
| 226 |
< |
Unlike |
| 226 |
> |
Like |
| 227 |
|
.I rcalc, |
| 228 |
|
.I rcontrib |
| 229 |
|
will search the RADIANCE library directories for each file given in a |
| 278 |
|
replaced by the contents of the given environment variable. |
| 279 |
|
A command argument beginning with an at sign ('@') is immediately |
| 280 |
|
replaced by the contents of the given file. |
| 281 |
+ |
.PP |
| 282 |
+ |
.I Rcontrib |
| 283 |
+ |
has EXPERIMENTAL support for light source contributions from photon maps |
| 284 |
+ |
generated by |
| 285 |
+ |
.I mkpmap(1) |
| 286 |
+ |
with its |
| 287 |
+ |
.I -apC |
| 288 |
+ |
option. In photon mapping mode, |
| 289 |
+ |
.I rcontrib |
| 290 |
+ |
only supports contributions from light sources, not arbitrary modifiers. |
| 291 |
+ |
The |
| 292 |
+ |
.I -b |
| 293 |
+ |
option is supported along with its associated ray variables, as |
| 294 |
+ |
discussed above. Ray coefficients are also supported via the |
| 295 |
+ |
.I \-V- |
| 296 |
+ |
option. Using fewer photons than there are light sources for the photon |
| 297 |
+ |
density estimates results in omitted contributions, thus the bandwidth |
| 298 |
+ |
is clamped accordingly and a warning issued. |
| 299 |
|
.SH EXAMPLES |
| 300 |
|
To compute the proportional contributions from sources modified |
| 301 |
|
by "light1" vs. "light2" on a set of illuminance values: |
| 316 |
|
.PP |
| 317 |
|
To compute an array of illuminance contributions according to a Tregenza sky: |
| 318 |
|
.IP "" .2i |
| 319 |
< |
rcontrib \-I+ \-b tbin \-o sky.dat \-m skyglow \-b 0 \-o ground.dat \-m groundglow |
| 320 |
< |
@render.opt \-f tregenza.cal scene.oct < test.dat |
| 319 |
> |
rcontrib \-I+ \-f tregenza.cal \-b tbin \-bn Ntbins \-o sky.dat \-m skyglow |
| 320 |
> |
\-b 0 \-o ground.dat \-m groundglow @render.opt scene.oct < test.dat |
| 321 |
> |
.PP |
| 322 |
> |
To perform an annual simulation of 365 daily sun positions in photon mapping |
| 323 |
> |
mode: |
| 324 |
> |
.IP "" .2i |
| 325 |
> |
rcontrib \-I+ \-h \-V \-fo \-o c_%s.dat \-M lights \-ap contrib.pm 365 |
| 326 |
> |
scene.oct < test.dat, |
| 327 |
|
.SH ENVIRONMENT |
| 328 |
|
RAYPATH path to search for \-f and \-M files |
| 329 |
|
.SH AUTHOR |
| 330 |
|
Greg Ward |
| 331 |
|
.SH "SEE ALSO" |
| 332 |
< |
cnt(1), genklemsamp(1), getinfo(1), pcomb(1), pfilt(1), ra_rgbe(1), |
| 333 |
< |
rcalc(1), rpict(1), rsensor(1), rtrace(1), total(1), vwrays(1), ximage(1) |
| 332 |
> |
cnt(1), genklemsamp(1), getinfo(1), mkpmap(1), pcomb(1), pfilt(1), |
| 333 |
> |
ra_rgbe(1), rcalc(1), rfluxmtx(1), rmtxop(1), rpict(1), rsensor(1), |
| 334 |
> |
rtrace(1), total(1), vwrays(1), ximage(1) |
| 335 |
> |
|
