Inside Macintosh: /

QuickDraw 3D RAVE / QuickDraw 3D RAVE Reference

QuickDraw 3D RAVE Routines / Creating and Deleting Draw Contexts

QADrawContextNew

You can use the QADrawContextNew function to create a new draw context.

TQAError QADrawContextNew (
                           const TQADevice *device, 
                           const TQARect *rect, 
                           const TQAClip *clip, 
                           const TQAEngine *engine, 
                           unsigned long flags, 
                           TQADrawContext **newDrawContext);

device

A device.

rect

The rectangular region (specified in device coordinates) of the specified device that can be drawn into by the drawing engine associated with the new draw context.

clip

The two-dimensional clipping region for the new draw context, or NULL if no clipping is desired. This parameter must be set to NULL for devices of type kQADeviceMemory.

engine

A drawing engine.

flags

A set of bit flags specifying features of the new draw context. See "Draw Context Flags Masks" (page 1-65) for complete information.

newDrawContext

On entry, the address of a pointer variable. On exit, that variable points to a new draw context. If a new draw context cannot be created, *newDrawContext is set to the value NULL.

DESCRIPTION

The QADrawContextNew function returns, through the newDrawContext parameter, a new draw context associated with the device specified by the device parameter and the drawing engine specified by the engine parameter.