Legacy Document

Important: The information in this document is obsolete and should not be used for new development.

Inside Macintosh: Imaging With QuickDraw /

Chapter 4 - Color QuickDraw / Color QuickDraw Reference

Color QuickDraw Routines / Creating, Setting, and Disposing of Pixel Maps

SetPortPix
Although you should never need to do so, you can set the pixel map for the current color graphics port by using the SetPortPix procedure.
PROCEDURE SetPortPix (pm: PixMapHandle); 
pm
A handle to the PixMap record.

DESCRIPTION
The SetPortPix procedure replaces the portPixMap field of the current CGrafPort record with the handle you specify in the pm parameter.

SPECIAL CONSIDERATIONS
The SetPortPix procedure is analogous to the basic QuickDraw procedure SetPortBits, which sets the bitmap for the current basic graphics port. The SetPortPix procedure has no effect when used with a basic graphics port. Similarly, SetPortBits has no effect when used with a color graphics port.
Both SetPortPix and SetPortBits allow you to perform drawing and calculations on a buffer other than the screen. However, instead of using these procedures, you should use the offscreen graphics capabilities described in the chapter "Offscreen Graphics Worlds."