glutessvertex - Man Page






gluTessVertex(3G)	       OpenGL Reference		     gluTessVertex(3G)



NAME
     gluTessVertex - specify a vertex on a polygon


C SPECIFICATION
     void gluTessVertex( GLUtesselator*	tess,
			 GLdouble *location,
			 GLvoid* data )


PARAMETERS
     tess      Specifies the tessellation object (created with gluNewTess).

     location  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
     gluTessBeginContour and gluTessEndContour.

     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_TESS_VERTEX or
     GLU_TESS_VERTEX_DATA callback after tessellation (see the gluTessCallback
     reference page).



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);
	   gluTessBeginContour(tobj);
	     gluTessVertex(tobj, v5, v5);
	     gluTessVertex(tobj, v6, v6);
	     gluTessVertex(tobj, v7, v7);
	   gluTessEndContour(tobj);
	  gluTessEndPolygon(tobj);




									Page 1






gluTessVertex(3G)	       OpenGL Reference		     gluTessVertex(3G)



NOTES
     The pointers specified by	location and data are not dereferenced until
     gluTessEndPolygon is executed.  In	the above example v1 must point	to a
     different location	from v2, etc.


SEE ALSO
     gluTessBeginPolygon, gluNewTess, gluTessBeginContour, gluTessCallback,
     gluTessProperty, gluTessNormal, gluTessEndPolygon














































									Page 2