cgGetNextStateAssignment

> # NAME

> cgGetNextStateAssignment - iterate through state assignments in a pass

> # SYNOPSIS

>       #include <Cg/cg.h>

>       CGstateassignment cgGetNextStateAssignment( CGstateassignment sa );

> # PARAMETERS

> sa

>   The current state assignment.

> # RETURN VALUES

> Returns the next state assignment in the pass' internal sequence of state assignments.

> Returns NULL when prog is the last state assignment in the pass.

> # DESCRIPTION

> The state assignments within a pass can be iterated over by using cgGetNextStateAssignment.

> State assignments are returned in the same order specified in the pass in the effect.

> # EXAMPLES

>       CGstateassignment sa = cgGetFirstStateAssignment( pass );
>       while( sa )
>       {
>         /* do something with sa */
>         sa = cgGetNextStateAssignment( sa )
>       }

> # ERRORS

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

> # HISTORY

> cgGetNextStateAssignment was introduced in Cg 1.4.

> # SEE ALSO

> cgGetFirstStateAssignment, cgGetNamedStateAssignment, cgIsStateAssignment