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


GXLoadShape

You can use the GXLoadShape function to load a shape into memory.

void GXLoadShape(gxShape target);
target
A reference to the shape object to be loaded into memory.
DESCRIPTION
The GXLoadShape function moves a shape object from disk storage to the active graphics client heap. When you or QuickDraw GX unload a shape object from memory to disk storage using the GXUnloadShape function, QuickDraw GX creates a 4-byte stub that remains in the active graphics client heap. When you use the GXLoadShape function to retrieve the stored object, QuickDraw GX obtains the location of the stored shape object from the stub.

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 sections "Loading and Unloading Objects" beginning on page 2-12.

The GXUnloadShape function is described in the next section.


Previous Book Contents Book Index Next

© Apple Computer, Inc.
7 JUL 1996