--- ray/doc/man/man1/obj2mesh.1 2004/04/23 00:56:27 1.8 +++ ray/doc/man/man1/obj2mesh.1 2020/03/30 18:28:35 1.14 @@ -1,4 +1,4 @@ -.\" RCSid "$Id: obj2mesh.1,v 1.8 2004/04/23 00:56:27 greg Exp $" +.\" RCSid "$Id: obj2mesh.1,v 1.14 2020/03/30 18:28:35 greg Exp $" .TH OBJ2MESH 1 03/11/03 RADIANCE .SH NAME obj2mesh - create a compiled RADIANCE mesh file from Wavefront .OBJ input @@ -14,6 +14,8 @@ obj2mesh - create a compiled RADIANCE mesh file from W .B "\-r maxres" ][ .B \-w +][ +.B \-v ] [ .B "input.obj" @@ -61,14 +63,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 @@ -80,6 +80,9 @@ The default is 16384. The .I \-w option suppresses warnings. +The +.I \-v +option prints out final mesh statistics. .PP Although the mesh file format is binary, it is meant to be portable between machines. @@ -138,14 +141,11 @@ 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. All faces will be broken into triangles in the final mesh. -.I Obj2mesh -currently makes an unsafe assumption that faces are convex, -which may result in odd results if they are not. .PP All other statement types will be ignored on the input. Statements understood by @@ -186,13 +186,13 @@ little hope of compiling this mesh. To create a compiled triangle mesh from the scene file mesh.obj using materials from the file mesh.mat: .IP "" .2i -obj2mesh -a mesh.mat 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) +7 red green blue mytile.hdr . frac(Lu) frac(Lv) 0 0 @@ -211,5 +211,5 @@ RAYPATH the directories to search for material files. .SH AUTHOR Greg Ward .SH "SEE ALSO" -gensurf(1), getinfo(1), make(1), obj2rad(1), +gensurf(1), getinfo(1), make(1), obj2rad(1), objutil(1) oconv(1), rpict(1), rvu(1), rtrace(1), xform(1)