Legacy Document

Inside Macintosh: Imaging With QuickDraw /

Chapter 3 - QuickDraw Drawing / QuickDraw Drawing Reference

Routines / Customizing QuickDraw Operations

StdBits

The StdBits procedure is QuickDraw's standard low-level routine for doing bit and pixel transfer.

PROCEDURE StdBits (VAR srcBits:\xDDBitMap; VAR srcRect,dstRect:\xDDRect; 
                   mode:\xDDInteger; maskRgn:\xDDRgnHandle);

srcBits

A bitmap or pixel map containing the image to copy.

srcRect

The source rectangle.

dstRect

The destination rectangle.

mode

The source mode for the copy.

maskRgn

A handle to a region acting as a mask for the transfer.

DESCRIPTION

The StdBits procedure transfers a bit or pixel image between the bitmap or pixel map specified in the srcBits parameter and bitmap of the current graphics port, just as if the CopyBits procedure were called with the same parameters and with a destination bitmap equal to thePort^.portBits.

SPECIAL CONSIDERATIONS

The StdBits procedure may move or purge memory blocks in the application heap. Your application should not call this procedure at interrupt time.

SEE ALSO

See the description of the CopyBits procedure beginning on page 3-108 for a discussion of the destination bitmap and of the srcBits, srcRect, dstRect, mode, and maskRgn parameters.