GLUTESSENDPOLYGON()GLUTESSENDPOLYGON()NAMEgluTessEndPolygon - delimit a polygon description
C SPECIFICATION
void gluTessEndPolygon( GLUtesselator* tess )
delim $$
PARAMETERS
tess Specifies the tessellation object (created with gluNewTess).
DESCRIPTION
gluTessBeginPolygon and gluTessEndPolygon delimit the definition of a
convex, concave or self-intersecting polygon. Within each gluTessBegin‐
Polygon/gluTessEndPolygon pair, there must be one or more calls to
gluTessBeginContour/gluTessEndContour. Within each contour, there are
zero or more calls to gluTessVertex. The vertices specify a closed con‐
tour (the last vertex of each contour is automatically linked to the
first). See the gluTessVertex, gluTessBeginContour and gluTessEndCon‐
tour reference pages for more details.
Once gluTessEndPolygon is called, the polygon is tessellated, and the
resulting triangles are described through callbacks. See gluTessCall‐
back for descriptions of the callback functions.
EXAMPLE
A quadrilateral with a triangular hole in it can be described like
this:
gluTessBeginPolygon(tobj, NULL);
gluTessBeginContour(tobj);
gluTessVertex(tobj, v1, v1);
gluTessVertex(tobj, v2, v2);
gluTessVertex(tobj, v3, v3);
gluTessVertex(tobj, v4, v4);
gluTessEndContour(tobj);
gluTessBeginContour(tobj);
gluTessVertex(tobj, v5, v5);
gluTessVertex(tobj, v6, v6);
gluTessVertex(tobj, v7, v7);
gluTessEndContour(tobj); gluTessEndPolygon(tobj);
In the above example the pointers, $v1$ through $v7$, should point to
different addresses, since the values stored at these addresses will
not be read by the tesselator until gluTessEndPolygon is called.
SEE ALSO
gluNewTess, gluTessBeginContour, gluTessVertex, gluTessCallback,
gluTessProperty, gluTessNormal, gluTessBeginPolygon
GLUTESSENDPOLYGON()