cgCompileProgram

Langue: en

Version: 46729 (openSuse - 09/10/07)

Section: 3 (Bibliothèques de fonctions)

NAME

cgCompileProgram - compile a program object

SYNOPSIS


  #include <Cg/cg.h>






  void cgCompileProgram( CGprogram program );





PARAMETERS


program
The program object to compile.

RETURN VALUES

None.

DESCRIPTION

cgCompileProgram compiles the specified Cg program for its target profile. A program must be compiled before it can be loaded (by the API-specific part of the runtime). It must also be compiled before its parameters can be inspected.

Certain actions invalidate a compiled program and the current value of all of its parameters. If one of these actions is performed, the program must be recompiled before it can be used. A program is invalidated if the program source is modified, if the compile arguments are modified, or if the entry point is changed.

If one of the parameter bindings for a program is changed, that action invalidates the compiled program, but does not invalidate the current value of the program's parameters.

EXAMPLES


  if(!cgIsProgramCompiled(program))

   cgCompileProgram(program);





ASSOCIATED GETS

cgGetProgramString with pname CG_COMPILED_PROGRAM.

ERRORS

CG_INVALID_PROGRAM_HANDLE_ERROR is generated if program is not a valid program handle.

CG_COMPILER_ERROR is generated if compilation fails.

HISTORY

cgCompileProgram was introduced in Cg 1.1.

SEE ALSO

the cgIsProgramCompiled manpage, the cgCreateProgram manpage, the cgGetNextParameter manpage, the cgIsParameter manpage, the cgGetProgramString manpage