glcGenContext(3G) OpenGL Character Renderer 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
Page 1
