Legacy Document

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 macro	Selector
_Pack15	$0206

RESULT CODE

pictInfoIDErr

-11001

Invalid 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.