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 cgGetFirstProgramAnnotation and cgGetNextAnnotation), calling cgGetAnnotationName 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
cgGetFirstProgramAnnotation, cgGetNextAnnotation, cgGetAnnotationName