Legacy Document

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 macro	Selector
_QDExtensions	$00040004