


AnyToPL(3)					       AnyToPL(3)


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:  Any-
       ToPL() is called	recursively  with  a  new  transformation
       matrix.	The resultant polylists	are combined using PLCom-
       bine(3).

       No effort is made to eliminate identical	 vertices.   How-
       ever,  no  extraneous repeated vertexes should be created.
       The resultant polylist should have the same number of ver-
       texes 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



Geometry Center		  June 15, 1992				1





AnyToPL(3)					       AnyToPL(3)


       library.

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

AUTHOR
       Celeste Fowler		       email: fowler@geom.umn.edu
       The Geometry Center	       phone: (612) 626-8304
       1300 South Second Street
       Minneapolis, MN	55454















































Geometry Center		  June 15, 1992				2


