cgCallStateResetCallback
Keywords: cgCallStateResetCallback, NVIDIA, NVIDIA Cg Toolkit, Cg Toolkit, Shader, Shader Programming, GPU Shader Programming, GPU Program

> ## Name

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

> ## Synopsis

>     #include <Cg/cg.h>

>     CGbool cgCallStateResetCallback( CGstateassignment sa );

> ## Parameters

> sa
>   The state assignment handle.

> ## Return Values

> Returns the boolean value returned by the callback function. It should be CG_TRUE upon success.

> Returns CG_TRUE if no callback function was defined.

> ## 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.

> ## Examples

> to-be-written

> ## Errors

> CG_INVALID_STATE_ASSIGNMENT_HANDLE_ERROR is generated if sa is not a valid state assignment.

> ## History

> cgCallStateResetCallback was introduced in Cg 1.4.

> ## See Also

> cgResetPassState, cgSetStateCallbacks, cgCallStateSetCallback, cgCallStateValidateCallback