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