gluBeginPolygon, gluEndPolygon

[New - Windows 95, OEM Service Release 2]

The gluBeginPolygon and gluEndPolygon functions delimit a polygon description.

void gluBeginPolygon(

GLUtesselator * tess
);

void gluEndPolygon(

GLUtesselator * tess
);

Parameters

tess

The tessellation object (created with gluNewTessCIEF84).

Remarks

Use gluBeginPolygon and gluEndPolygon to delimit the definition of a nonconvex polygon.

{bmc bm4.MRB} To define such a polygon

1. Call gluBeginPolygon.

2. Define the contours of the polygon by calling gluTessVertex57UT_GN for each vertex and gluNextContour1NXN5RM to start each new contour.

3. Call gluEndPolygon to signal the end of the definition.

Once gluEndPolygon is called, the polygon is tessellated, and the resulting triangles are described through callbacks. For descriptions of the callback functions, see gluTessCallback5E3CP.

Note The gluBeginPolygon and gluEndPolygon functions are obsolete and are provided for backward compatibility only. The gluBeginPolygon function is mapped to gluTessBeginPolygon followed by gluTessBeginContour; gluEndPolygon is mapped to gluTessEndPolygon followed by gluTessEndContour.

Example

The following example describes a quadrilateral with a triangular hole:

gluBeginPolygon(tess);

gluTessVertex(tess, v1, v1);

gluTessVertex(tess, v2, v2);

gluTessVertex(tess, v3, v3);

gluTessVertex(tess, v4, v4);

gluNextContour(tess, GLU_INTERIOR);

gluTessVertex(tess, v5, v5);

gluTessVertex(tess, v6, v6);

gluTessVertex(tess, v7, v7);

gluEndPolygon(tess);