Name
cgGLGetMatrixParameterArrayfr - get the values from a matrix array parameter
Synopsis
#include <Cg/cgGL.h> void cgGLGetMatrixParameterArrayfr( CGparameter param, long offset, long nelements, float * 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 v must be nelements times the number of elements in the matrix.
Return Values
None.
Description
cgGLGetMatrixParameterArrayfr retrieves an array of values from a matrix array parameter using row-major ordering.
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 offset or nelements is outside the bounds of param.
CG_INVALID_PARAM_HANDLE_ERROR is generated if param is not a valid parameter.
History
cgGLGetMatrixParameterArrayfr was introduced in Cg 1.1.
See Also