gluTessVertex.3gl (GLU versions 1.0 and 1.1)







Name

  gluTessVertex	- specify a vertex on a	polygon





C Specification

  void gluTessVertex( GLUtriangulatorObj *tobj,

		      GLdouble v[3],

		      void *data )





Parameters



  tobj	Specifies the tessellation object (created with	gluNewTess).



  v	Specifies the location of the vertex.



  data	Specifies an opaque pointer passed back	to the user with the vertex

	callback (as specified by gluTessCallback).





Description

  gluTessVertex	describes a vertex on a	polygon	that the user is defining.

  Successive gluTessVertex calls describe a closed contour.  For example, if

  the user wants to describe a quadrilateral, then gluTessVertex should	be

  called four times.  gluTessVertex can	only be	called between

  gluBeginPolygon and gluEndPolygon.



  data normally	points to a structure containing the vertex location, as well

  as other per-vertex attributes such as color and normal.  This pointer is

  passed back to the user through the GLU_VERTEX callback after	tessellation

  (see the gluTessCallback reference page).







Example

  A quadrilateral with a triangular hole in it 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);





See Also

  gluBeginPolygon, gluNewTess, gluNextContour, gluTessCallback