Manual Reference Pages  - GLUTESSENDPOLYGON (3G)

NAME

gluTessEndPolygon - delimit a polygon description

CONTENTS

C Specification
Parameters
Description
Example
See Also

C SPECIFICATION

void gluTessEndPolygon( GLUtesselator* tess )

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  gluTessBeginPolygongluTessEndPolygon pair, there must be one or more calls to  gluTessBeginContourgluTessEndContour. 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.

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

EXAMPLE

A quadrilateral with a triangular hole in it can be described like this:


.Ex 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);
.Ee 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(3G),  gluTessBeginContour(3G),  gluTessVertex(3G),  gluTessCallback(3G),  gluTessProperty(3G),  gluTessNormal(3G),  gluTessBeginPolygon(3G)
Jump to page    or go to Top of page |  Section 3G |  Main Index.


GLUTESSENDPOLYGON (3G)
Generated by manServer 1.07 from /usr/X11R6/man/man3/gluTessEndPolygon.3x.gz using man macros with eqn support.