Inside Macintosh: /

QuickDraw 3D RAVE / QuickDraw 3D RAVE Reference

QuickDraw 3D RAVE Routines / Manipulating Draw Contexts

QASubmitVerticesTexture

You can use the QASubmitVerticesTexture function to submit texture vertices.

#define QASubmitVerticesTexture(drawContext,nVertices,vertices) \
   (drawContext)->submitVerticesTexture(drawContext,nVertices,vertices)

drawContext

A draw context.

nVertices

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

vertices

A pointer to an array of texture vertices.

DESCRIPTION

The QASubmitVerticesTexture 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 QASubmitVerticesTexture does not draw the specified mesh, but simply defines the mesh for a subsequent call to QADrawTriMeshTexture.

Your application is responsible for managing the memory occupied by the texture vertices. QASubmitVerticesTexture 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 QASubmitVerticesTexture.

SPECIAL CONSIDERATIONS

The QASubmitVerticesTexture function is optional and must be supported only by drawing engines that support texture mapping.

If a drawing engine does not support triangle meshes, QuickDraw 3D RAVE decomposes a triangle mesh into individual triangles.