MirOS Manual: gluTessBeginPolygon(3)


GLUTESSBEGINPOLYGON(3UNIX Programmer's ManGLUTESSBEGINPOLYGON(3G)

NAME

     gluTessBeginPolygon - delimit a polygon description

C SPECIFICATION

     void gluTessBeginPolygon( GLUtesselator* tess,
                               GLvoid* data )

PARAMETERS

     tess  Specifies the tessellation object (created with
           gluNewTess).

     data  Specifies a pointer to user polygon data.

DESCRIPTION

     gluTessBeginPolygon and gluTessEndPolygon delimit the defin-
     ition of a convex, concave or self-intersecting 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.

     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 informa-
     tion.

     Once gluTessEndPolygon is called, the polygon is tessel-
     lated, and the resulting triangles are described through
     callbacks. See gluTessCallback for descriptions of the call-
     back functions.

EXAMPLE

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

     gluTessBeginPolygon(tobj, NULL);
      gluTessBeginContour(tobj);
        gluTessVertex(tobj, v1, v1);
        gluTessVertex(tobj, v2, v2);
        gluTessVertex(tobj, v3, v3);
        gluTessVertex(tobj, v4, v4);
      gluTessEndContour(tobj);

MirOS BSD #10-current   Printed 20.2.2012                       1

GLUTESSBEGINPOLYGON(3UNIX Programmer's ManGLUTESSBEGINPOLYGON(3G)

      gluTessBeginContour(tobj);
        gluTessVertex(tobj, v5, v5);
        gluTessVertex(tobj, v6, v6);
        gluTessVertex(tobj, v7, v7);
      gluTessEndContour(tobj); gluTessEndPolygon(tobj);

SEE ALSO

     gluNewTess(3G), gluTessBeginContour(3G), gluTessVertex(3G),
     gluTessCallback(3G), gluTessProperty(3G), gluTessNormal(3G),
     gluTessEndPolygon(3G)

MirOS BSD #10-current   Printed 20.2.2012                       2

Generated on 2012-02-20 02:47:02 by $MirOS: src/scripts/roff2htm,v 1.70 2011/12/03 18:21:12 tg Exp $

These manual pages and other documentation are copyrighted by their respective writers; their source is available at our CVSweb, AnonCVS, and other mirrors. The rest is Copyright © 2002‒2011 The MirOS Project, Germany.
This product includes material provided by Thorsten Glaser.

This manual page’s HTML representation is supposed to be valid XHTML/1.1; if not, please send a bug report – diffs preferred.