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.5 by greg, Fri Apr 3 02:45:13 2020 UTC

# Line 42 | 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 75 | 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 85 | 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 < 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 111 | Line 120 | match the standard arguments used by
120   except that the
121   .I \-a
122   option is not supported for creating arrays of objects.
123 < Also, any scaling applied does not affect the epsilon value given for
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
# Line 133 | Line 142 | robjutil +g cat +g bell kitty.obj | obj2mesh -a kitty.
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