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.4 by greg, Fri Apr 3 02:32:58 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 84 | Line 86 | There is also a
86   .I +g
87   option to save just the named group(s).
88   .PP
89 < Finally, a
89 > The
90   .I "\-c epsilon"
91 < parameter may be given to coalesce vertices that are within the given epsilon.
91 > option tells
92 > .I robjutil
93 > to coalesce vertices that are within the given epsilon.
94   This is useful to improve the connectivity of models that were produced
95   in a sloppy conversion process from independent polygons.
96   When producing a Radiance file via the
# Line 98 | Line 102 | at least for triangle mesh input.
102   does not attempt to break up non-planar polygons into triangles,
103   which is usually not a problem for .OBJ output, but may be for Radiance
104   scene descriptions (+r).
105 + .PP
106 + The
107 + .I \-x
108 + option may be used to specify a final transform to apply to all
109 + coordinates in the file before output.
110 + This specification must be contained in a single quoted word and
111 + match the standard arguments used by
112 + .I xform(1),
113 + except that the
114 + .I \-a
115 + option is not supported for creating arrays of objects.
116 + Also, any scaling factors do not affect the epsilon value given for
117 + coalescing vertices, as this operation is applied prior to the transform,
118 + even if
119 + .I \-c
120 + appears later in the command line.
121   .SH EXAMPLES
122   To remove degenerate and duplicate faces from "orig.obj" and write to "final.rad":
123   .IP "" .2i
# Line 111 | Line 131 | To extract only the groups "cat" and "bell" from the f
131   write to a Radiance triangle mesh using materials from "kitty.mat":
132   .IP "" .2i
133   robjutil +g cat +g bell kitty.obj | obj2mesh -a kitty.mat > kitty.rtm
134 + .PP
135 + To rotate the scene 90 degrees about the Y-axis and scale by 10:
136 + .IP "" .2i
137 + robjutil -x "-ry 90 -s 10" orig.obj > transformed.obj
138 + .SH NOTES
139 + The .OBJ output of
140 + .I robjutil
141 + uses relative indices, so files it produces may be concatenated
142 + on the input of other tools such as
143 + .I obj2rad
144 + and
145 + .I obj2mesh
146 + by piping from
147 + .I cat(1)
148 + or similar.
149 + This offers a convenient way to separate geometry from a single .OBJ
150 + input, manipulate it in some way, then recombine during conversion.
151 + .PP
152 + Unlike
153 + .I obj2rad
154 + and
155 + .I obj2mesh,
156 + .I robjutil
157 + with the
158 + .I +r
159 + option will not substitute the group name for a material id if no
160 + .I usemtl
161 + statements are found on the input.
162 + Instead, it will assign each surface the material
163 + .I DEFAULT_MATERIAL.
164 + Since it is possible to use the
165 + .I +/-g
166 + option to select groups to include or exclude on output, it is
167 + still possible to assign materials by group manually.
168   .SH AUTHOR
169   Greg Ward
170   .SH "SEE ALSO"
171 < obj2mesh(1), obj2rad(1) oconv(1), xform(1)
171 > cat(1), obj2mesh(1), obj2rad(1) oconv(1), xform(1)

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines