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.6 by greg, Thu Apr 14 18:04:12 2005 UTC vs.
Revision 1.13 by greg, Tue Jun 14 03:34:14 2005 UTC

# Line 89 | Line 89 | v      value (radiance)
89   .IP
90   w       weight
91   .IP
92 + W       color coefficient
93 + .IP
94   l       effective length of ray
95   .IP
96   L       first intersection distance
# Line 107 | Line 109 | m      modifier name
109   .IP
110   M       material name
111   .IP
112 + ~       tilde (end of trace marker)
113 + .IP
114   If the letter 't' appears in
115   .I spec,
116   then the fields following will be printed for every ray traced,
117   not just the final result.
118 + If the capital letter 'T' is given instead of 't', then all rays will
119 + be reported, including shadow testing rays to light sources.
120   Spawned rays are indented one tab for each level.
121 + The tilde marker ('~') is a handy way of differentiating the final ray
122 + value from daughter values in a traced ray tree, and usually appears
123 + right before the 't' or 'T' output flags.
124 + E.g.,
125 + .I \-ov~TmW
126 + will emit a tilde followed by a tab at the end of each trace,
127 + which can be easily distinguished even in binary output.
128   .IP
129   Note that there is no space between this option and its argument.
130   .TP
# Line 125 | Line 138 | Any ray striking an object having
138   .I mod
139   as its modifier will not be reported to the standard output with
140   the rest of the rays being traced.
141 < This option has no effect unless the 't' option has been given as
142 < part of the output specifier.
141 > This option has no effect unless either the 't' or 'T'
142 > option has been given as part of the output specifier.
143   Any number of excluded modifiers may be given, but each
144   must appear in a separate option.
145   .TP
# Line 134 | Line 147 | must appear in a separate option.
147   Add
148   .I mod
149   to the trace include list,
150 < so that it will be considered during the indirect calculation.
150 > so that it will be reported by the trace option.
151   The program can use either an include list or an exclude
152   list, but not both.
153   .TP
# Line 165 | Line 178 | option (below) may be used to override this.
178   This option is especially useful in
179   conjunction with ximage(1) for computing illuminance at scene points.
180   .TP
181 + .BR \-u
182 + Boolean switch to control uncorrelated random sampling.
183 + When "off", a low-discrepancy sequence is used, which reduces
184 + variance but can result in a brushed appearance in specular highlights.
185 + When "on", pure Monte Carlo sampling is used in all calculations.
186 + .TP
187   .BR \-I
188   Boolean switch to compute irradiance rather than radiance,
189   with the input origin and direction interpreted instead
# Line 505 | Line 524 | source within a given scattering volume.
524   .BI -lr \ N
525   Limit reflections to a maximum of
526   .I N.
527 + If
528 + .I N
529 + is zero or negative, then Russian roulette is used for ray
530 + termination, and the
531 + .I -lw
532 + setting (below) must be positive.
533 + If N is a negative integer, then this sets the upper limit
534 + of reflections past which Russian roulette will not be used.
535 + In scenes with dielectrics and total internal reflection,
536 + a setting of 0 (no limit) may cause a stack overflow.
537   .TP
538   .BI -lw \ frac
539   Limit the weight of each ray to a minimum of
540   .I frac.
541 < During ray-tracing, a record is kept of the final contribution
542 < a ray would have to the image.
543 < If it is less then the specified minimum, the ray is not traced.
541 > During ray-tracing, a record is kept of the estimated contribution
542 > (weight) a ray would have in the image.
543 > If this weight is less than the specified minimum and the
544 > .I -lr
545 > setting (above) is positive, the ray is not traced.
546 > Otherwise, Russian roulette is used to
547 > continue rays with a probability equal to the ray weight
548 > divided by the given
549 > .I frac.
550   .TP
551   .BR -ld
552   Boolean switch to limit ray distance.
# Line 609 | Line 644 | option.
644   Greg Ward
645   .SH "SEE ALSO"
646   getinfo(1), lookamb(1), oconv(1), pfilt(1), pinterp(1),
647 < pvalue(1), rpict(1), rvu(1), vwrays(1), ximage(1)
647 > pvalue(1), rpict(1), rtcontrib(1), rvu(1), vwrays(1), ximage(1)

Diff Legend

– Removed lines
+ Added lines
< Changed lines
> Changed lines