> ## Name

> cgGetFirstEffect - get the first effect in a context

> ## Synopsis

>     #include <Cg/cg.h>

>     CGeffect cgGetFirstEffect( CGcontext context );

> ## Parameters

> context
>   The context from which to retrieve the first effect.

> ## Return Values

> Returns the first CGeffect object in context.

> Returns NULL if context contains no effects.

> ## Description

> cgGetFirstEffect is used to begin iteration over all of the effects contained by a context. See cgGetNextEffect for more information.

> ## Examples

>     /* one or more effects have previously been loaded into context */
>     CGeffect effect = cgGetFirstEffect( context );

> ## Errors

> CG_INVALID_CONTEXT_HANDLE_ERROR is generated if context is not a valid context.

> ## History

> cgGetFirstEffect was introduced in Cg 1.4.

> ## See Also

> cgGetNextEffect, cgCreateEffect, cgCreateEffectFromFile, cgDestroyEffect, cgIsEffect, cgGetFirstProgram