cgCreateProgramFromEffect(3)

NAME
cgCreateProgramFromEffect - create a program object from an effect

SYNOPSIS
  #include <Cg/cg.h>
  CGprogram cgCreateProgramFromEffect( CGeffect effect,
                                       CGprofile profile,
                                       const char * entry,
                                       const char ** args );

PARAMETERS
The effect containing the program source code from which to create the program. The profile enumerant for the program. The entry point to the program in the Cg source. If NULL, the entry point defaults to "main". If args is not NULL it is assumed to be an array of NULL-terminated strings that will be passed directly to the compiler as arguments. The last value of the array must be a NULL.

RETURN VALUES
Returns a CGprogram handle on success.

Returns NULL if any error occurs.

DESCRIPTION
cgCreateProgramFromEffect generates a new CGprogram object and adds it to the effect's Cg context.

EXAMPLES
to-be-written

ERRORS
CG_INVALID_EFFECT_HANDLE_ERROR is generated if effect is not a valid effect.

CG_UNKNOWN_PROFILE_ERROR is generated if profile is not a supported profile.

CG_COMPILER_ERROR is generated if compilation fails.

HISTORY
cgCreateProgramFromEffect was introduced in Cg 1.4.

SEE ALSO
the cgCreateProgram manpage, the cgCreateProgramFromFile manpage