Legacy Document

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."