Legacy Document

Inside Macintosh: Imaging With QuickDraw /

Chapter 3 - QuickDraw Drawing / QuickDraw Drawing Reference

Routines / Drawing Regions

FillRgn

To fill a region with any available bit pattern, use the FillRgn procedure.

PROCEDURE FillRgn (rgn:\xDDRgnHandle; pat:\xDDPattern);

rgn

A handle to the region to fill.

pat

The bit pattern to use for the fill. Figure 3-3 on page 3-6 illustrates the default fill patterns and the constants you can use to represent them.

DESCRIPTION

Using the patCopy pattern mode, the FillRgn procedure draws the interior of the region (whose handle you pass in the rgn parameter) with the pattern defined in the Pattern record that you specify in the pat parameter.

This procedure leaves the location of the graphics pen unchanged.

SPECIAL CONSIDERATIONS

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

SEE ALSO

Listing 3-8 on page 3-24 and Listing 3-9 on page 3-25 illustrate how to use this procedure.

You can use the GetPattern and GetIndPattern routines, described on page 3-122 and page 3-123, respectively, to get a pattern stored in a resource. The patCopy pattern mode is described in "Boolean Transfer Modes With 1-Bit Pixels" beginning on page 3-7. The Pattern record is described on page 3-36.

You can use the PaintRgn procedure, described in the previous section, to draw the interior of a region with the pen pattern for the current graphics port. To fill a region with a pixel pattern, use the FillCRegion procedure, which is described in the chapter "Color QuickDraw."