TQADrawVTexture

QuickDraw 3D RAVE / QuickDraw 3D RAVE Reference

QuickDraw 3D RAVE Routines / Public Draw Context Methods

TQADrawVTexture
A drawing engine may define a method to draw texture-mapped objects defined by vertices. This method is optional and must be supported only by drawing engines that support texture mapping and do not want calls to QADrawVTexture to be replaced by calls to the QADrawPoint, QADrawLine, or QADrawTriTexture methods.
typedef void (*TQADrawVTexture) (
                                 const TQADrawContext *drawContext, 
                                 unsigned long nVertices, 
                                 TQAVertexMode vertexMode, 
                                 const TQAVTexture vertices[], 
                                 const unsigned long flags[]);
drawContext
A draw context.
nVertices
The number of vertices contained in the vertices array.
vertexMode
A vertex mode. See "Vertex Modes" (page 1-56) for a description of the available vertex modes.
vertices
An array of texture vertices.
flags
An array of triangle flags, or the value NULL. See "Triangle Flags Masks" (page 1-63) for a description of the available triangle flags. This parameter is valid only if the vertexMode parameter contains the value kQAVertexMode_Tri, kQAVertexMode_Strip, or kQAVertexMode_Fan.

DESCRIPTION
Your TQADrawVTexture function should draw the vertices in the array specified by the vertices parameter into the draw context specified by the drawContext parameter, according to the vertex modes flag specified by the vertexMode parameter. For instance, if the value of the vertexMode parameter is kQAVertexMode_Polyline, then the vertices in that array are interpreted as defining a polyline (a set of connected line segments). Texture mapping (using the texture determined by the value of the kQATag_Texture state variable) should be applied to whatever objects are drawn.

IMPORTANT
The vertex modes kQAVertexMode_Point and kQAVertexMode_Line are supported only by drawing engines that support the kQAOptional_OpenGL feature. All other drawing engines should ignore requests to texture map points or lines.