Cg Core Runtime API                        cgGetNextAnnotation(3)



NAME
     cgGetNextAnnotation - iterate through annotations

SYNOPSIS
       #include 

       CGannotation cgGetNextAnnotation( CGannotation ann );


PARAMETERS
     ann     The current annotation.

RETURN VALUES
     Returns the next annotation in the sequence of annotations
     associated with the annotated object.

     Returns NUL when ann is the last annotation.

DESCRIPTION
     The annotations associated with a parameter, pass,
     technique, or program can be iterated over by using
     cgGetNextAnnotation.

     Note that no specific order of traversal is defined by this
     mechanism.  The only guarantee is that each annotation will
     be visited exactly once.

EXAMPLES
       CGannotation ann = cgGetFirstParameterAnnotation( param );
       while( ann )
       {
         /* do something with ann */
         ann = cgGetNextAnnotation( ann );
       }


ERORS
     CGINVALIDANOTATIONHANDLEROR is generated if ann is
     not a valid annotation.

HISTORY
     cgGetNextAnnotation was introduced in Cg 1.4.

SEE ALSO
     cgGetFirstParameterAnnotation, cgGetFirstPassAnnotation,
     cgGetFirstTechniqueAnnotation, cgGetFirstProgramAnnotation,
     cgGetNamedParameterAnnotation, cgGetNamedPassAnnotation,
     cgGetNamedTechniqueAnnotation, cgGetNamedProgramAnnotation,
     cgIsAnnotation






Cg Toolkit 2.1            Last change:                          1