NAME

cgGetNextTechnique - iterate through techniques in a effect

SYNOPSIS

  #include <Cg/cg.h>

  CGtechnique cgGetNextTechnique( CGtechnique tech );

PARAMETERS

tech

The current technique.

RETURN VALUES

cgGetNextTechnique returns the next technique in the effect's internal sequence of techniques. Returns 0 when prog is the last technique in the effect.

DESCRIPTION

The techniques within a effect can be iterated over by using the cgGetNextTechnique function.

EXAMPLES

The following example code illustrates one way to do this:

  CGtechnique tech = cgGetFirstTechnique( effect );
  while( tech )
  {
   /* do something with tech */
   tech = cgGetNextTechnique( tech )
  }

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

ERRORS

CG_INVALID_TECHNIQUE_HANDLE_ERROR is generated if prog does not refer to a valid technique.

HISTORY

cgGetNextTechnique was introduced in Cg 1.4.

SEE ALSO

cgGetFirstTechnique, cgGetNamedTechnique