ViewVC Help
View File | Revision Log | Show Annotations | Download File | Root Listing
root/radiance/ray/doc/man/man1/robjutil.1
(Generate patch)

Comparing ray/doc/man/man1/robjutil.1 (file contents):
Revision 1.1 by greg, Mon Mar 30 18:28:35 2020 UTC vs.
Revision 1.5 by greg, Fri Apr 3 02:45:13 2020 UTC

# Line 18 | Line 18 | robjutil - operate on Wavefront .OBJ file
18   .B "+/-g gname"
19   ][
20   .B "-c epsilon"
21 + ][
22 + .B "-x 'xf spec'"
23   ]
24   [
25   .B input.obj ..
# Line 40 | Line 42 | and
42   .I obj2mesh(1)
43   converters.
44   The latter also preserves local texture coordinates for mapping materials.
45 + .PP
46   The
47   .I +v
48   option turns on verbose progress reports.
# Line 73 | Line 76 | The
76   and
77   .I \+m
78   options are mutually exclusive.
79 + .PP
80   Similarly, the
81   .I "\-g gname"
82   option says to remove all faces belonging to the group
# Line 83 | Line 87 | options may be given.
87   There is also a
88   .I +g
89   option to save just the named group(s).
90 + Object statements are treated the same as group statements in the input, so
91 + .I +/-g
92 + option can also be applied to object names.
93 + Note that an object name will be overridden by a group name that follows
94 + it in the input, and vice versa.
95   .PP
96 < Finally, a
96 > The
97   .I "\-c epsilon"
98 < parameter may be given to coalesce vertices that are within the given epsilon.
98 > option tells
99 > .I robjutil
100 > to coalesce vertices that are within the given epsilon.
101   This is useful to improve the connectivity of models that were produced
102   in a sloppy conversion process from independent polygons.
103   When producing a Radiance file via the
# Line 98 | Line 109 | at least for triangle mesh input.
109   does not attempt to break up non-planar polygons into triangles,
110   which is usually not a problem for .OBJ output, but may be for Radiance
111   scene descriptions (+r).
112 + .PP
113 + The
114 + .I \-x
115 + option may be used to specify a final transform to apply to all
116 + coordinates in the file before output.
117 + This specification must be contained in a single quoted word and
118 + match the standard arguments used by
119 + .I xform(1),
120 + except that the
121 + .I \-a
122 + option is not supported for creating arrays of objects.
123 + Also, any scaling factors do not affect the epsilon value given for
124 + coalescing vertices, as this operation is applied prior to the transform,
125 + even if
126 + .I \-c
127 + appears later in the command line.
128   .SH EXAMPLES
129   To remove degenerate and duplicate faces from "orig.obj" and write to "final.rad":
130   .IP "" .2i
# Line 111 | Line 138 | To extract only the groups "cat" and "bell" from the f
138   write to a Radiance triangle mesh using materials from "kitty.mat":
139   .IP "" .2i
140   robjutil +g cat +g bell kitty.obj | obj2mesh -a kitty.mat > kitty.rtm
141 + .PP
142 + To rotate the scene 90 degrees about the Y-axis and scale by 10:
143 + .IP "" .2i
144 + robjutil -x "-ry 90 -s 10" orig.obj > transformed.obj
145 + .SH NOTES
146 + The .OBJ output of
147 + .I robjutil
148 + uses relative indices, so files it produces may be concatenated
149 + on the input of other tools such as
150 + .I obj2rad
151 + and
152 + .I obj2mesh
153 + by piping from
154 + .I cat(1)
155 + or similar.
156 + This offers a convenient way to separate geometry from a single .OBJ
157 + input, manipulate it in some way, then recombine during conversion.
158 + .PP
159 + Unlike
160 + .I obj2rad
161 + and
162 + .I obj2mesh,
163 + .I robjutil
164 + with the
165 + .I +r
166 + option will not substitute the group name for a material id if no
167 + .I usemtl
168 + statements are found on the input.
169 + Instead, it will assign each surface the material
170 + .I DEFAULT_MATERIAL.
171 + Since it is possible to use the
172 + .I +/-g
173 + option to select groups to include or exclude on output, it is
174 + still possible to assign materials by group manually.
175   .SH AUTHOR
176   Greg Ward
177   .SH "SEE ALSO"
178 < obj2mesh(1), obj2rad(1) oconv(1), xform(1)
178 > cat(1), obj2mesh(1), obj2rad(1) oconv(1), xform(1)

Diff Legend

– Removed lines
+ Added lines
< Changed lines
> Changed lines