gluEndPolygon function

Article
03/09/2021

[The gluEndPolygon function is obsolete and is provided for backward compatibility only. The gluEndPolygon function is mapped to gluTessEndPolygon followed by gluTessEndContour.]

The gluBeginPolygon and gluEndPolygon functions delimit a polygon description.

Syntax

void gluEndPolygon(
   GLUtesselator *tess
);

Parameters

tess: The tessellation object (created with gluNewTess).

Return value

This function does not return a value.

Remarks

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

Call gluBeginPolygon.
Define the contours of the polygon by calling gluTessVertex for each vertex and gluNextContour to start each new contour.
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 gluTessCallback.

Examples

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);

Requirements

Requirement	Value
Minimum supported client	Windows 2000 Professional [desktop apps only]
Minimum supported server	Windows 2000 Server [desktop apps only]
Header	Glu.h
Library	Glu32.lib
DLL	Glu32.dll

Share via