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

> ## Name

> cgSetTextureStateAssignment - sets a state assignment to a texture effect parameter

> ## Synopsis

>     #include <Cg/cg.h>

>     CGbool cgSetTextureStateAssignment( CGstateassignment sa,
>                                         CGparameter param );

> ## Parameters

> sa
>   A state assignment of type CG_TEXTURE.
> param
>   An effect parameter of type CG_TEXTURE.

> ## Return Values

> Returns CG_TRUE if it succeeds in setting the state assignment.

> Returns CG_FALSE otherwise.

> ## Description

> cgSetTextureStateAssignment sets the value of a state assignment of texture type to an effect parameter of type CG_TEXTURE.

> ## Examples

>     CGparameter effectParam = cgCreateEffectParameter(effect,
>                                                       "normalizeCube",
>                                                       CG_SAMPLERCUBE);
>     CGstate state = cgGetNamedSamplerState(context, "Texture");
>     CGstateassignment sa = cgCreateSamplerStateAssignment(effectParam, state);
>     CGbool ok = cgSetTextureStateAssignment(sa, value);

> ## Errors

> CG_INVALID_STATE_ASSIGNMENT_HANDLE_ERROR is generated if sa is not a valid state assignment.

> CG_STATE_ASSIGNMENT_TYPE_MISMATCH_ERROR is generated if sa is not a state assignment of texture type.

> CG_ARRAY_SIZE_MISMATCH_ERROR is generated if sa is an array and not a scalar.

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

> ## History

> cgSetTextureStateAssignment was introduced in Cg 1.5.

> ## See Also

> cgGetTextureStateAssignmentValue, cgSetSamplerStateAssignment, cgSetBoolArrayStateAssignment, cgSetBoolStateAssignment, cgSetFloatArrayStateAssignment, cgSetFloatStateAssignment, cgSetIntArrayStateAssignment, cgSetIntStateAssignment, cgSetProgramStateAssignment, cgSetStringStateAssignment