Legacy Document

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.