Legacy Documentclose button

Important: The information in this document is obsolete and should not be used for new development.

Previous Book Contents Book Index Next

Inside Macintosh: Imaging With QuickDraw /
Chapter 4 - Color QuickDraw / Color QuickDraw Reference
Color QuickDraw Routines / Creating and Disposing of Pixel Patterns


To get a pixel pattern ('ppat') resource stored in a resource file, you can use the GetPixPat function.

FUNCTION GetPixPat (patID: Integer): PixPatHandle; 
The resource ID for a resource of type 'ppat'.
The GetPixPat function returns a handle to the pixel pattern having the resource ID you specify in the patID parameter. The GetPixPat function calls the following Resource Manager function with these parameters:

GetResource('ppat', patID);
If a 'ppat' resource with the ID that you request does not exist, the GetPixPat function returns NIL.

When you are finished with the pixel pattern, use the DisposePixPat procedure (described on page 4-82).

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

The 'ppat' resource format is described on page 4-94. See the chapter "Resource Manager" in Inside Macintosh: More Macintosh Toolbox for more information about resources, the Resource Manager, and the GetResource function.

Previous Book Contents Book Index Next

© Apple Computer, Inc.
7 JUL 1996