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: QuickDraw GX Environment and Utilities /
Chapter 2 - QuickDraw GX Memory Management / QuickDraw GX Memory Management Reference
Functions / Loading and Unloading Objects


GXUnloadShape

You can use the GXUnloadShape function to unload a shape from memory.

void GXUnloadShape(gxShape target);
target
A reference to the shape object to be unloaded from memory.
DESCRIPTION
The GXUnloadShape function moves a shape object from the active graphics client heap to disk storage. When you or QuickDraw GX use the GXUnloadShape function to unload a shape object from memory to disk storage, QuickDraw GX stores its location in a 4-byte stub in the active graphics client heap. When you use the GXLoadShape function to reload the object from disk storage to memory, QuickDraw GX uses the stub to find the stored shape object.

ERRORS, WARNINGS, AND NOTICES
Errors
out_of_memory
shape_is_nil
SEE ALSO
For additional information about loading objects from disk storage to memory and unloading objects from memory to disk storage, see the section "Loading and Unloading Objects" beginning on page 2-12.

The GXLoadShape function is described in the previous section.


Previous Book Contents Book Index Next

© Apple Computer, Inc.
7 JUL 1996