NAME
cgGetNextParameter - iterate through a program's or effect's parameters
SYNOPSIS
#include <Cg/cg.h> CGparameter cgGetNextParameter( CGparameter current );PARAMETERS
- current
The current parameter.
RETURN VALUES
cgGetNextParameter returns the next parameter in the program's internal sequence of parameters. It returns NULL when current is the last parameter in the program.
DESCRIPTION
The parameters of a program or effect can be iterated over using the cgGetNextParameter, cgGetFirstParameter, cgGetNextStructParameter, and cgGetArrayParameter functions.
EXAMPLES
The following example code illustrates one way to do this:
void RecurseParams( CGparameter param ) { if(!param) return; do { switch(cgGetParameterType(param)) { case CG_STRUCT : RecurseParams(cgGetFirstStructParameter(param)); break; case CG_ARRAY : { int ArraySize = cgGetArraySize(param, 0); int i; 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 ) ); }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.
ERRORS
CG_INVALID_PARAM_HANDLE_ERROR is generated if current does not refer to a valid parameter.
HISTORY
cgGetNextParameter was introduced in Cg 1.1.
SEE ALSO
cgFirstParameter, cgFirstEffectParameter, cgGetFirstStructParameter, cgGetArrayParameter, cgGetParameterType