--- ray/doc/man/man1/rcontrib.1 2016/09/12 20:31:34 1.13 +++ ray/doc/man/man1/rcontrib.1 2020/09/09 21:28:19 1.18 @@ -1,4 +1,4 @@ -.\" RCSid "$Id: rcontrib.1,v 1.13 2016/09/12 20:31:34 greg Exp $" +.\" RCSid "$Id: rcontrib.1,v 1.18 2020/09/09 21:28:19 greg Exp $" .TH RCONTRIB 1 5/25/05 RADIANCE .SH NAME rcontrib - compute contribution coefficients in a RADIANCE scene @@ -9,6 +9,8 @@ rcontrib - compute contribution coefficients in a RADI ][ .B \-V ][ +.B "\-t secs" +][ .B "\-c count" ][ .B \-fo @@ -119,6 +121,11 @@ Note that output flushing via zero-direction rays is d .I \-c set to zero. .PP +If progress reports are desired, the +.I \-t +option specifies a time interval in seconds for reports sent to +standard error. +.PP The output of .I rcontrib has many potential uses. @@ -211,7 +218,7 @@ Additional parameter values that apply only to this mo with a .I \-p option, which contains a list of variable names and assigned values, separated -by commas or semicolons. +by commas, colons, or semicolons. The computed bin value will be rounded to the nearest whole number. (Negative bin values will be silently ignored.)\0 @@ -283,12 +290,13 @@ A command argument beginning with an at sign ('@') is replaced by the contents of the given file. .PP .I Rcontrib -has EXPERIMENTAL support for light source contributions from photon maps -generated by +supports light source contributions from photon maps generated by .I mkpmap(1) with its .I -apC -option. In photon mapping mode, +option. Enabling photon mapping is described in the +.I rtrace +man page along with its relevant settings. In photon mapping mode, .I rcontrib only supports contributions from light sources, not arbitrary modifiers. The @@ -298,7 +306,7 @@ discussed above. Ray coefficients are also supported v .I \-V- option. Using fewer photons than there are light sources for the photon density estimates results in omitted contributions, thus the bandwidth -is clamped accordingly and a warning issued. +is clamped accordingly and a warning is issued. .SH EXAMPLES To compute the proportional contributions from sources modified by "light1" vs. "light2" on a set of illuminance values: @@ -329,6 +337,11 @@ rcontrib \-I+ \-h \-V \-fo \-o c_%s.dat \-M lights \-a scene.oct < test.dat, .SH ENVIRONMENT RAYPATH path to search for \-f and \-M files +.SH BUGS +We do not currently compute contributions or coefficients properly +in scenes with participating media. +A single warning will be issued if a scattering or absorbing medium +is detected. .SH AUTHOR Greg Ward .SH "SEE ALSO"