cgGetNamedPassAnnotation

Langue: en

Version: 46984 (openSuse - 09/10/07)

Section: 3 (Bibliothèques de fonctions)

NAME

cgGetNamedPassAnnotation - get a pass annotation by name

SYNOPSIS


  #include <Cg/cg.h>






  CGannotation cgGetNamedPassAnnotation( CGpass pass,

                                         const char * name );





PARAMETERS


pass
The pass from which to retrieve the annotation.
name
The name of the annotation to retrieve.

RETURN VALUES

Returns the named annotation.

Returns NULL if the pass has no annotation corresponding to name.

DESCRIPTION

The annotations associated with a pass can be retrieved directly by name using cgGetNamedPassAnnotation. The names of a pass's annotations can be discovered by iterating through the annotations (see the cgGetFirstPassAnnotation manpage and the cgGetNextAnnotation manpage), calling the cgGetAnnotationName manpage for each one in turn.

EXAMPLES


  /* fetch annotation "Apple" from CGpass pass */

  CGannotation ann = cgGetNamedPassAnnotation( pass, "Apple" );





ERRORS

CG_INVALID_PASS_HANDLE_ERROR is generated if pass is not a valid pass.

HISTORY

cgGetNamedPassAnnotation was introduced in Cg 1.4.

SEE ALSO

the cgGetFirstPassAnnotation manpage, the cgGetNextPassAnnotation manpage, the cgGetAnnotationName manpage