cgSetParameter

> # NAME

> cgSetParameter - sets the value of scalar and vector parameters

> # SYNOPSIS

>       #include <Cg/cg.h>

>       /* TYPE is int, float or double */

>       void cgSetParameter1{ifd}( CGparameter param,
>                                  TYPE x );

>       void cgSetParameter2{ifd}( CGparameter param,
>                                  TYPE x,
>     			     TYPE y );

>       void cgSetParameter3{ifd}( CGparameter param,
>                                  TYPE x,
>     			     TYPE y,
>     			     TYPE z );

>       void cgSetParameter4{ifd}( CGparameter param,
>                                  TYPE x,
>     			     TYPE y,
>     			     TYPE z,
>     			     TYPE w );

>       void cgSetParameter{1234}{ifd}v( CGparameter param,
>                                        const TYPE * v );

> # PARAMETERS

> param

>   The parameter that will be set.

> x, y, z, and w

>   The values to which to set the parameter.

> v

>   The values to set the parameter to for the array versions of the set functions.

> # RETURN VALUES

> None.

> # DESCRIPTION

> The cgSetParameter functions set the value of a given scalar or vector parameter. The functions are available in various combinations.

> Each function takes either 1, 2, 3, or 4 values depending on the function that is used. If more values are passed in than the parameter requires, the extra values will be ignored.

> There are versions of each function that take int, float or double values signified by the i, f or d in the function name.

> The functions with the v at the end of their names take an array of values instead of explicit parameters.

> Once cgSetParameter has been used to set a parameter, the values may be retrieved from the parameter using the CG_CURRENT enumerant with cgGetParameterValues.

> If an API-dependant layer of the Cg runtime (e.g. cgGL) is used, these entry points may end up making API (e.g. OpenGL) calls.

> # EXAMPLES

> to-be-written

> # ERRORS

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

> CG_INVALID_PARAMETER_ERROR is generated if param is a varying input to a fragment program.

> # HISTORY

> The d and f versions of cgSetParameter were introduced in Cg 1.2.

> The i versions of cgSetParameter were introduced in Cg 1.4.

> # SEE ALSO

> cgGetParameterValue