Inside Macintosh: /

QuickDraw 3D RAVE / QuickDraw 3D RAVE Reference

QuickDraw 3D RAVE Routines / Manipulating Draw Contexts

QADrawVGouraud

You can use the QADrawVGouraud function to draw Gouraud-shaded objects defined by vertices.

#define QADrawVGouraud(drawContext,nVertices,vertexMode,vertices,flags) \
 (drawContext)->drawVGouraud(drawContext,nVertices,vertexMode,vertices,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 Gouraud 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

The QADrawVGouraud function draws 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). Gouraud shading is applied to whatever objects are drawn.

SPECIAL CONSIDERATIONS

The QADrawVGouraud function is optional and must be supported only by drawing engines that do not want calls to QADrawVGouraud to be replaced by calls to the QADrawPoint, QADrawLine, or QADrawTriGouraud functions.