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.3 by greg, Tue Dec 9 15:59:07 2003 UTC vs.
Revision 1.9 by greg, Thu May 26 06:55:22 2005 UTC

# Line 89 | Line 89 | v      value (radiance)
89   .IP
90   w       weight
91   .IP
92 + W       contribution
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 427 | Line 442 | header of the ambient file.
442   .I Getinfo(1)
443   may be used to print out this information.
444   .TP
445 < .BI -ae \ mat
445 > .BI -ae \ mod
446   Append
447 < .I mat
447 > .I mod
448   to the ambient exclude list,
449   so that it will not be considered during the indirect calculation.
450   This is a hack for speeding the indirect computation by
451   ignoring certain objects.
452   Any object having
453 < .I mat
453 > .I mod
454   as its modifier will get the default ambient
455   level rather than a calculated value.
456 < Any number of excluded materials may be given, but each
456 > Any number of excluded modifiers may be given, but each
457   must appear in a separate option.
458   .TP
459 < .BI -ai \ mat
459 > .BI -ai \ mod
460   Add
461 < .I mat
461 > .I mod
462   to the ambient include list,
463   so that it will be considered during the indirect calculation.
464   The program can use either an include list or an exclude
# Line 452 | Line 467 | list, but not both.
467   .BI -aE \ file
468   Same as
469   .I \-ae,
470 < except read materials to be excluded from
470 > except read modifiers to be excluded from
471   .I file.
472   The RAYPATH environment variable determines which directories are
473   searched for this file.
474 < The material names are separated by white space in the file.
474 > The modifier names are separated by white space in the file.
475   .TP
476   .BI -aI \ file
477   Same as
478   .I \-ai,
479 < except read materials to be included from
479 > except read modifiers to be included from
480   .I file.
481   .TP
482   .BI -me " rext gext bext"
# Line 592 | Line 607 | cnt 640 480 | rcalc -e 'xr:640;yr:480' -f unusual_view
607   .SH ENVIRONMENT
608   RAYPATH         the directories to check for auxiliary files.
609   .SH FILES
610 < /usr/tmp/rtXXXXXX               common header information for picture sequence
610 > /tmp/rtXXXXXX           common header information for picture sequence
611   .SH DIAGNOSTICS
612   If the program terminates from an input related error, the exit status
613   will be 1.
# Line 607 | Line 622 | option.
622   Greg Ward
623   .SH "SEE ALSO"
624   getinfo(1), lookamb(1), oconv(1), pfilt(1), pinterp(1),
625 < pvalue(1), rpict(1), rview(1), vwrays(1), ximage(1)
625 > pvalue(1), rpict(1), rtcontrib(1), rvu(1), vwrays(1), ximage(1)

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines