QADrawContextNew

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.