cgGLEnableTextureParameter
Keywords: cgGLEnableTextureParameter, NVIDIA, NVIDIA Cg Toolkit, Cg Toolkit, Shader, Shader Programming, GPU Shader Programming, GPU Program

> ## Name

> cgGLEnableTextureParameter - enables the texture unit associated with a texture parameter

> ## Synopsis

>     #include <Cg/cgGL.h>

>     void cgGLEnableTextureParameter( CGparameter param );

> ## Parameters

> param
>   The texture parameter which will be enabled.

> ## Return Values

> None.

> ## Description

> cgGLEnableTextureParameter binds and enables the texture object associated with param. It must be called after cgGLSetTextureParameter is called but before the geometry is drawn.

> cgGLDisableTextureParameter should be called once all of the geometry is drawn to avoid applying the texture to the wrong geometry and shaders.

> ## Examples

> to-be-written

> ## Errors

> CG_INVALID_PROFILE_ERROR is generated if param's profile is not a supported OpenGL profile. In particular, if param is not a parameter handle retrieved from a CGprogram but was instead retrieved from a CGeffect or is a shared parameter created at runtime, this error will be generated since those parameters do not have a profile associated with them.

> CG_INVALID_PARAM_HANDLE_ERROR is generated if param is not a valid parameter.

> CG_INVALID_PARAMETER_ERROR is generated if param is not a texture parameter or if the enable operation fails for any other reason.

> ## History

> cgGLEnableTextureParameter was introduced in Cg 1.1.

> ## See Also

> cgGLDisableTextureParameter, cgGLSetTextureParameter