cgGetNamedProgramAnnotation

Langue: en

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

Section: 3 (Bibliothèques de fonctions)

Sommaire

NAME

cgGetNamedProgramAnnotation - get a program annotation by name

SYNOPSIS


  #include <Cg/cg.h>







  CGannotation cgGetNamedProgramAnnotation( CGprogram program,

                                            const char * name );

PARAMETERS


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

RETURN VALUES

Returns the named annotation.

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

DESCRIPTION

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

EXAMPLES


  /* fetch annotation "Apple" from CGprogram program */

  CGannotation ann = cgGetNamedProgramAnnotation( program, "Apple" );

ERRORS

CG_INVALID_PROGRAM_HANDLE_ERROR is generated if program is not a valid program handle.

HISTORY

cgGetNamedProgramAnnotation was introduced in Cg 1.4.

SEE ALSO

the cgGetFirstProgramAnnotation manpage, the cgGetNextProgramAnnotation manpage, the cgGetAnnotationName manpage