NAME

cgGLSetMatrixParameterArrayfc - set the values in a matrix array parameter

SYNOPSIS

  #include <Cg/cgGL.h>

  void cgGLSetMatrixParameterArrayfc( CGparameter param,
                                      long offset,
                                      long nelements,
                                      const float * v );

PARAMETERS

param

The array parameter that will be set.

offset

An offset into the array parameter from which to start setting. A value of 0 will start setting from the first element of the array.

nelements

The number of elements to set. A value of 0 will default to the number of elements in the array minus the offset value.

v

The array of values to set the parameter to. This must be a contiguous set of values that total nelements times the number of elements in the matrix.

RETURN VALUES

None.

DESCRIPTION

cgGLSetMatrixParameterArrayfc sets the value of a given matrix array parameter from an array laid out in column-major order.

EXAMPLES

to-be-written

ERRORS

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

CG_ARRAY_PARAM_ERROR is generated if param is not an array parameter.

CG_NOT_MATRIX_PARAM_ERROR is generated if the elements of the array indicated by param are not matrix parameters.

CG_OUT_OF_ARRAY_BOUNDS_ERROR is generated if the offset and/or the nelements parameter are out of the array bounds.

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

CG_INVALID_PARAMETER_ERROR is generated if the parameter fails to set for any other reason.

HISTORY

cgGLSetMatrixParameterArrayfc was introduced in Cg 1.1.

SEE ALSO

cgGLSetMatrixParameter, cgGLGetMatrixParameterArray