--- ray/doc/man/man1/robjutil.1 2020/04/03 02:32:58 1.4 +++ ray/doc/man/man1/robjutil.1 2021/04/15 23:51:04 1.7 @@ -1,4 +1,4 @@ -.\" RCSid "$Id: robjutil.1,v 1.4 2020/04/03 02:32:58 greg Exp $" +.\" RCSid "$Id: robjutil.1,v 1.7 2021/04/15 23:51:04 greg Exp $" .TH ROBJUTIL 1 3/31/20 RADIANCE .SH NAME robjutil - operate on Wavefront .OBJ file @@ -19,6 +19,8 @@ robjutil - operate on Wavefront .OBJ file ][ .B "-c epsilon" ][ +.B +T +][ .B "-x 'xf spec'" ] [ @@ -35,13 +37,10 @@ will be produced on the standard output. If .I -r is given, a modified .OBJ file will be sent to the standard output. -This is the default, and is -typically more useful, since surface normals are better handled by the -.I obj2rad(1) -and -.I obj2mesh(1) -converters. -The latter also preserves local texture coordinates for mapping materials. +This is the default, and is more useful for preserving +texture coordinates if directed to +.I obj2mesh(1). +.PP The .I +v option turns on verbose progress reports. @@ -75,6 +74,7 @@ The and .I \+m options are mutually exclusive. +.PP Similarly, the .I "\-g gname" option says to remove all faces belonging to the group @@ -85,6 +85,11 @@ options may be given. There is also a .I +g option to save just the named group(s). +Object statements are treated the same as group statements in the input, so +.I +/-g +option can also be applied to object names. +Note that an object name will be overridden by a group name that follows +it in the input, and vice versa. .PP The .I "\-c epsilon" @@ -104,6 +109,10 @@ which is usually not a problem for .OBJ output, but ma scene descriptions (+r). .PP The +.I +T +option turns all faces with 4 or more sides into triangles. +.PP +The .I \-x option may be used to specify a final transform to apply to all coordinates in the file before output. @@ -123,10 +132,6 @@ To remove degenerate and duplicate faces from "orig.ob .IP "" .2i robjutil +r orig.obj > final.rad .PP -To convert the same file, preserving surface normal interpolation: -.IP "" .2i -robjutil orig.obj | obj2rad > withnormals.rad -.PP To extract only the groups "cat" and "bell" from the file "kitty.obj" and write to a Radiance triangle mesh using materials from "kitty.mat": .IP "" .2i @@ -168,4 +173,4 @@ still possible to assign materials by group manually. .SH AUTHOR Greg Ward .SH "SEE ALSO" -cat(1), obj2mesh(1), obj2rad(1) oconv(1), xform(1) +cat(1), genbox(1), gensurf(1), obj2mesh(1), obj2rad(1) oconv(1), xform(1)