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.2 by greg, Thu Apr 2 20:44:15 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 < A
98 > The
99   .I "\-c epsilon"
100 < parameter may be given to coalesce vertices that are within the given epsilon.
100 > option tells
101 > .I robjutil
102 > to coalesce vertices that are within the given epsilon.
103   This is useful to improve the connectivity of models that were produced
104   in a sloppy conversion process from independent polygons.
105   When producing a Radiance file via the
# Line 102 | 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 111 | Line 126 | match the standard arguments used by
126   except that the
127   .I \-a
128   option is not supported for creating arrays of objects.
129 < Also, any scaling applied does not affect the epsilon value given for
129 > Also, any scaling factors do not affect the epsilon value given for
130   coalescing vertices, as this operation is applied prior to the transform,
131   even if
132   .I \-c
# Line 133 | 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
> Changed lines