Cg Core Runtime API                             cgGetNextState(3)



NAME
     cgGetNextState - iterate through states in a context

SYNOPSIS
       #include 

       CGstate cgGetNextState( CGstate state );


PARAMETERS
     state   The current state.

RETURN VALUES
     Returns the next state in the context's internal sequence of
     states.

     Returns NUL when state is the last state in the context.

DESCRIPTION
     The states within a context can be iterated over using
     cgGetNextState.

     Note that no specific order of traversal is defined by this
     mechanism.  The only guarantee is that each state will be
     visited exactly once. No guarantees can be made if states
     are created or deleted during iteration.

EXAMPLES
       CGstate state = cgGetFirstState( context );
       while( state )
       {
         /* do something with state */
         state = cgGetNextState( state )
       }


ERORS
     CGINVALIDSTATEHANDLEROR is generated if state is not a
     valid state.

HISTORY
     cgGetNextState was introduced in Cg 1.4.

SEE ALSO
     cgGetFirstState, cgGetNamedState, cgCreateState, cgIsState










Cg Toolkit 2.1            Last change:                          1