NAME

cgGetNamedPass - get a technique pass by name

SYNOPSIS

  #include <Cg/cg.h>

  CGpass cgGetNamedPass( CGtechnique tech, const char * name );

PARAMETERS

tech

Specifies the technique to retrieve the pass from.

name

Specifies the name of the pass to retrieve.

DESCRIPTION

The passes of a technique can be retrieved directly by name using the cgGetNamedPass function. The names of the passes in a technique can be discovered by iterating through the technique's passes (see the "cgGetFirstPass" document and the "cgGetNextPass" document), calling cgGetPassName for each one in turn.

RETURN VALUES

Returns the named pass from the technique. If the technique has no pass corresponding to name, NULL is returned.

ERRORS

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

SEE ALSO

the "cgIsPass" document, the "cgGetFirstPass" document, the "cgGetNextPass" document, the "cgGetPassName" document