cgCreateState

Langue: en

Version: 46753 (openSuse - 09/10/07)

Section: 3 (Bibliothèques de fonctions)

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 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 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 the cgCreateArrayState manpage.

HISTORY

cgCreateState was introduced in Cg 1.4.

SEE ALSO

the cgCreateArrayState manpage, the cgGetStateContext manpage, the cgGetStateName manpage, the cgGetStateType manpage, the cgIsState manpage, the cgSetStateCallbacks manpage, the cgGLRegisterStates manpage