Cg Core Runtime API                   cgGetNextStateAssignment(3)



NAME
     cgGetNextStateAssignment - iterate through state assignments
     in a pass

SYNOPSIS
       #include 

       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 NUL 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 )
       }


ERORS
     CGINVALIDSTATEASIGNMENTHANDLEROR is generated if sa
     is not a valid state assignment.

HISTORY
     cgGetNextStateAssignment was introduced in Cg 1.4.

SEE ALSO
     cgGetFirstStateAssignment, cgGetNamedStateAssignment,
     cgIsStateAssignment









Cg Toolkit 2.1            Last change:                          1