Legacy Document

Inside Macintosh: QuickDraw GX Environment and Utilities /

Chapter 2 - QuickDraw GX Memory Management / QuickDraw GX Memory Management Reference

Functions / Allocating and Disposing of a Graphics Client Heap

GXExitGraphics

You can use the GXExitGraphics function to dispose of the default structures and the active QuickDraw GX graphics client heap.

void GXExitGraphics(void);

DESCRIPTION

The GXExitGraphics function disposes of all of the default data structures that you have created in your QuickDraw GX application and disposes of the active graphics client heap. If a notice handler routine has been installed, it is called to report any objects allocated by the application that have not been disposed of.

Normally, you never need to call the GXExitGraphics function if you use the GXDisposeGraphicsClient function.

SPECIAL CONSIDERATIONS

In the debugging version of QuickDraw GX, you can call the GXExitGraphics function if you want to confirm that all QuickDraw GX objects that you allocated have been disposed of.

When your application is ready to ship, you should remove the terminating GXExitGraphics function and rely on QuickDraw GX to automatically dispose of your graphics client heaps.

ERRORS, WARNINGS, AND NOTICES

Notices (debugging only)

shape_not_disposed

font_not_disposed

style_not_disposed

ink_not_disposed

transform_not_disposed

colorSet_not_disposed

colorProfile_not_disposed

SEE ALSO

The role of the GXExitGraphicsClient function in disposing of a graphics client heap is described in the section "Disposing of a Graphics Client and Graphics Client Heap" beginning on page 2-9.

The GXDisposeGraphicsClient function is described on page 2-21.

The GXEnterGraphics function allocates memory for the QuickDraw GX graphics client heap and initializes the default data structures. This function is described on page 2-22.