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

Comparing ray/doc/man/man1/rcontrib.1 (file contents):
Revision 1.6 by greg, Thu Nov 15 19:41:03 2012 UTC vs.
Revision 1.12 by greg, Tue Feb 24 19:39:26 2015 UTC

# Line 21 | Line 21 | rcontrib - compute contribution coefficients in a RADI
21   ][
22   .B "\-o ospec"
23   ][
24 + .B "\-p p1=V1,p2=V2"
25 + ][
26   .B "\-b binv"
27   ][
28   .B "\-bn nbins"
# Line 171 | Line 173 | or
173   option.
174   Since bin numbers start from zero, the bin count is always equal to
175   the last bin plus one.
174 Set the this value to zero if the bin count is unknown (the default).
176   The most recent
177 + .I \-p,
178   .I \-b,
179   .I \-bn
180   and
# Line 202 | Line 204 | These parameters may be combined with definitions give
204   arguments and files read using the
205   .I \-f
206   option.
207 + Additional parameter values that apply only to this modifier may be specified
208 + with a
209 + .I \-p
210 + option, which contains a list of variable names and assigned values, separated
211 + by commas or semicolons.
212   The computed bin value will be
213   rounded to the nearest whole number.
214 + (Negative bin values will be silently ignored.)\0
215 + For a single bin, you may specify
216 + .I "\-b 0",
217 + which is the default.
218   This mechanism allows the user to define precise regions or directions
219   they wish to accumulate, such as the Tregenza sky discretization,
220   which would be otherwise impossible to specify
# Line 212 | Line 223 | The rules and predefined functions available for these
223   described in the
224   .I rcalc(1)
225   man page.
226 < Unlike
226 > Like
227   .I rcalc,
228   .I rcontrib
229   will search the RADIANCE library directories for each file given in a
# Line 267 | Line 278 | A command argument beginning with a dollar sign ('$')
278   replaced by the contents of the given environment variable.
279   A command argument beginning with an at sign ('@') is immediately
280   replaced by the contents of the given file.
281 + .PP
282 + .I Rcontrib
283 + has EXPERIMENTAL support for light source contributions from photon maps
284 + generated by
285 + .I mkpmap(1)
286 + with its
287 + .I -apC
288 + option. In photon mapping mode,
289 + .I rcontrib
290 + only supports contributions from light sources, not arbitrary modifiers.
291 + The
292 + .I -b
293 + option is supported along with its associated ray variables, as
294 + discussed above. Ray coefficients are also supported via the
295 + .I \-V-
296 + option. Using fewer photons than there are light sources for the photon
297 + density estimates results in omitted contributions, thus the bandwidth
298 + is clamped accordingly and a warning issued.
299   .SH EXAMPLES
300   To compute the proportional contributions from sources modified
301   by "light1" vs. "light2" on a set of illuminance values:
# Line 287 | Line 316 | pcomb \-c 100 90 75 c_light1.hdr \-c 50 55 57 c_light2
316   .PP
317   To compute an array of illuminance contributions according to a Tregenza sky:
318   .IP "" .2i
319 < rcontrib \-I+ \-b tbin \-o sky.dat \-m skyglow \-b 0 \-o ground.dat \-m groundglow
320 < @render.opt \-f tregenza.cal scene.oct < test.dat
319 > rcontrib \-I+ \-f tregenza.cal \-b tbin \-bn Ntbins \-o sky.dat \-m skyglow
320 > \-b 0 \-o ground.dat \-m groundglow @render.opt scene.oct < test.dat
321 > .PP
322 > To perform an annual simulation of 365 daily sun positions in photon mapping
323 > mode:
324 > .IP "" .2i
325 > rcontrib \-I+ \-h \-V \-fo \-o c_%s.dat \-M lights \-ap contrib.pm 365
326 > scene.oct < test.dat,
327   .SH ENVIRONMENT
328   RAYPATH         path to search for \-f and \-M files
329   .SH AUTHOR
330   Greg Ward
331   .SH "SEE ALSO"
332 < cnt(1), genklemsamp(1), getinfo(1), pcomb(1), pfilt(1), ra_rgbe(1),
333 < rcalc(1), rpict(1), rsensor(1), rtrace(1), total(1), vwrays(1), ximage(1)
332 > cnt(1), genklemsamp(1), getinfo(1), mkpmap(1), pcomb(1), pfilt(1),
333 > ra_rgbe(1), rcalc(1), rfluxmtx(1), rmtxop(1), rpict(1), rsensor(1),
334 > rtrace(1), total(1), vwrays(1), ximage(1)
335 >

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines