--- ray/doc/man/man1/obj2mesh.1	2003/03/12 17:26:58	1.2
+++ ray/doc/man/man1/obj2mesh.1	2004/01/01 19:31:45	1.6
@@ -1,10 +1,12 @@
-.\" RCSid "$Id"
+.\" RCSid "$Id: obj2mesh.1,v 1.6 2004/01/01 19:31:45 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 "\-n objlim"
 ][
 .B "\-r maxres"
@@ -25,6 +27,9 @@ reads a Wavefront .OBJ file from
 which is sent to
 .I output.rtm
 (or standard output).
+Any RADIANCE material descriptions included via one or more
+.I \-a
+options will be compiled and stored in the mesh as well.
 This mesh may be included in a RADIANCE scene description via the
 .I mesh
 primitive, thus:
@@ -39,8 +44,12 @@ mod mesh id
 .PP
 The syntax and semantics are identical to the RADIANCE
 .I instance
-primitive, except that the mesh modifier may not be "void", since
-materials are not included in a compiled mesh file.
+primitive.
+If
+.I mod
+is "void", then the stored mesh materials will be applied during rendering.
+Otherwise, the given material will be substituted on
+all the mesh surfaces.
 .PP
 The
 .I \-n
@@ -96,6 +105,20 @@ These coordinates will be interpolated and passed
 to the "Lu" and "Lv" variables during rendering.
 Local coordinates can extend over any desired range of values.
 .TP
+.BI usemtl " mname"
+A material name.
+The following faces will use the named material, which is
+taken from the material definitions in the
+.I \-a
+input file(s).
+.TP
+.BI g " gname"
+Group association.
+The following faces are associated with the named group.
+If no "usemtl" statement has been
+encountered, the current group is used for the surface material
+identifier.
+.TP
 .BI f " v1/t1/n1 v2/t2/n2 v3/t3/n3" " .."
 A polygonal face.
 Polygon vertices are specified as three indices separated
@@ -154,11 +177,12 @@ those causing the problem.
 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:
+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
 .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)