NAME

       AnyToPL - convert an arbitrary geom to a polylist (OFF file format)

SYNOPSIS

       #include "geomutil.h"

       Geom *AnyToPL(Geom *, Transform);

DESCRIPTION

       AnyToPL()  takes  any  geom  as  an  arguement.  It then returns a polylist object which is geometrically
       identical to the original geom.  The transform argument is the transform applied to the entire object; it
       should  generally be set to TM_IDENTITY when AnyToPL() is first called.  Geometric objects are handled in
       the following ways:

       Polylists:  A transformed copy of the original is returned.

       Bezier:  The object is rediced if necessary, then handled as a mesh object.

       Quad:  The object is directly transformed into a new polylist.

       Mesh:  The object is directly transformed into a new polylist,  with  extra  polygons  added  to  do  the
       wrapping if necessary.

       Vect:   The  object  is  converted  into  a polylist containing a 2-gon for every segment in the original
       vector object.  The colors of the faces are the same as the colors  of  the  original  object,  but  this
       generally  is  irrelevant since the faces are not visible.  Note that edge visibility must be enabled for
       an object which has been converted from a vect to a polylist to be visible in geomview.

       List:  AnyToPL() is called recursively and the  resultant  polylists  are  combined  using  PLCombine(3).
       Inst:   AnyToPL()  is  called  recursively with a new transformation matrix.  The resultant polylists are
       combined using PLCombine(3).

       No effort is made to eliminate identical vertices.  However, no extraneous repeated  vertexes  should  be
       created.  The resultant polylist should have the same number of vertexes as the original object.

LINKING

       AnyToPL()  is  part  of the geomutil library; see geomutil(3) for information on how to link your program
       with this library.

SEE ALSO

       plcombine(3), anytooff(1), geomview(1), geomutil(3)

AUTHOR

       Celeste Fowler
       The Geometry Center