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

gluBeginPolygon or gluEndPolygon Subroutine

Purpose

Delimits the beginning or end of a polygon description.

Library

OpenGL C bindings library: libGL.a

C Syntax

void gluBeginPolygon(GLUtriangulatorObj *tobj)
void gluEndPolygon(GLUtriangulatorObj *tobj)

Description

The gluBeginPolygon and gluEndPolygon subroutines delimit the definition of a nonconvex polygon. To define a nonconvex polygon, first call the gluBeginPolygon subroutine. Then, call the gluTessVertex subroutine to define the contours of the polygon for each vertex and the gluNextContour subroutine to start each new contour. (See the gluTessVertex subroutine for details about defining a polygon vertex; and the gluNextContour subroutine for details about describing polygons with multiple contours.) Finally, call the gluEndPolygon subroutine to signal the end of the definition.

Once the gluEndPolygon subroutine is called, the polygon is tessellated and the resulting triangles are described through the callbacks. (See the gluTessCallback subroutine for a list of definitions for the callback routines.)

Parameters

tobj Specifies the tessellation object created with the gluNewTess subroutine.

Examples

A quadrilateral with a triangular hole can be described as follows:

gluBeginPolygon(tobj);
   gluTessVertex(tobj, v1, v1);
   gluTessVertex(tobj, v2, v2);
   gluTessVertex(tobj, v3, v3);
   gluTessVertex(tobj, v4, v4);
gluNextContour(tobj, GLU_INTERIOR);
   gluTessVertex(tobj, v5, v5);
   gluTessVertex(tobj, v6, v6);
   gluTessVertex(tobj, v7, v7);
gluEndPolygon(tobj);

Files

/usr/include/GL/gl.h Contains C language constraints, variable type definitions, and ANSI function prototypes for OpenGL.

Related Information

The gluNewTess subroutine, gluNextContour subroutine, gluTessCallback subroutine, gluTessVertex subroutine.

OpenGL Overview.


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