Legacy Document

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.