Important: The information in this document is obsolete and should not be used for new development.
DisposePictInfo
When you are finished gathering information from a survey of pictures, pixel maps, or bitmaps, use theDisposePictInfo
function to dispose of the private data structures allocated by theNewPictInfo
function. TheDisposePictInfo
function is also available as theDisposPictInfo
function.
FUNCTION DisposePictInfo (thePictInfoID: PictInfoID): OSErr;
- thePictInfoID
- The unique identifier returned by
NewPictInfo
.DESCRIPTION
TheDisposePictInfo
function disposes of the private data structures allocated by theNewPictInfo
function, which is described on page 7-52.The
DisposePictInfo
function does not dispose of any of the handles returned to you in aPictInfo
record by theRetrievePictInfo
function, which is described on page 7-57. Instead, you can dispose of aPalette
record by using theDisposePalette
procedure. You can dispose of aColorTable
record by using theDisposeCTable
procedure. You can dispose of other allocations with theDisposeHandle
procedure.SPECIAL CONSIDERATIONS
TheDisposePictInfo
function may move or purge memory.ASSEMBLY-LANGUAGE INFORMATION
The trap macro and routine selector for theDisposePictInfo
function are
Trap macro Selector _Pack15 $0206 RESULT CODE
pictInfoIDErr -11001 Invalid picture information ID SEE ALSO
TheDisposePalette
procedure is described in Advanced Color Imaging on the Mac OS. TheDisposeCTable
procedure is described in the chapter "Color QuickDraw" in this book. TheDisposeHandle
procedure is described in the chapter "Memory Manager" in Inside Macintosh: Memory.