NAME

cgCallStateResetCallback - calls the state resetting callback function for a state assignment.

SYNOPSIS

  #include <Cg/cg.h>

  CGbool cgCallStateResetCallback(CGstateassignment sa);

PARAMETERS

sa

Specifies the state assignment handle.

RETURN VALUES

The boolean value returned by the callback function is returned. It should be CG_TRUE upon success. If no callback function was defined, CG_TRUE is returned.

DESCRIPTION

cgCallStateResetCallback calls the graphics state resetting callback function for the given state assignment.

The semantics of "resetting state" will depend on the particular graphics state manager that defined the valid state assignments; it will generally either mean that graphics state is reset to what it was before the pass, or that it is reset to the default value. The OpenGL state manager in the OpenGL Cg runtime implements the latter approach.

ERRORS

CG_INVALID_STATE_ASSIGNMENT_ERROR is generated if sa does not refer to a valid state assignment.

SEE ALSO

the "cgResetPassState" document, the "cgSetStateCallbacks" document