Important: The information in this document is obsolete and should not be used for new development.
GXEnterGraphicsYou can use the
GXEnterGraphicsfunction to allocate memory for a QuickDraw GX graphics client heap.
GXEnterGraphicsfunction allocates memory for a graphics client heap and initializes the default data structures. QuickDraw GX obtains the memory starting location, memory length, and attributes for the new graphics client heap from the active graphics client.
Normally, you never need to call
GXEnterGraphics. You should call this function only in the specific instance that you want to isolate the QuickDraw GX call to a specific part of the application. You then usethe
GXExitGraphicsfunction to remove all memory used by QuickDraw GX and then use the
GXEnterGraphicsfunction to begin using QuickDraw GX memory again.
ERRORS, WARNINGS, AND NOTICES
SEE ALSOThe use of the
GXEnterGraphicsfunction to allocate memory to a graphics client is described in the section "Creating a Graphics Client and Its Graphics Client Heap" beginning on page 2-5.
GXExitGraphicsfunction deallocates memory for the QuickDraw GX graphics client heap and removes the default data structures. This function is described in the next section.
QuickDraw GX functions that do not require a graphics client or a graphics client heap are described in the section "Functions That Do Not Require a Graphics Client or Heap" beginning on page 2-14.