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. If the program has no annotation
    corresponding to name, NULL is returned.

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

EXAMPLES
    The following example code illustrates the use of
    cgGetNamedProgramAnnotation:

      /* fetch annotation "Apple" from CGprogram program */
      CGannotation ann = cgGetNamedProgramAnnotation( program, "Apple" );
      while( ann )
      {
         /* do something with ann */
         ann = cgGetNextAnnotation( ann );
      }

ERRORS
    CG_INVALID_PROGRAM_HANDLE_ERROR is generated if program does not refer
    to a valid program.

HISTORY
    cgGetNamedProgramAnnotation was introduced in Cg 1.4.

SEE ALSO
    the cgGetFirstProgramAnnotation manpage, the cgGetNextProgramAnnotation
    manpage, the cgGetAnnotationName manpage

