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.4 by greg, Thu Jan 1 19:31:45 2004 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 105 | Line 107 | s      surface name
107   .IP
108   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
131 < .BI -te \ mat
131 > .BI -te \ mod
132   Append
133 < .I mat
133 > .I mod
134   to the trace exclude list,
135   so that it will not be reported by the trace option
136   .I (\-o*t*).
137   Any ray striking an object having
138 < .I mat
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.
143 < Any number of excluded materials may be given, but each
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
146 < .BI -ti \ mat
146 > .BI -ti \ mod
147   Add
148 < .I mat
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
154   .BI -tE \ file
155   Same as
156   .I \-te,
157 < except read materials to be excluded from
157 > except read modifiers to be excluded from
158   .I file.
159   The RAYPATH environment variable determines which directories are
160   searched for this file.
161 < The material names are separated by white space in the file.
161 > The modifier names are separated by white space in the file.
162   .TP
163   .BI -tI \ file
164   Same as
165   .I \-ti,
166 < except read materials to be included from
166 > except read modifiers to be included from
167   .I file.
168   .TP
169   .BR \-i
# Line 163 | 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 427 | Line 448 | header of the ambient file.
448   .I Getinfo(1)
449   may be used to print out this information.
450   .TP
451 < .BI -ae \ mat
451 > .BI -ae \ mod
452   Append
453 < .I mat
453 > .I mod
454   to the ambient exclude list,
455   so that it will not be considered during the indirect calculation.
456   This is a hack for speeding the indirect computation by
457   ignoring certain objects.
458   Any object having
459 < .I mat
459 > .I mod
460   as its modifier will get the default ambient
461   level rather than a calculated value.
462 < Any number of excluded materials may be given, but each
462 > Any number of excluded modifiers may be given, but each
463   must appear in a separate option.
464   .TP
465 < .BI -ai \ mat
465 > .BI -ai \ mod
466   Add
467 < .I mat
467 > .I mod
468   to the ambient include list,
469   so that it will be considered during the indirect calculation.
470   The program can use either an include list or an exclude
# Line 452 | Line 473 | list, but not both.
473   .BI -aE \ file
474   Same as
475   .I \-ae,
476 < except read materials to be excluded from
476 > except read modifiers to be excluded from
477   .I file.
478   The RAYPATH environment variable determines which directories are
479   searched for this file.
480 < The material names are separated by white space in the file.
480 > The modifier names are separated by white space in the file.
481   .TP
482   .BI -aI \ file
483   Same as
484   .I \-ai,
485 < except read materials to be included from
485 > except read modifiers to be included from
486   .I file.
487   .TP
488   .BI -me " rext gext bext"
# Line 503 | 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 592 | Line 629 | cnt 640 480 | rcalc -e 'xr:640;yr:480' -f unusual_view
629   .SH ENVIRONMENT
630   RAYPATH         the directories to check for auxiliary files.
631   .SH FILES
632 < /usr/tmp/rtXXXXXX               common header information for picture sequence
632 > /tmp/rtXXXXXX           common header information for picture sequence
633   .SH DIAGNOSTICS
634   If the program terminates from an input related error, the exit status
635   will be 1.
# Line 607 | 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