Important: The information in this document is obsolete and should not be used for new development.
GetPixPat
To get a pixel pattern ('ppat'
) resource stored in a resource file, you can use theGetPixPat
function.
FUNCTION GetPixPat (patID: Integer): PixPatHandle;
patID
- The resource ID for a resource of type
'ppat'
.DESCRIPTION
TheGetPixPat
function returns a handle to the pixel pattern having the resource ID you specify in thepatID
parameter. TheGetPixPat
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, theGetPixPat
function returnsNIL
.When you are finished with the pixel pattern, use the
DisposePixPat
procedure (described on page 4-82).SPECIAL CONSIDERATIONS
TheGetPixPat
function may move or purge memory blocks in the application heap. Your application should not call this function at interrupt time.SEE ALSO
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 theGetResource
function.