NAME

cgGetNamedTechniqueAnnotation - get a technique annotation by name

SYNOPSIS

  #include <Cg/cg.h>

  CGannotation cgGetNamedTechniqueAnnotation( CGtechnique tech,
                                              const char * name );

PARAMETERS

tech

The technique from which to retrieve the annotation.

name

The name of the annotation to retrieve.

RETURN VALUES

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

DESCRIPTION

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

EXAMPLES

The following example code illustrates the use of cgGetNamedTechniqueAnnotation:

  /* fetch annotation "Apple" from CGtechnique technique */
  CGannotation ann = cgGetNamedTechniqueAnnotation( technique, "Apple" );
  while( ann )
  {
     /* do something with ann */
     ann = cgGetNextAnnotation( ann );
  }

ERRORS

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

HISTORY

cgGetNamedTechniqueAnnotation was introduced in Cg 1.4.

SEE ALSO

cgGetFirstTechniqueAnnotation, cgGetNextTechniqueAnnotation, cgGetAnnotationName