ViewVC Help

View File | Revision Log | Show Annotations | Download File | Root Listing

root/Development/ray/doc/man/man1/rtrace.1

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 (old)
>	Changed lines (new)