NAME

cgGetFirstPass - get the first pass in a technique

SYNOPSIS

  #include <Cg/cg.h>

  CGpass cgGetFirstPass( CGtechnique tech );

PARAMETERS

tech

The technique from which to retrieve the first pass.

RETURN VALUES

Returns the first CGpass object in tech.

Returns NULL if tech contains no passes.

DESCRIPTION

cgGetFirstPass is used to begin iteration over all of the passes contained within a technique. See cgGetNextPass for more information.

EXAMPLES

  CGpass pass = cgGetFirstPass( tech );
  while ( pass )
  {
    /* Do stuff with pass */
    leaf = cgGetNextPass( pass );
  }

ERRORS

CG_INVALID_TECHNIQUE_HANDLE_ERROR is generated if tech is not a valid technique.

HISTORY

cgGetFirstPass was introduced in Cg 1.4.

SEE ALSO

cgGetNextPass, cgGetNamedPass, cgIsPass, cgGetFirstPassAnnotation