NAME

cgGLEnableTextureParameter - enables the texture unit associated with the given texture parameter

SYNOPSIS

  #include <Cg/cgGL.h>

  void cgGLEnableTextureParameter( CGparameter param );

PARAMETERS

param

The texture parameter that has a texture object associated with it.

RETURN VALUES

None.

DESCRIPTION

cgGLEnableTextureParameter binds and enables the texture object that was associated with the parameter 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 handle.

CG_INVALID_PARAMETER_ERROR is generated param is not a sampler parameter or if the parameter fails to set for any other reason.

HISTORY

cgGLEnableTextureParameter was introduced in Cg 1.1.

SEE ALSO

cgGLDisableTextureParameter, cgGLSetTextureParameter