NAME

       PLCombine - polylist two polylists (OFF file format) into one

SYNOPSIS

       Geom *PLCombine(Geom *, Geom *);

DESCRIPTION

       PLCombine()  combines  two  polylists into a single polylist and returns the new polylist.
       If either of the old polylists was NULL, a copy of the other polylist  (or  NULL  if  both
       polylists  were  NULL)  is  returned.  PLCombine() will generate an error if either of the
       parameters was not of the polylist type.

       If the two polylists represent color in an inconsistant way,  PLCombine  will  attempt  to
       preserve  the color data.  If either polylist has per-polygon colors, the result will have
       per-polygon colors.  If the other object originally had per-vertex colors,  the  color  of
       the  first  point  of each polygon will be used as the color of the polygon.  If the other
       polylist originally had no colors, the rgba value 0.15, 0.15, 0.15, 1.0 will  be  used  as
       the color of each of that polyline's polygons.

       If  neither  of  the  polylists  had per-polygon colors but one had per-vertex colors, the
       value 0.15, 0.15, 0.15, 1.0 will be used as the color value for each of  the  vertices  of
       the colorless polylist.

       If neither polylist had color data, the result will not have color date.

       The  result  of  PLCombine()  will not include  normal data if the two polylists represent
       normals in an inconsistent way, for example, if one has per-vertex data and one  has  per-
       face data or one has per-vertex data and one has no data.

LINKING

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

SEE ALSO

       offcombine(1), geomview(1), geomutil(3)

AUTHOR

       Celeste Fowler
       The Geometry Center