ViewVC Help
View File | Revision Log | Show Annotations | Download File | Root Listing
root/Development/ray/doc/man/man1/rcontrib.1
(Generate patch)

Comparing ray/doc/man/man1/rcontrib.1 (file contents):
Revision 1.13 by greg, Mon Sep 12 20:31:34 2016 UTC vs.
Revision 1.18 by greg, Wed Sep 9 21:28:19 2020 UTC

# Line 9 | Line 9 | rcontrib - compute contribution coefficients in a RADI
9   ][
10   .B \-V
11   ][
12 + .B "\-t secs"
13 + ][
14   .B "\-c count"
15   ][
16   .B \-fo
# Line 119 | Line 121 | Note that output flushing via zero-direction rays is d
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.
# Line 211 | Line 218 | Additional parameter values that apply only to this mo
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
# Line 283 | Line 290 | A command argument beginning with an at sign ('@') is
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
287 < 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
# Line 298 | Line 306 | discussed above. Ray coefficients are also supported v
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:
# Line 329 | Line 337 | rcontrib \-I+ \-h \-V \-fo \-o c_%s.dat \-M lights \-a
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"

Diff Legend

– Removed lines
+ Added lines
< Changed lines (old)
> Changed lines (new)