[ViewVC] Diff of: Development/ray/doc/man/man1/rtrace.1

Comparing ray/doc/man/man1/rtrace.1 (file contents):
Revision 1.5 by greg, Wed Feb 16 05:40:07 2005 UTC vs.
Revision 1.18 by greg, Sat Dec 12 19:00:59 2009 UTC

+.IP
+v       value (radiance)
+.IP
-+
+V       contribution (radiance)
-+
+.IP
+w       weight
+.IP
-+
+W       color coefficient
-+
+.IP
+l       effective length of ray
+.IP
+L       first intersection distance
+.IP
+m       modifier name
+.IP
-+
+M       material name
-+
+.IP
-+
+~       tilde (end of trace marker)
-+
+.IP
+If the letter 't' appears in
+.I spec,
+then the fields following will be printed for every ray traced,
+not just the final result.
-+
+If the capital letter 'T' is given instead of 't', then all rays will
-+
+be reported, including shadow testing rays to light sources.
+Spawned rays are indented one tab for each level.
-+
+The tilde marker ('~') is a handy way of differentiating the final ray
-+
+value from daughter values in a traced ray tree, and usually appears
-+
+right before the 't' or 'T' output flags.
-+
+E.g.,
-+
+.I \-ov~TmW
-+
+will emit a tilde followed by a tab at the end of each trace,
-+
+which can be easily distinguished even in binary output.
+.IP
+Note that there is no space between this option and its argument.
+.TP
-<
+.BI -te \ mat
->
+.BI -te \ mod
+Append
-<
+.I mat
->
+.I mod
+to the trace exclude list,
+so that it will not be reported by the trace option
+.I (\-o*t*).
+Any ray striking an object having
-<
+.I mat
->
+.I mod
+as its modifier will not be reported to the standard output with
+the rest of the rays being traced.
-<
+This option has no effect unless the 't' option has been given as
-<
+part of the output specifier.
-<
+Any number of excluded materials may be given, but each
->
+This option has no effect unless either the 't' or 'T'
->
+option has been given as part of the output specifier.
->
+Any number of excluded modifiers may be given, but each
+must appear in a separate option.
+.TP
-<
+.BI -ti \ mat
->
+.BI -ti \ mod
+Add
-<
+.I mat
->
+.I mod
+to the trace include list,
-<
+so that it will be considered during the indirect calculation.
->
+so that it will be reported by the trace option.
+The program can use either an include list or an exclude
+list, but not both.
+.TP
+.BI -tE \ file
+Same as
+.I \-te,
-<
+except read materials to be excluded from
->
+except read modifiers to be excluded from
+.I file.
+The RAYPATH environment variable determines which directories are
+searched for this file.
-<
+The material names are separated by white space in the file.
->
+The modifier names are separated by white space in the file.
+.TP
+.BI -tI \ file
+Same as
+.I \-ti,
-<
+except read materials to be included from
->
+except read modifiers to be included from
+.I file.
+.TP
+.BR \-i
+This option is especially useful in
+conjunction with ximage(1) for computing illuminance at scene points.
+.TP
-+
+.BR \-u
-+
+Boolean switch to control uncorrelated random sampling.
-+
+When "off", a low-discrepancy sequence is used, which reduces
-+
+variance but can result in a brushed appearance in specular highlights.
-+
+When "on", pure Monte Carlo sampling is used in all calculations.
-+
+.TP
+.BR \-I
+Boolean switch to compute irradiance rather than radiance,
+with the input origin and direction interpreted instead
+.I \-f
+option, above.)
+.TP
-+
+.BI -n \ nproc
-+
+Execute in parallel on
-+
+.I nproc
-+
+local processes.
-+
+This option is incompatible with
-+
+.I \-P
-+
+and
-+
+.I \-PP,
-+
+and is not currently supported with the
-+
+.I \-I
-+
+option.
-+
+Multiple processes also do not work properly with ray tree output
-+
+using any of the
-+
+.I \-o*t*
-+
+options.
-+
+There is no benefit from specifying more processes than there are
-+
+cores available on the system or the
-+
+.I \-x
-+
+setting, which forces a wait at each flush.
-+
+.TP
+.BI -dj \ frac
+Set the direct jittering to
+.I frac.
+.I Getinfo(1)
+may be used to print out this information.
+.TP
-<
+.BI -ae \ mat
->
+.BI -ae \ mod
+Append
-<
+.I mat
->
+.I mod
+to the ambient exclude list,
+so that it will not be considered during the indirect calculation.
+This is a hack for speeding the indirect computation by
+ignoring certain objects.
+Any object having
-<
+.I mat
->
+.I mod
+as its modifier will get the default ambient
+level rather than a calculated value.
-<
+Any number of excluded materials may be given, but each
->
+Any number of excluded modifiers may be given, but each
+must appear in a separate option.
+.TP
-<
+.BI -ai \ mat
->
+.BI -ai \ mod
+Add
-<
+.I mat
->
+.I mod
+to the ambient include list,
+so that it will be considered during the indirect calculation.
+The program can use either an include list or an exclude
+.BI -aE \ file
+Same as
+.I \-ae,
-<
+except read materials to be excluded from
->
+except read modifiers to be excluded from
+.I file.
+The RAYPATH environment variable determines which directories are
+searched for this file.
-<
+The material names are separated by white space in the file.
->
+The modifier names are separated by white space in the file.
+.TP
+.BI -aI \ file
+Same as
+.I \-ai,
-<
+except read materials to be included from
->
+except read modifiers to be included from
+.I file.
+.TP
+.BI -me " rext gext bext"
+.BI -lr \ N
+Limit reflections to a maximum of
+.I N.
-+
+If
-+
+.I N
-+
+is zero or negative, then Russian roulette is used for ray
-+
+termination, and the
-+
+.I -lw
-+
+setting (below) must be positive.
-+
+If N is a negative integer, then this sets the upper limit
-+
+of reflections past which Russian roulette will not be used.
-+
+In scenes with dielectrics and total internal reflection,
-+
+a setting of 0 (no limit) may cause a stack overflow.
+.TP
+.BI -lw \ frac
+Limit the weight of each ray to a minimum of
+.I frac.
-<
+During ray-tracing, a record is kept of the final contribution
-<
+a ray would have to the image.
-<
+If it is less then the specified minimum, the ray is not traced.
->
+During ray-tracing, a record is kept of the estimated contribution
->
+(weight) a ray would have in the image.
->
+If this weight is less than the specified minimum and the
->
+.I -lr
->
+setting (above) is positive, the ray is not traced.
->
+Otherwise, Russian roulette is used to
->
+continue rays with a probability equal to the ray weight
->
+divided by the given
->
+.I frac.
+.TP
+.BR -ld
+Boolean switch to limit ray distance.
+.SH EXAMPLES
+To compute radiance values for the rays listed in samples.inp:
+.IP "" .2i
-<
+rtrace -ov scene.oct < samples.inp > radiance.out
->
+rtrace \-ov scene.oct < samples.inp > radiance.out
+.PP
+To compute illuminance values at locations selected with the 't'
+command of
+.I ximage(1):
+.IP "" .2i
-<
+ximage scene.pic | rtrace -h -x 1 -i scene.oct | rcalc -e '$1=47.4*$1+120*$2+11.6*$3'
->
+ximage scene.hdr | rtrace \-h \-x 1 \-i scene.oct | rcalc \-e '$1=47.4*$1+120*$2+11.6*$3'
+.PP
+To record the object identifier corresponding to each pixel in an image:
+.IP "" .2i
-<
+vwrays -fd scene.pic | rtrace -fda `vwrays -d scene.pic` -os scene.oct
->
+vwrays \-fd scene.hdr | rtrace \-fda `vwrays \-d scene.hdr` \-os scene.oct
+.PP
+To compute an image with an unusual view mapping:
+.IP "" .2i
-<
+cnt 640 480 | rcalc -e 'xr:640;yr:480' -f unusual_view.cal | rtrace
-<
+-x 640 -y 480 -fac scene.oct > unusual.pic
->
+cnt 480 640 | rcalc \-e 'xr:640;yr:480' \-f unusual_view.cal | rtrace
->
+\-x 640 \-y 480 \-fac scene.oct > unusual.hdr
+.SH ENVIRONMENT
+RAYPATH         the directories to check for auxiliary files.
+.SH FILES
+Greg Ward
+.SH "SEE ALSO"
+getinfo(1), lookamb(1), oconv(1), pfilt(1), pinterp(1),
-<
+pvalue(1), rpict(1), rvu(1), vwrays(1), ximage(1)
->
+pvalue(1), rpict(1), rtcontrib(1), rvu(1), vwrays(1), ximage(1)

Diff Legend

-–
+Removed lines
-+
+Added lines
-<
+Changed lines (old)
->
+Changed lines (new)

Comparing ray/doc/man/man1/rtrace.1 (file contents): Revision 1.5 by greg, Wed Feb 16 05:40:07 2005 UTC vs. Revision 1.18 by greg, Sat Dec 12 19:00:59 2009 UTC

Diff Legend

Comparing ray/doc/man/man1/rtrace.1 (file contents):
Revision 1.5 by greg, Wed Feb 16 05:40:07 2005 UTC vs.
Revision 1.18 by greg, Sat Dec 12 19:00:59 2009 UTC