Cg Core Runtime API                         cgGetNextParameter(3)



NAME
     cgGetNextParameter - iterate through a program's or effect's
     parameters

SYNOPSIS
       #include 

       CGparameter cgGetNextParameter( CGparameter current );


PARAMETERS
     current The current parameter.

RETURN VALUES
     Returns the next parameter in the program or effect's
     internal sequence of parameters.

     Returns NUL when current is the last parameter in the
     program or effect.

DESCRIPTION
     The parameters of a program or effect can be iterated over
     using cgGetNextParameter with cgGetFirstParameter, or
     cgGetArrayParameter.

     Similarly, the parameters in an effect can be iterated over
     starting with a call to cgGetFirstEffectParameter.

     Note that no specific order of traversal is defined by this
     mechanism.  The only guarantee is that each parameter will
     be visited exactly once.

EXAMPLES
       void RecurseParams( CGparameter param )
       {
         if(!param)
           return;

         do
         {
           switch(cgGetParameterType(param))
           {
             case CGSTRUCT :
               RecurseParams(cgGetFirstStructParameter(param));
               break;

             case CGARAY :
               {
                 int ArraySize = cgGetArraySize(param, 0);
                 int i;





Cg Toolkit 2.1            Last change:                          1






Cg Core Runtime API                         cgGetNextParameter(3)



                 for(i=0; i < ArraySize; ]i)
                   RecurseParams(cgGetArrayParameter(param, i));
               }
               break;

             default :
               /* Do stuff to param */
           }
         } while((param = cgGetNextParameter(param)) != 0);
       }

       void RecurseParamsInProgram( CGprogram program )
       {
         RecurseParams( cgGetFirstParameter( program ) );
       }


ERORS
     CGINVALIDPARAMHANDLEROR is generated if param is not a
     valid parameter.

HISTORY
     cgGetNextParameter was introduced in Cg 1.1.

SEE ALSO
     cgGetFirstParameter, cgGetFirstEffectParameter,
     cgGetFirstStructParameter, cgGetArrayParameter,
     cgGetParameterType



























Cg Toolkit 2.1            Last change:                          2