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

Chapter 17 - File Objects / File Objects Reference

File Objects Routines / Managing View Hints Objects

Q3ViewHints_GetMask

You can use the Q3ViewHints_GetMask function to get the mask associated with a view hints object.

TQ3Status Q3ViewHints_GetMask (
TQ3ViewHintsObject viewHints, 
TQ3Bitmap *mask);

viewHints

A view hints object.

mask

On exit, the mask of the specified view hints object.

DESCRIPTION

The Q3ViewHints_GetMask function returns, in the mask parameter, the current mask for the view hints object specified by the viewHints parameter. The mask is a bitmap whose bits determine whether or not corresponding pixels in the drawing destination are drawn or are masked out. Q3ViewHints_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.