> # NAME

> cgGetFirstProgram - get the first program in a context

> # SYNOPSIS

>       #include <Cg/cg.h>

>       CGprogram cgGetFirstProgram( CGcontext context );

> # PARAMETERS

> context

>   The context from which to retrieve the first program.

> # RETURN VALUES

> Returns the first CGprogram object in context.

> Returns NULL if context contains no programs or an error occurs.

> # DESCRIPTION

> cgGetFirstProgram is used to begin iteration over all of the programs contained within a context. See cgGetNextProgram for more information.

> # EXAMPLES

>       CGprogram program = cgGetFirstProgram( context );
>       while ( program )
>       {
>         /* do something with program */
>         program = cgGetNextProgram( program );
>       }

> # ERRORS

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

> # HISTORY

> cgGetFirstProgram was introduced in Cg 1.1.

> # SEE ALSO

> cgGetNextProgram, cgCreateProgram, cgDestroyProgram, cgIsProgram