--- ray/doc/man/man1/rcontrib.1 2014/07/19 00:07:03 1.9 +++ ray/doc/man/man1/rcontrib.1 2015/02/24 19:39:26 1.12 @@ -1,4 +1,4 @@ -.\" RCSid "$Id: rcontrib.1,v 1.9 2014/07/19 00:07:03 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,6 +204,11 @@ 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 @@ -270,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: @@ -292,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) +