Inside Macintosh: /

QuickDraw 3D RAVE / QuickDraw 3D RAVE Reference

QuickDraw 3D RAVE Routines / Manipulating Draw Contexts

QASubmitVerticesGouraud

You can use the QASubmitVerticesGouraud function to submit Gouraud vertices.

#define QASubmitVerticesGouraud(drawContext,nVertices,vertices) \
   (drawContext)->submitVerticesGouraud(drawContext,nVertices,vertices)

drawContext

A draw context.

nVertices

The number of Gouraud vertices pointed to by the vertices parameter.

vertices

A pointer to an array of Gouraud vertices.

DESCRIPTION

The QASubmitVerticesGouraud function submits the list of vertices pointed to by the vertices parameter to the draw context specified by the drawContext parameter. The vertices define a triangle mesh. Note, however, that QASubmitVerticesGouraud does not draw the specified mesh, but simply defines the mesh for a subsequent call to QADrawTriMeshGouraud.

Your application is responsible for managing the memory occupied by the Gouraud vertices. QASubmitVerticesGouraud does not copy the vertex data pointed to by the vertices parameter. Accordingly, you must not dispose of or reuse that memory until you've finished drawing the triangle mesh defined by QASubmitVerticesGouraud.

SPECIAL CONSIDERATIONS

If a drawing engine does not support triangle meshes, QuickDraw 3D RAVE decomposes a triangle mesh into individual triangles. As a result, you can always use the QASubmitVerticesGouraud function to submit a triangle mesh.