| 9 |
|
][ |
| 10 |
|
.B \-V |
| 11 |
|
][ |
| 12 |
+ |
.B "\-t secs" |
| 13 |
+ |
][ |
| 14 |
|
.B "\-c count" |
| 15 |
|
][ |
| 16 |
|
.B \-fo |
| 121 |
|
.I \-c |
| 122 |
|
set to zero. |
| 123 |
|
.PP |
| 124 |
+ |
If progress reports are desired, the |
| 125 |
+ |
.I \-t |
| 126 |
+ |
option specifies a time interval in seconds for reports sent to |
| 127 |
+ |
standard error. |
| 128 |
+ |
.PP |
| 129 |
|
The output of |
| 130 |
|
.I rcontrib |
| 131 |
|
has many potential uses. |
| 165 |
|
option may be used to further define |
| 166 |
|
a "bin number" within each object if finer resolution is needed, and |
| 167 |
|
this will be applied to a "%d" format in the output file |
| 168 |
< |
specification if present. |
| 168 |
> |
specification if present. |
| 169 |
> |
(The final integer will be offset incrementally |
| 170 |
> |
if the output is a RADIANCE picture and more than one modifier has |
| 171 |
> |
the same format specification.)\0 |
| 172 |
|
The actual bin number is computed at run time based on ray direction |
| 173 |
|
and surface intersection, as described below. |
| 174 |
|
The number of bins must be specified in advance with the |
| 218 |
|
with a |
| 219 |
|
.I \-p |
| 220 |
|
option, which contains a list of variable names and assigned values, separated |
| 221 |
< |
by commas or semicolons. |
| 221 |
> |
by commas, colons, or semicolons. |
| 222 |
|
The computed bin value will be |
| 223 |
|
rounded to the nearest whole number. |
| 224 |
|
(Negative bin values will be silently ignored.)\0 |
| 290 |
|
replaced by the contents of the given file. |
| 291 |
|
.PP |
| 292 |
|
.I Rcontrib |
| 293 |
< |
has EXPERIMENTAL support for light source contributions from photon maps |
| 284 |
< |
generated by |
| 293 |
> |
supports light source contributions from photon maps generated by |
| 294 |
|
.I mkpmap(1) |
| 295 |
|
with its |
| 296 |
|
.I -apC |
| 297 |
< |
option. In photon mapping mode, |
| 297 |
> |
option. Enabling photon mapping is described in the |
| 298 |
> |
.I rtrace |
| 299 |
> |
man page along with its relevant settings. In photon mapping mode, |
| 300 |
|
.I rcontrib |
| 301 |
|
only supports contributions from light sources, not arbitrary modifiers. |
| 302 |
|
The |
| 306 |
|
.I \-V- |
| 307 |
|
option. Using fewer photons than there are light sources for the photon |
| 308 |
|
density estimates results in omitted contributions, thus the bandwidth |
| 309 |
< |
is clamped accordingly and a warning issued. |
| 309 |
> |
is clamped accordingly and a warning is issued. |
| 310 |
|
.SH EXAMPLES |
| 311 |
|
To compute the proportional contributions from sources modified |
| 312 |
|
by "light1" vs. "light2" on a set of illuminance values: |
| 337 |
|
scene.oct < test.dat, |
| 338 |
|
.SH ENVIRONMENT |
| 339 |
|
RAYPATH path to search for \-f and \-M files |
| 340 |
+ |
.SH BUGS |
| 341 |
+ |
We do not currently compute contributions or coefficients properly |
| 342 |
+ |
in scenes with participating media. |
| 343 |
+ |
A single warning will be issued if a scattering or absorbing medium |
| 344 |
+ |
is detected. |
| 345 |
|
.SH AUTHOR |
| 346 |
|
Greg Ward |
| 347 |
|
.SH "SEE ALSO" |
