--- ray/doc/man/man1/rcontrib.1	2014/07/11 01:52:38	1.8
+++ ray/doc/man/man1/rcontrib.1	2015/02/24 19:39:26	1.12
@@ -1,4 +1,4 @@
-.\" RCSid "$Id: rcontrib.1,v 1.8 2014/07/11 01:52:38 greg Exp $"
+.\" RCSid "$Id: rcontrib.1,v 1.12 2015/02/24 19:39:26 greg Exp $"
 .TH RCONTRIB 1 5/25/05 RADIANCE
 .SH NAME
 rcontrib - compute contribution coefficients in a RADIANCE scene
@@ -21,6 +21,8 @@ rcontrib - compute contribution coefficients in a RADI
 ][
 .B "\-o ospec"
 ][
+.B "\-p p1=V1,p2=V2"
+][
 .B "\-b binv"
 ][
 .B "\-bn nbins"
@@ -172,6 +174,7 @@ option.
 Since bin numbers start from zero, the bin count is always equal to
 the last bin plus one.
 The most recent
+.I \-p,
 .I \-b,
 .I \-bn
 and
@@ -201,8 +204,14 @@ These parameters may be combined with definitions give
 arguments and files read using the
 .I \-f
 option.
+Additional parameter values that apply only to this modifier may be specified
+with a
+.I \-p
+option, which contains a list of variable names and assigned values, separated
+by commas or semicolons.
 The computed bin value will be
 rounded to the nearest whole number.
+(Negative bin values will be silently ignored.)\0
 For a single bin, you may specify
 .I "\-b 0",
 which is the default.
@@ -269,6 +278,24 @@ A command argument beginning with a dollar sign ('$') 
 replaced by the contents of the given environment variable.
 A command argument beginning with an at sign ('@') is immediately
 replaced by the contents of the given file.
+.PP
+.I Rcontrib
+has EXPERIMENTAL support for light source contributions from photon maps
+generated by
+.I mkpmap(1)
+with its
+.I -apC
+option. In photon mapping mode,
+.I rcontrib
+only supports contributions from light sources, not arbitrary modifiers.
+The
+.I -b
+option is supported along with its associated ray variables, as
+discussed above. Ray coefficients are also supported via the
+.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.
 .SH EXAMPLES
 To compute the proportional contributions from sources modified
 by "light1" vs. "light2" on a set of illuminance values:
@@ -291,10 +318,18 @@ To compute an array of illuminance contributions accor
 .IP "" .2i
 rcontrib \-I+ \-f tregenza.cal \-b tbin \-bn Ntbins \-o sky.dat \-m skyglow
 \-b 0 \-o ground.dat \-m groundglow @render.opt scene.oct < test.dat
+.PP
+To perform an annual simulation of 365 daily sun positions in photon mapping
+mode:
+.IP "" .2i
+rcontrib \-I+ \-h \-V \-fo \-o c_%s.dat \-M lights \-ap contrib.pm 365
+scene.oct < test.dat,
 .SH ENVIRONMENT
 RAYPATH		path to search for \-f and \-M files
 .SH AUTHOR
 Greg Ward
 .SH "SEE ALSO"
-cnt(1), genklemsamp(1), getinfo(1), pcomb(1), pfilt(1), ra_rgbe(1),
-rcalc(1), rpict(1), rsensor(1), rtrace(1), total(1), vwrays(1), ximage(1)
+cnt(1), genklemsamp(1), getinfo(1), mkpmap(1), pcomb(1), pfilt(1), 
+ra_rgbe(1), rcalc(1), rfluxmtx(1), rmtxop(1), rpict(1), rsensor(1), 
+rtrace(1), total(1), vwrays(1), ximage(1)
+