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

GXUnloadColorSet

You can use the GXUnloadColorSet function to unload a color set from memory.

void GXUnloadColorSet(gxColorSet target);

target

A reference to the color set object to be unloaded from memory.

DESCRIPTION

The GXUnloadColorSet function moves a color set object from the active graphics client heap to disk storage. When you or QuickDraw GX use the GXUnloadColorSet function to unload a color set 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 GXLoadColorSet function to reload the object from disk storage to memory, QuickDraw GX uses the stub to find the stored color set object.

ERRORS, WARNINGS, AND NOTICES

Errors

out_of_memory

color_set_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 GXLoadColorSet function is described in the previous section.