PlotCIcon

Draw a color icon in a rectangle

#include <Quickdraw.h> Color QuickDraw

void PlotCIcon( theRect, theIcon );

Rect *theRect ; address of rectangle to draw in, in local coordinates

CIconHandle theIcon ; handle leading to a color icon image

PlotCIcon draws a color icon in a particular rectangle.

theRect is the address of a Rect structure.

itheIcon is a handle leading to the color icon image-data.

Notes: This copies the icon image into the area specified by theRect. The data is

copied in srcCopy transfer mode, overwriting the entire contents of the

rectangle.

CIcon's icon mask points out which pixels of the iconPMap get 1's (and are

drawn) and which get 0's (and are not drawn).

IconPMap is normally used as the source. In cases where the screen is one

or two bits-per-pixel deep, IconBMap is used as the source whenever it is

available.

When the image is drawn, the boundsRect of the IconPMap becomes the

source and the both the source and the mask are scaled to fit the destination.

PlotCIcon is a very specific kind of call to CopyMask. It circumvents all

of the graphics procedures and, as a result, none of its calls are saved in

pictures.

Referenced by (11):