--- ray/doc/man/man1/oconv.1 2003/12/09 15:59:06 1.4 +++ ray/doc/man/man1/oconv.1 2007/09/04 17:36:40 1.8 @@ -1,4 +1,4 @@ -.\" RCSid "$Id: oconv.1,v 1.4 2003/12/09 15:59:06 greg Exp $" +.\" RCSid "$Id: oconv.1,v 1.8 2007/09/04 17:36:40 greg Exp $" .TH OCONV 1 8/15/95 RADIANCE .SH NAME oconv - create an octree from a RADIANCE scene description @@ -109,7 +109,7 @@ Although the octree file format is binary, it is meant between machines. The only limitation is that machines with radically different integer sizes will not work together. -For the best results, the -f option should be used if an octree is +For the best results, the \-f option should be used if an octree is to be used in different environments. .SH DIAGNOSTICS There are four basic error types reported by oconv: @@ -132,15 +132,15 @@ to xform(1) within files to create a hierarchy. .IP "Set overflow in addobject (id)" This error occurs when too many surfaces are close together in a scene. -Sometimes a dense scene can be accommodated by increasing -the maximum resolution (by powers of two) using the -.I \-r -option, but usually this error indicates something is wrong. Either too many surfaces are lying right on top of each other, or the bounding cube is inflated from an oversized object or an improper .I \-b specification. +If hundreds of triangles come together at a common vertex, it may +not be possible to create an octree from the object. +This happens most often when inane CAD systems create spheres using +a polar tessellation. Chances are, the surface "id" is near one of those causing the problem. .IP "Hash table overflow in fullnode" This error is caused by too many surfaces. @@ -152,7 +152,7 @@ option. To add book1, book2 and a transformed book3 to the octree ``scene.oct'': .IP "" .2i -oconv -i scene.oct book1 book2 '\\!xform -rz 30 book3' > newscene.oct +oconv \-i scene.oct book1 book2 '\\!xform \-rz 30 book3' > newscene.oct .SH AUTHOR Greg Ward .SH NOTES @@ -169,4 +169,4 @@ or can be used to automate octree creation and maintenance. .SH "SEE ALSO" getbbox(1), getinfo(1), make(1), obj2mesh(1), rad(1), -rpict(1), rview(1), rtrace(1), xform(1) +rpict(1), rvu(1), rtrace(1), xform(1)