StdBits

The default Quickdraw bit-transfer routine

#include <Quickdraw.h> Quickdraw

void StdBits(srcMap, srcRect, destRect, tMode , maskRgn );

BitMap *srcMap ; source; destination is thePort->portBits

Rect *srcRect ; size, location of data from source BitMap

Rect *destRect ; size, location to store data in destination

short tMode ; transfer mode; srcCopy, srcOr, etc,

RgnHandle maskRgn ; mask for special clipping; NIL = not needed

This is the Quickdraw's low-level routine used for transferring bit- images

between bitMaps. All of its parameters are the same as those described in

srcMap is the address of a 14-byte BitMap structure. The destination

bitMap is assumed to be the portBits of the current GrafPort.

srcRect is the address of a Rect, in coordinates expressed in terms of the

GrafPort containing srcMap . It specifies the size and location of the

data to be copied.

destRect is the address of a Rect, in coordinates expressed in terms of the

current grafPort. It specifies the size and location to store the

duplicated data. If destRect is larger or smaller than srcRect , the

source image is scaled to fit the destination.

tMode is any of the source transfer modes, such as srcCopy (overwrite the

destination), srcOr, (overwrite where black), notSrcCopy (invert

and overwrite), and so forth. See Transfer Modes.

maskRgn specifies an optional clipping shape for the duplicate. A value of

NIL (0) indicates no special region-shape clipping.

Notes: Use StdBits only if your application intercepts the Quickdraw bottleneck

routines (see SetStdProcs).

StdBits works as described under CopyBits. It is highly optimized and

there would be little advantage in replacing it.

If you're recording a picture (see OpenPicture), StdBits incorporates

the output into the picture's definition.

Referenced by (9):