--- ray/doc/man/man1/rcontrib.1 2019/02/22 19:42:27 1.16 +++ ray/doc/man/man1/rcontrib.1 2022/10/19 21:25:20 1.21 @@ -1,4 +1,4 @@ -.\" RCSid "$Id: rcontrib.1,v 1.16 2019/02/22 19:42:27 greg Exp $" +.\" RCSid "$Id: rcontrib.1,v 1.21 2022/10/19 21:25:20 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 @@ -43,6 +45,8 @@ rtrace options .B octree .br .B "rcontrib [ options ] \-defaults" +.br +.B "rcontrib \-features [feat1 ..]" .SH DESCRIPTION .I Rcontrib computes ray coefficients @@ -119,6 +123,26 @@ Note that output flushing via zero-direction rays is d .I \-c set to zero. .PP +Output flushing at fixed intervals may be enabled with the +.I \-x +option, which specifies the number of records +(-c accumulations) before each flush. +If the +.I \-y +option is also set, then periodic flushing is disabled and the +output size for an RGB image is the taken from the x and y dimensions. +In lieu of periodic flushing, a flush may be forced as mentioned above +by sending a sample with a zero direction vector, although you +must still send a full record of rays before output occurs. +.PP +If progress reports are desired, the +.I \-t +option specifies a time interval in seconds for reports sent to +standard error. +This requires that the number of input samples is known, meaning a +.I \-y +parameter has been specified. +.PP The output of .I rcontrib has many potential uses. @@ -211,7 +235,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 @@ -302,7 +326,7 @@ density estimates results in omitted contributions, th 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: +by "light1" vs. "light2" on a set of irradiance values: .IP "" .2i rcontrib \-I+ @render.opt \-o c_%s.dat \-m light1 \-m light2 scene.oct < test.dat .PP @@ -318,7 +342,7 @@ of light1 and light2: .IP "" .2i pcomb \-c 100 90 75 c_light1.hdr \-c 50 55 57 c_light2.hdr > combined.hdr .PP -To compute an array of illuminance contributions according to a Tregenza sky: +To compute an array of irradiance contributions according to a Tregenza sky: .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