NAME

cgGetFirstEffectAnnotation - get the first annotation in an effect

SYNOPSIS

  #include <Cg/cg.h>

  CGannotation cgGetFirstEffectAnnotation( CGeffect effect );

PARAMETERS

effect

The effect from which to retrieve the first annotation.

RETURN VALUES

Returns the first annotation. If the effect has no annotations, NULL is returned.

DESCRIPTION

The annotations associated with an effect can be retrieved using the cgGetFirstEffectAnnotation function. The rest of the effect's annotations can be discovered by iterating through them using cgGetNextAnnotation.

EXAMPLES

The following example code illustrates this on CGeffect effect:

  CGannotation ann = cgGetFirstEffectAnnotation( effect );
  while( ann )
  {
     /* do something with ann */
     ann = cgGetNextAnnotation( ann );
  }

ERRORS

CG_INVALID_EFFECT_HANDLE_ERROR is generated if effect is not a valid effect.

HISTORY

cgGetFirstEffectAnnotation was introduced in Cg 1.5.

SEE ALSO

cgGetNamedEffectAnnotation, cgGetNextAnnotation