plcombine.3gv man page

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


Geom *PLCombine(Geom *, Geom *);


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.


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)


Celeste Fowler
The Geometry Center


June 15, 1992 Geometry Center