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

Comparing ray/doc/man/man1/rtrace.1 (file contents):
Revision 1.12 by greg, Mon Jun 13 20:07:55 2005 UTC vs.
Revision 1.20 by greg, Tue Jan 26 04:42:16 2010 UTC

# Line 87 | Line 87 | d      direction (normalized)
87   .IP
88   v       value (radiance)
89   .IP
90 + V       contribution (radiance)
91 + .IP
92   w       weight
93   .IP
94   W       color coefficient
# Line 178 | Line 180 | option (below) may be used to override this.
180   This option is especially useful in
181   conjunction with ximage(1) for computing illuminance at scene points.
182   .TP
183 < .BR \-R
184 < Boolean switch to control random sampling.
183 > .BR \-u
184 > Boolean switch to control uncorrelated random sampling.
185   When "off", a low-discrepancy sequence is used, which reduces
186   variance but can result in a brushed appearance in specular highlights.
187   When "on", pure Monte Carlo sampling is used in all calculations.
# Line 228 | Line 230 | format.
230   .I \-f
231   option, above.)
232   .TP
233 + .BI -n \ nproc
234 + Execute in parallel on
235 + .I nproc
236 + local processes.
237 + This option is incompatible with the
238 + .I \-P
239 + and
240 + .I \-PP,
241 + options.
242 + Multiple processes also do not work properly with ray tree output
243 + using any of the
244 + .I \-o*t*
245 + options.
246 + There is no benefit from specifying more processes than there are
247 + cores available on the system or the
248 + .I \-x
249 + setting, which forces a wait at each flush.
250 + .TP
251   .BI -dj \ frac
252   Set the direct jittering to
253   .I frac.
# Line 523 | Line 543 | source within a given scattering volume.
543   .TP
544   .BI -lr \ N
545   Limit reflections to a maximum of
546 < .I N.
546 > .I N,
547 > if N is a positive integer.
548   If
549   .I N
550   is zero or negative, then Russian roulette is used for ray
# Line 531 | Line 552 | termination, and the
552   .I -lw
553   setting (below) must be positive.
554   If N is a negative integer, then this sets the upper limit
555 < of reflections past which Russian roulette will not be used.
555 > of reflections past which Russian roulette will be used.
556   In scenes with dielectrics and total internal reflection,
557   a setting of 0 (no limit) may cause a stack overflow.
558   .TP
# Line 610 | Line 631 | system call will share memory on a copy-on-write basis
631   .SH EXAMPLES
632   To compute radiance values for the rays listed in samples.inp:
633   .IP "" .2i
634 < rtrace -ov scene.oct < samples.inp > radiance.out
634 > rtrace \-ov scene.oct < samples.inp > radiance.out
635   .PP
636   To compute illuminance values at locations selected with the 't'
637   command of
638   .I ximage(1):
639   .IP "" .2i
640 < ximage scene.pic | rtrace -h -x 1 -i scene.oct | rcalc -e '$1=47.4*$1+120*$2+11.6*$3'
640 > ximage scene.hdr | rtrace \-h \-x 1 \-i scene.oct | rcalc \-e '$1=47.4*$1+120*$2+11.6*$3'
641   .PP
642   To record the object identifier corresponding to each pixel in an image:
643   .IP "" .2i
644 < vwrays -fd scene.pic | rtrace -fda `vwrays -d scene.pic` -os scene.oct
644 > vwrays \-fd scene.hdr | rtrace \-fda `vwrays \-d scene.hdr` \-os scene.oct
645   .PP
646   To compute an image with an unusual view mapping:
647   .IP "" .2i
648 < cnt 640 480 | rcalc -e 'xr:640;yr:480' -f unusual_view.cal | rtrace
649 < -x 640 -y 480 -fac scene.oct > unusual.pic
648 > cnt 480 640 | rcalc \-e 'xr:640;yr:480' \-f unusual_view.cal | rtrace
649 > \-x 640 \-y 480 \-fac scene.oct > unusual.hdr
650   .SH ENVIRONMENT
651   RAYPATH         the directories to check for auxiliary files.
652   .SH FILES

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines