cgGLSetupSampler

> # NAME

> cgGLSetupSampler - initializes a sampler's state and texture object handle

> # SYNOPSIS

>       #include <Cg/cgGL.h>

>       void cgGLSetupSampler( CGparameter param,
>                              GLuint texobj );

> # PARAMETERS

> param

>   The sampler parameter that will be set.

> texobj

>   An OpenGL texture object name to which the parameter will be set.

> # RETURN VALUES

> None.

> # DESCRIPTION

> cgGLSetupSampler initializes a sampler; like cgGLSetTextureParameter, it informs the OpenGL Cg runtime which OpenGL texture object to associate with the sampler. Furthermore, if the sampler was defined in the source file with a sampler_state block that specifies sampler state, this sampler state is initialized for the given texture object.

> Note that in order to use the texture, either cgGLEnableTextureParameter must be called after cgGLSetTextureParameter and before the geometry is drawn, or cgGLSetManageTextureParameters must be called with a value of CG_TRUE.

> # EXAMPLES

> to-be-written

> # ERRORS

> CG_INVALID_PROFILE_ERROR is generated if param's profile is not a supported OpenGL profile.

> 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 parameter fails to set for any other reason.

> # HISTORY

> cgGLSetupSampler was introduced in Cg 1.4.

> # SEE ALSO

> cgGLSetTextureParameter, cgGLGetTextureParameter, cgGLSetManageTextureParameters