NAME
    cgCreateState - create a state definition

SYNOPSIS
      #include <Cg/cg.h>

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

PARAMETERS
    context The context to define the state in.

    name    The name of the new state.

    type    The type of the new state.

RETURN VALUES
    cgCreateState returns a handle to the newly created CGstate. If there is
    an error, NULL is returned.

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

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

EXAMPLES
    *to-be-written*

ERRORS
    CG_INVALID_CONTEXT_HANDLE_ERROR is generated if context does not refer
    to a valid context.

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

HISTORY
    cgCreateState was introduced in Cg 1.4.

SEE ALSO
    the cgCreateArrayState manpage, the cgGetStateName manpage, the
    cgGetStateType manpage, the cgIsState manpage, the cgSetStateCallbacks
    manpage, the cgGLRegisterStates manpage

