plcombine(3) Geometry Center (June 15, 1992) plcombine(3)
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 email: fowler@geom.umn.edu
The Geometry Center phone: (612) 626-8304
1300 South Second Street
Minneapolis, MN 55454
Page 1 (printed 12/22/98)