Linux Certif

Toute la documentation sur la certification Linux LPI

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

the cgGetParameterValue manpage