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 / Collecting Picture Information


DisposePictInfo

When you are finished gathering information from a survey of pictures, pixel maps, or bitmaps, use the DisposePictInfo function to dispose of the private data structures allocated by the NewPictInfo function. The DisposePictInfo function is also available as the DisposPictInfo function.

FUNCTION DisposePictInfo (thePictInfoID: PictInfoID): OSErr;
thePictInfoID
The unique identifier returned by NewPictInfo.
DESCRIPTION
The DisposePictInfo function disposes of the private data structures allocated by the NewPictInfo function, which is described on page 7-52.

The DisposePictInfo function does not dispose of any of the handles returned to you in a PictInfo record by the RetrievePictInfo function, which is described on page 7-57. Instead, you can dispose of a Palette record by using the DisposePalette procedure. You can dispose of a ColorTable record by using the DisposeCTable procedure. You can dispose of other allocations with the DisposeHandle procedure.

SPECIAL CONSIDERATIONS
The DisposePictInfo function may move or purge memory.

ASSEMBLY-LANGUAGE INFORMATION
The trap macro and routine selector for the DisposePictInfo function are
Trap macroSelector
_Pack15$0206

RESULT CODE
pictInfoIDErr-11001Invalid picture information ID
SEE ALSO
The DisposePalette procedure is described in Advanced Color Imaging on the Mac OS. The DisposeCTable procedure is described in the chapter "Color QuickDraw" in this book. The DisposeHandle procedure is described in the chapter "Memory Manager" in Inside Macintosh: Memory.


Previous Book Contents Book Index Next

© Apple Computer, Inc.
7 JUL 1996