NAME
    cgCreateState - create a state definition

SYNOPSIS
      #include <Cg/cg.h>

      CGstate cgCreateState( CGcontext context,
                             const char * name,
                             CGtype type );

PARAMETERS
    context The context in which to define the new state.

    name    The name of the new state.

    type    The type of the new state.

RETURN VALUES
    Returns a handle to the newly created CGstate.

    Returns NULL if there is an error.

DESCRIPTION
    cgCreateState adds a new state definition to the context. When a CgFX
    file is added to the context, all state assignments in the file must
    have already been defined via a call to cgCreateState or
    cgCreateArrayState.

    Applications will typically call cgSetStateCallbacks shortly after
    creating a new state with cgCreateState.

EXAMPLES
    *to-be-written*

ERRORS
    CG_INVALID_CONTEXT_HANDLE_ERROR is generated if context is not a valid
    context.

    CG_INVALID_PARAMETER_ERROR is generated if name is NULL or not a valid
    identifier, or if type is not a simple scalar, vector, or matrix-type.
    Array-typed state should be created with cgCreateArrayState.

HISTORY
    cgCreateState was introduced in Cg 1.4.

SEE ALSO
    cgCreateArrayState, cgGetStateContext, cgGetStateName, cgGetStateType,
    cgIsState, cgSetStateCallbacks, cgGLRegisterStates

