--- ray/doc/man/man1/obj2mesh.1	2003/03/14 21:27:45	1.3
+++ ray/doc/man/man1/obj2mesh.1	2007/09/04 17:36:40	1.10
@@ -1,12 +1,14 @@
-.\" RCSid "$Id"
+.\" RCSid "$Id: obj2mesh.1,v 1.10 2007/09/04 17:36:40 greg Exp $"
 .TH OBJ2MESH 1 03/11/03 RADIANCE
 .SH NAME
 obj2mesh - create a compiled RADIANCE mesh file from Wavefront .OBJ input
 .SH SYNOPSIS
 .B obj2mesh
 [
-.B "\-a matinput"
+.B "\-a matfile"
 ][
+.B "\-l matlib"
+][
 .B "\-n objlim"
 ][
 .B "\-r maxres"
@@ -30,6 +32,10 @@ which is sent to
 Any RADIANCE material descriptions included via one or more
 .I \-a
 options will be compiled and stored in the mesh as well.
+If the
+.I \-l
+option is used to specify a material file, the RADIANCE library
+locations are searched.
 This mesh may be included in a RADIANCE scene description via the
 .I mesh
 primitive, thus:
@@ -55,14 +61,12 @@ The
 .I \-n
 option specifies the maximum surface set size for
 each voxel.
-Larger numbers result in quicker mesh generation needing
-less memory, but potentially slower rendering.
-Smaller values may produce faster renderings,
-since the default number (15) is on the high side to reduce
-the compiled mesh octree size.
+Larger numbers result in quicker mesh generation,
+but potentially slower rendering.
 Values below 6 are not recommended, since this is the median
 valence for a mesh vertex (the number of adjacent faces),
 and smaller values will result in pointless octree subdivision.
+The default setting is 9.
 .PP
 The
 .I \-r
@@ -96,7 +100,7 @@ direction components, which will be normalized by
 .I obj2mesh.
 Normals will be interpolated over the mesh
 during rendering to produce a smooth surface.
-If no vertex normals are present, the mess will appear tesselated.
+If no vertex normals are present, the mesh will appear tesselated.
 A zero length normal (i.e., 0 0 0) will generate a syntax error.
 .TP
 .BI vt " u v"
@@ -132,7 +136,7 @@ where the first vertex position (
 statement) is numbered 1, and likewise
 for the first texture coordinate and the first surface normal.
 Negative indices count backward from the current position in
-the input, where -1 is the last vertex encountered, -2
+the input, where \-1 is the last vertex encountered, \-2
 is the one before that, etc.
 An index of 0 may be used for the vertex texture or normal to
 indicate none, or these may be left off entirely.
@@ -176,12 +180,34 @@ those causing the problem.
 .IP "Hash table overflow in fullnode"
 This error is caused by too many surfaces, and there is
 little hope of compiling this mesh.
-.SH EXAMPLE
-To create a compiled triangle mesh from the scene file mesh.obj:
+.SH EXAMPLES
+To create a compiled triangle mesh from the scene file mesh.obj
+using materials from the file mesh.mat:
 .IP "" .2i
-oconv mesh.obj mesh.rtm
+obj2mesh \-a mesh.mat mesh.obj mesh.rtm
+.PP
+To use local coordinates to place a square tiled image on a mesh object:
+.sp
+.nf
+void colorpict tiled_pat
+7 red green blue mytile.pic . frac(Lu) frac(Lv)
+0
+0
+
+tiled_pat plastic tiled_mat
+0
+0
+5 .9 .9 .9 0 0
+
+tiled_mat mesh tiled_mesh
+1 mymesh.rtm
+0
+0
+.fi
+.SH ENVIRONMENT
+RAYPATH		the directories to search for material files.
 .SH AUTHOR
 Greg Ward
 .SH "SEE ALSO"
 gensurf(1), getinfo(1), make(1), obj2rad(1),
-oconv(1), rpict(1), rview(1), rtrace(1), xform(1)
+oconv(1), rpict(1), rvu(1), rtrace(1), xform(1)