[ Previous | Next | Contents | Glossary | Home | Search ]
OpenGL 1.1 for AIX: Reference Manual

gluTessBeginPolygon Subroutine

Purpose

Delimits a polygon description.

Library

C bindings library: libGL.a

C Syntax

void gluTessBeginPolygon(
    GLUtesselator* tess,
    GLvoid*	   data)

Parameters

tess
Specifies the tessellation object (created with gluNewTess).
data
Specifies a pointer to user polygon data.

Description

The gluTessBeginPolygon and gluTessEndPolygon routines delimit the definition of a nonconvex polygon. Within each gluTessBeginPolygon/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 contour (the last vertex of each contour is automatically linked to the first). See the gluTessVertex, gluTessBeginContour, and gluTessEndContour reference pages for more details.

The parameter data is a pointer to a user-defined data structure. If the appropriate callback(s) are specified (see gluTessCallback), then this pointer is returned to the callback function(s). Thus, it is a convenient way to store per-polygon information.

Once gluTessEndPolygon is called, the polygon is tessellated, and the resulting triangles are described through callbacks. See gluTessCallback for descriptions of the callback functions.

Related Information

gluNewTess,
gluTessBeginContour,
gluTessVertex,
gluTessCallback,
gluTessProperty,
gluTessNormal,
gluTessEndPolygon


[ Previous | Next | Contents | Glossary | Home | Search ]