cgGLGetMatrixParameterArray

> # NAME

> cgGLGetMatrixParameterArray - get the values from an matrix array parameter

> # SYNOPSIS

>       #include <Cg/cgGL.h>

>       /* TYPE is float or double */

>       void cgGLGetMatrixParameterArray{fd}{rc}( CGparameter param,
>                                                 long offset,
>                                                 long nelements,
>                                                 TYPE * v );

> # PARAMETERS

> param

>   The matrix array parameter from which the values will be retrieved.

> offset

>   An offset into the array parameter at which to start getting elements. A value of 0 will begin at the first element of the array.

> nelements

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

> v

>   The array into which to retrieve the values. The size of the array must be nelements times the number of elements in the matrix.

> # RETURN VALUES

> None.

> # DESCRIPTION

> The cgGLGetMatrixParameterArray functions retrieve an array of values from a matrix array parameter.

> There are versions of the function that return either float or double values signified by f or d in the function name.

> There are versions of the function that assume the array of values is laid out in either row or column order signified by r or c respectively in the function name.

> # 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 param are not matrix parameters.

> CG_OUT_OF_ARRAY_BOUNDS_ERROR is generated if the offset or the nelements parameter is out of the array bounds.

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

> # HISTORY

> The cgGLGetMatrixParameterArray functions were introduced in Cg 1.1.

> # SEE ALSO

> cgGLGetParameter, cgGLSetParameter, cgGLSetParameterArray