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 7 - Pictures / Pictures Reference
QuickDraw and Picture Utilities Routines / Drawing Pictures


GetPicture

Use the GetPicture function to get a handle to a picture stored in a 'PICT' resource.

FUNCTION GetPicture (picID: Integer): PicHandle;
picID
The resource ID for a 'PICT' resource.
DESCRIPTION
The GetPicture function returns a handle to the picture stored in the 'PICT' resource with the ID that you specify in the picID parameter. You can pass this handle to the DrawPicture procedure (described on page 7-43) to draw the picture stored in the resource.

The GetPicture function calls the Resource Manager procedure GetResource as follows:

GetResource('PICT',picID)
If the resource can't be read, GetPicture returns NIL.

SPECIAL CONSIDERATIONS
To release the memory occupied by a picture stored in a 'PICT' resource, use the Resource Manager procedure ReleaseResource.

The GetPicture function may move or purge memory.

SEE ALSO
The GetResource and ReleaseResource procedures are described in the chapter "Resource Manager" in Inside Macintosh: More Macintosh Toolbox. The 'PICT' resource is described on page 7-66.


Previous Book Contents Book Index Next

© Apple Computer, Inc.
7 JUL 1996