NAME

cgCallStateValidateCallback - calls the state validation callback function for a state assignment

SYNOPSIS

  #include <Cg/cg.h>

  CGbool cgCallStateValidateCallback( CGstateassignment sa );

PARAMETERS

sa

The state assignment handle.

RETURN VALUES

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

DESCRIPTION

cgCallStateValidateCallback calls the state validation callback function for the given state assignment. The validation callback will return CG_TRUE or CG_FALSE depending on whether the current hardware and driver support the graphics state set by the state assignment.

EXAMPLES

to-be-written

ERRORS

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

HISTORY

cgCallStateValidateCallback was introduced in Cg 1.4.

SEE ALSO

cgValidatePassState, cgSetStateCallbacks