gluTessBeginPolygon, gluTessEndPolygon Function
The gluTessBeginPolygon and gluTessEndPolygon functions delimit a polygon description.
Syntax
void gluTessBeginPolygon, gluTessEndPolygon(
GLUtesselator *tess,
void *polygon_data
);
Parameters
tess
The tessellation object (created with gluNewTess).polygon_data
A pointer to a programmer-defined polygon data structure.
Return Value
This function does not return a value.
Remarks
The gluTessBeginPolygon and gluTessEndPolygon functions delimit the definition of a nonconvex polygon. Within each gluTessBeginPolygon / gluTessEndPolygon pair, include one or more calls to gluTessBeginContour. Within each contour, there are zero or more calls to gluTessVertex. The vertexes specify a closed contour (the last vertex of each contour is automatically linked to the first).
The polygon_data parameter is a pointer to a programmer-defined data structure. If the appropriate callbacks are specified (see gluTessCallback), this pointer is returned to the callback function or functions, making it a convenient way to store per-polygon information.
When you call gluTessEndPolygon, the polygon is tessellated, and the resulting triangles are described through callbacks. For descriptions of the callback functions, see gluTessCallback.
Examples
The following describes a quadrilateral with a triangular hole:
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);
Requirements
| Minimum supported client | Windows 2000 Professional |
| Minimum supported server | Windows 2000 Server |
| Header | Glu.h |
| Library | Glu32.lib |
See Also
Send comments about this topic to Microsoft
Build date: 6/9/2009