cgGetNamedParameterAnnotation

Langue: en

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

Section: 3 (Bibliothèques de fonctions)

NAME

cgGetNamedParameterAnnotation - get a parameter annotation by name

SYNOPSIS


  #include <Cg/cg.h>






  CGannotation cgGetNamedParameterAnnotation( CGparameter param,

                                              const char * name );





PARAMETERS


param
The parameter from which to retrieve the annotation.
name
The name of the annotation to retrieve.

RETURN VALUES

Returns the named annotation.

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

DESCRIPTION

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

EXAMPLES


  /* fetch annotation "Apple" from CGparameter param */

  CGannotation ann = cgGetNamedParameterAnnotation( param, "Apple" );





ERRORS

CG_INVALID_PARAM_HANDLE_ERROR is generated if param is not a valid parameter.

HISTORY

cgGetNamedParameterAnnotation was introduced in Cg 1.4.

SEE ALSO

the cgGetFirstParameterAnnotation manpage, the cgGetNextParameterAnnotation manpage, the cgGetAnnotationName manpage