TQASubmitVerticesGouraud

QuickDraw 3D RAVE / QuickDraw 3D RAVE Reference

QuickDraw 3D RAVE Routines / Public Draw Context Methods

TQASubmitVerticesGouraud
A drawing engine may define a method to submit Gouraud vertices.
typedef void (*TQASubmitVerticesGouraud) (
                                          const TQADrawContext *drawContext,
                                          unsigned long nVertices,
                                          const TQAVGouraud *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
Your TQASubmitVerticesGouraud function should prepare to render a Gouraud-shaded triangular mesh in the draw context specified by the drawContext parameter using the vertices pointed to by the vertices parameter. The actual triangulation and drawing of the mesh does not occur until an application calls the QADrawTriMeshGouraud function.
The calling application is responsible for managing the memory occupied by the Gouraud vertices. Your TQASubmitVerticesGouraud function should not copy the vertex data pointed to by the vertices parameter.

SPECIAL CONSIDERATIONS
The TQASubmitVerticesGouraud method is optional. If your drawing engine does not support triangle meshes, QuickDraw 3D RAVE decomposes a triangle mesh into individual triangles when the user calls the QASubmitVerticesGouraud function to submit a triangle mesh.
There is no QuickDraw 3D RAVE function that an application can use to unsubmit a triangle mesh. Your drawing engine must manage memory in some appropriate manner.