1plcombine(3gv) plcombine(3gv)
2
6 PLCombine - polylist two polylists (OFF file format) into one
7
9 Geom *PLCombine(Geom *, Geom *);
10
12 PLCombine() combines two polylists into a single polylist and returns
13 the new polylist. If either of the old polylists was NULL, a copy of
14 the other polylist (or NULL if both polylists were NULL) is returned.
15 PLCombine() will generate an error if either of the parameters was not
16 of the polylist type.
17 If the two polylists represent color in an inconsistant way, PLCombine
19 will attempt to preserve the color data. If either polylist has per-
20 polygon colors, the result will have per-polygon colors. If the other
21 object originally had per-vertex colors, the color of the first point
22 of each polygon will be used as the color of the polygon. If the other
23 polylist originally had no colors, the rgba value 0.15, 0.15, 0.15, 1.0
24 will be used as the color of each of that polyline's polygons.
25 If neither of the polylists had per-polygon colors but one had per-ver‐
27 tex colors, the value 0.15, 0.15, 0.15, 1.0 will be used as the color
28 value for each of the vertices of the colorless polylist.
29 If neither polylist had color data, the result will not have color
31 date.
32 The result of PLCombine() will not include normal data if the two
34 polylists represent normals in an inconsistent way, for example, if one
35 has per-vertex data and one has per-face data or one has per-vertex
36 data and one has no data.
37
39 PLCombine() is part of the geomutil library; see geomutil(3) for infor‐
40 mation on how to link your program with this library.
41
43 offcombine(1), geomview(1), geomutil(3)
44
46 Celeste Fowler
47 The Geometry Center
48Geometry Center June 15, 1992 plcombine(3gv)