NAME

cgSetStateCallbacks - registers the callback functions for a state assignment

SYNOPSIS

  #include <Cg/cg.h>

  void cgSetStateCallbacks( CGstate state,
                            CGstatecallback set,
                            CGstatecallback reset,
                            CGstatecallback validate );

PARAMETERS

state

The state handle.

set

The pointer to the callback function to call for setting the state of state assignments based on state. This may be a NULL pointer.

reset

The pointer to the callback function to call for resetting the state of state assignments based on state. This may be a NULL pointer.

validate

The pointer to the callback function to call for validating the state of state assignments based on state. This may be a NULL pointer.

RETURN VALUES

None.

DESCRIPTION

cgSetStateCallbacks sets the three callback functions for a state definition. These functions are later called when the state a particular state assignment based on this state must be set, reset, or validated. Any of the callback functions may be specified as NULL.

EXAMPLES

to-be-written

ERRORS

CG_INVALID_STATE_HANDLE_ERROR is generated if state is not a valid state.

HISTORY

cgSetStateCallbacks was introduced in Cg 1.4.

SEE ALSO

cgSetPassState, cgCallStateSetCallback, cgCallStateResetCallback, cgCallStateValidateCallback, cgValidateTechnique