NAME

cgSetStateCallbacks - registers the set, reset, and validation callback functions for a state assignment.

SYNOPSIS

  #include <Cg/cg.h>

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

PARAMETERS

state

Specifies the state handle.

set

Specifices 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

Specifices 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

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

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.

ERRORS

CG_INVALID_STATE_ERROR is generated if state does not refer to a valid state definition.

SEE ALSO

the "cgSetPassState" document, the "cgCallStateSetCallback" document, the "cgCallStateResetCallback" document, the "cgCallStateValidateCallback" document, the "cgValidateTechnique" document.