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