glcGenContext(3G)

NAME
     glcGenContext, glcDeleteContext - generate or delete a context


C SPECIFICATION
     GLint glcGenContext( void )


C SPECIFICATION
     void glcDeleteContext( GLint inContext )


PARAMETERS
     inContext  Specifies the ID of the context to be deleted.

DESCRIPTION
     glcGenContext generates a new context and returns its ID.

     glcDeleteContext marks the context specified by inContext for deletion.
     If the marked context is not current to any client thread, the command
     deletes the marked context immediately. Otherwise, the marked context is
     deleted when the context is no longer current to any client's thread.

     A GLC context is an instantiation of GLC. When a client thread issues a
     GLC command, the thread's current GLC context executes the command.

     Each GLC context has a nonzero ID of type GLint. When the ID of a GLC
     context is stored in the GLC context ID variable of a client thread, the
     context is said to be current to the thread. It is not possible for a GLC
     context to be current simultaneously to multiple threads.  With the
     exception of the per-thread GLC error code and context ID variables, all
     of the GLC state variables that are used during the execution of a GLC
     command are stored in the issuing thread's current GLC context. To make a
     context current, call glcContext.

     Note that the results of issuing a GL command when there is no current GL
     context are undefined. Because GLC issues GL commands, you must create a
     GL context and make it current before calling GLC.

ERRORS
     GLC_PARAMETER_ERROR is generated if inContext is not the ID of one of the
     client's GLC contexts.

ASSOCIATED GETS
     glcGetAllContexts, glcIsContext

SEE ALSO
     glcContext, glcGetCurrentContext