ViewVC Help

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

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

Comparing ray/doc/man/man1/robjutil.1 (file contents):
Revision 1.3 by greg, Thu Apr 2 20:50:59 2020 UTC vs.
Revision 1.6 by greg, Fri Mar 12 18:32:33 2021 UTC

#	Line 19 | Line 19 | robjutil - operate on Wavefront .OBJ file
19		][
20		.B "-c epsilon"
21		][
22	+	.B +T
23	+	][
24		.B "-x 'xf spec'"
25		]
26		[
#	Line 42 | Line 44 | and
44		.I obj2mesh(1)
45		converters.
46		The latter also preserves local texture coordinates for mapping materials.
47	+	.PP
48		The
49		.I +v
50		option turns on verbose progress reports.
#	Line 75 | Line 78 | The
78		and
79		.I \+m
80		options are mutually exclusive.
81	+	.PP
82		Similarly, the
83		.I "\-g gname"
84		option says to remove all faces belonging to the group
#	Line 85 | Line 89 | options may be given.
89		There is also a
90		.I +g
91		option to save just the named group(s).
92	+	Object statements are treated the same as group statements in the input, so
93	+	.I +/-g
94	+	option can also be applied to object names.
95	+	Note that an object name will be overridden by a group name that follows
96	+	it in the input, and vice versa.
97		.PP
98		The
99		.I "\-c epsilon"
#	Line 104 | Line 113 | which is usually not a problem for .OBJ output, but ma
113		scene descriptions (+r).
114		.PP
115		The
116	+	.I +T
117	+	option turns all faces with 4 or more sides into triangles.
118	+	.PP
119	+	The
120		.I \-x
121		option may be used to specify a final transform to apply to all
122		coordinates in the file before output.
#	Line 135 | Line 148 | robjutil +g cat +g bell kitty.obj | obj2mesh -a kitty.
148		To rotate the scene 90 degrees about the Y-axis and scale by 10:
149		.IP "" .2i
150		robjutil -x "-ry 90 -s 10" orig.obj > transformed.obj
151	+	.SH NOTES
152	+	The .OBJ output of
153	+	.I robjutil
154	+	uses relative indices, so files it produces may be concatenated
155	+	on the input of other tools such as
156	+	.I obj2rad
157	+	and
158	+	.I obj2mesh
159	+	by piping from
160	+	.I cat(1)
161	+	or similar.
162	+	This offers a convenient way to separate geometry from a single .OBJ
163	+	input, manipulate it in some way, then recombine during conversion.
164	+	.PP
165	+	Unlike
166	+	.I obj2rad
167	+	and
168	+	.I obj2mesh,
169	+	.I robjutil
170	+	with the
171	+	.I +r
172	+	option will not substitute the group name for a material id if no
173	+	.I usemtl
174	+	statements are found on the input.
175	+	Instead, it will assign each surface the material
176	+	.I DEFAULT_MATERIAL.
177	+	Since it is possible to use the
178	+	.I +/-g
179	+	option to select groups to include or exclude on output, it is
180	+	still possible to assign materials by group manually.
181		.SH AUTHOR
182		Greg Ward
183		.SH "SEE ALSO"
184	<	obj2mesh(1), obj2rad(1) oconv(1), xform(1)
184	>	cat(1), obj2mesh(1), obj2rad(1) oconv(1), xform(1)

Diff Legend

–	Removed lines
+	Added lines
<	Changed lines (old)
>	Changed lines (new)