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 6 - Offscreen Graphics Worlds / Offscreen Graphics Worlds Reference
Routines / Creating, Altering, and Disposing of Offscreen Graphics Worlds


DisposeGWorld

Use the DisposeGWorld procedure to dispose of all the memory allocated for an offscreen graphics world.

PROCEDURE DisposeGWorld (offscreenGWorld: GWorldPtr);
offscreenGWorld
A pointer to an offscreen graphics world.
DESCRIPTION
The DisposeGWorld procedure disposes of all the memory allocated for the offscreen graphics world pointed to in the offscreenGWorld parameter, including its pixel map, color table, pixel image, and GDevice record (if one was created). In the offscreenGWorld parameter, pass the pointer returned to your application by the NewGWorld function when you created the offscreen graphics world.

Call DisposeGWorld only when your application no longer needs the pixel image associated with this offscreen graphics world. If this offscreen graphics world was the current device, the current device is reset to the device stored in the global variable MainDevice.

ASSEMBLY-LANGUAGE INFORMATION
The trap macro and routine selector for the DisposeGWorld procedure are
Trap macroSelector
_QDExtensions$00040004


Previous Book Contents Book Index Next

© Apple Computer, Inc.
7 JUL 1996