Inside Macintosh: 3D Graphics Programming With QuickDraw 3D /

Chapter 12 - Draw Context Objects / Draw Context Objects Reference

Draw Context Objects Routines / Managing Draw Contexts

Q3DrawContext_GetMask

You can use the Q3DrawContext_GetMask function to get the mask of a draw context.

TQ3Status Q3DrawContext_GetMask (
TQ3DrawContextObject context, 
TQ3Bitmap *mask);

context

A draw context object.

mask

On exit, the mask of the specified draw context.

DESCRIPTION

The Q3DrawContext_GetMask function returns, in the mask parameter, the current mask for the draw context specified by the context parameter. The mask is a bitmap whose bits determine whether or not corresponding pixels in the drawing destination are drawn or are masked out. Q3DrawContext_GetMask allocates memory internally for the returned bitmap; when you're done using the bitmap, you should call the Q3Bitmap_Empty function to dispose of that memory.