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.14 by greg, Sun Feb 5 22:22:20 2006 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
95 + .IP
96   l       effective length of ray
97   .IP
98   L       first intersection distance
# Line 107 | Line 111 | m      modifier name
111   .IP
112   M       material name
113   .IP
114 + ~       tilde (end of trace marker)
115 + .IP
116   If the letter 't' appears in
117   .I spec,
118   then the fields following will be printed for every ray traced,
119   not just the final result.
120 + If the capital letter 'T' is given instead of 't', then all rays will
121 + be reported, including shadow testing rays to light sources.
122   Spawned rays are indented one tab for each level.
123 + The tilde marker ('~') is a handy way of differentiating the final ray
124 + value from daughter values in a traced ray tree, and usually appears
125 + right before the 't' or 'T' output flags.
126 + E.g.,
127 + .I \-ov~TmW
128 + will emit a tilde followed by a tab at the end of each trace,
129 + which can be easily distinguished even in binary output.
130   .IP
131   Note that there is no space between this option and its argument.
132   .TP
# Line 125 | Line 140 | Any ray striking an object having
140   .I mod
141   as its modifier will not be reported to the standard output with
142   the rest of the rays being traced.
143 < This option has no effect unless the 't' option has been given as
144 < part of the output specifier.
143 > This option has no effect unless either the 't' or 'T'
144 > option has been given as part of the output specifier.
145   Any number of excluded modifiers may be given, but each
146   must appear in a separate option.
147   .TP
# Line 134 | Line 149 | must appear in a separate option.
149   Add
150   .I mod
151   to the trace include list,
152 < so that it will be considered during the indirect calculation.
152 > so that it will be reported by the trace option.
153   The program can use either an include list or an exclude
154   list, but not both.
155   .TP
# Line 165 | 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 \-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.
188 + .TP
189   .BR \-I
190   Boolean switch to compute irradiance rather than radiance,
191   with the input origin and direction interpreted instead
# Line 505 | Line 526 | source within a given scattering volume.
526   .BI -lr \ N
527   Limit reflections to a maximum of
528   .I N.
529 + If
530 + .I N
531 + is zero or negative, then Russian roulette is used for ray
532 + termination, and the
533 + .I -lw
534 + setting (below) must be positive.
535 + If N is a negative integer, then this sets the upper limit
536 + of reflections past which Russian roulette will not be used.
537 + In scenes with dielectrics and total internal reflection,
538 + a setting of 0 (no limit) may cause a stack overflow.
539   .TP
540   .BI -lw \ frac
541   Limit the weight of each ray to a minimum of
542   .I frac.
543 < During ray-tracing, a record is kept of the final contribution
544 < a ray would have to the image.
545 < If it is less then the specified minimum, the ray is not traced.
543 > During ray-tracing, a record is kept of the estimated contribution
544 > (weight) a ray would have in the image.
545 > If this weight is less than the specified minimum and the
546 > .I -lr
547 > setting (above) is positive, the ray is not traced.
548 > Otherwise, Russian roulette is used to
549 > continue rays with a probability equal to the ray weight
550 > divided by the given
551 > .I frac.
552   .TP
553   .BR -ld
554   Boolean switch to limit ray distance.
# Line 609 | Line 646 | option.
646   Greg Ward
647   .SH "SEE ALSO"
648   getinfo(1), lookamb(1), oconv(1), pfilt(1), pinterp(1),
649 < pvalue(1), rpict(1), rvu(1), vwrays(1), ximage(1)
649 > pvalue(1), rpict(1), rtcontrib(1), rvu(1), vwrays(1), ximage(1)

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines