Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages


home | help
plcombine(3gv)							plcombine(3gv)

       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-ver-
       tex 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

       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	infor-
       mation on how to	link your program with this library.

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

       Celeste Fowler
       The Geometry Center

Geometry Center			 June 15, 1992			plcombine(3gv)


Want to link to this manual page? Use this URL:

home | help