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.1 by greg, Tue Mar 11 19:20:21 2003 UTC vs.
Revision 1.14 by greg, Sun Feb 5 22:22:20 2006 UTC

# Line 1 | Line 1
1 < .\" RCSid "$Id"
1 > .\" RCSid "$Id$"
2   .TH RTRACE 1 10/17/97 RADIANCE
3   .SH NAME
4   rtrace - trace rays in RADIANCE scene
# 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
99   .IP
100 + c       local (u,v) coordinates
101 + .IP
102   p       point of intersection
103   .IP
104   n       normal at intersection (perturbed)
# Line 103 | Line 109 | s      surface name
109   .IP
110   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
133 < .BI -te \ mat
133 > .BI -te \ mod
134   Append
135 < .I mat
135 > .I mod
136   to the trace exclude list,
137   so that it will not be reported by the trace option
138   .I (\-o*t*).
139   Any ray striking an object having
140 < .I mat
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.
145 < Any number of excluded materials may be given, but each
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
148 < .BI -ti \ mat
148 > .BI -ti \ mod
149   Add
150 < .I mat
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
156   .BI -tE \ file
157   Same as
158   .I \-te,
159 < except read materials to be excluded from
159 > except read modifiers to be excluded from
160   .I file.
161   The RAYPATH environment variable determines which directories are
162   searched for this file.
163 < The material names are separated by white space in the file.
163 > The modifier names are separated by white space in the file.
164   .TP
165   .BI -tI \ file
166   Same as
167   .I \-ti,
168 < except read materials to be included from
168 > except read modifiers to be included from
169   .I file.
170   .TP
171   .BR \-i
# Line 161 | 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 425 | Line 450 | header of the ambient file.
450   .I Getinfo(1)
451   may be used to print out this information.
452   .TP
453 < .BI -ae \ mat
453 > .BI -ae \ mod
454   Append
455 < .I mat
455 > .I mod
456   to the ambient exclude list,
457   so that it will not be considered during the indirect calculation.
458   This is a hack for speeding the indirect computation by
459   ignoring certain objects.
460   Any object having
461 < .I mat
461 > .I mod
462   as its modifier will get the default ambient
463   level rather than a calculated value.
464 < Any number of excluded materials may be given, but each
464 > Any number of excluded modifiers may be given, but each
465   must appear in a separate option.
466   .TP
467 < .BI -ai \ mat
467 > .BI -ai \ mod
468   Add
469 < .I mat
469 > .I mod
470   to the ambient include list,
471   so that it will be considered during the indirect calculation.
472   The program can use either an include list or an exclude
# Line 450 | Line 475 | list, but not both.
475   .BI -aE \ file
476   Same as
477   .I \-ae,
478 < except read materials to be excluded from
478 > except read modifiers to be excluded from
479   .I file.
480   The RAYPATH environment variable determines which directories are
481   searched for this file.
482 < The material names are separated by white space in the file.
482 > The modifier names are separated by white space in the file.
483   .TP
484   .BI -aI \ file
485   Same as
486   .I \-ai,
487 < except read materials to be included from
487 > except read modifiers to be included from
488   .I file.
489   .TP
490   .BI -me " rext gext bext"
# Line 501 | 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 590 | Line 631 | cnt 640 480 | rcalc -e 'xr:640;yr:480' -f unusual_view
631   .SH ENVIRONMENT
632   RAYPATH         the directories to check for auxiliary files.
633   .SH FILES
634 < /usr/tmp/rtXXXXXX               common header information for picture sequence
634 > /tmp/rtXXXXXX           common header information for picture sequence
635   .SH DIAGNOSTICS
636   If the program terminates from an input related error, the exit status
637   will be 1.
# Line 605 | 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), rview(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