NAME

cgGetFloatStateAssignmentValues - get a float-valued state assignment's values

SYNOPSIS

  #include <Cg/cg.h>

  const float *cgGetFloatStateAssignmentValues(CGstateassignment sa,
                                               int *nvalues);

PARAMETERS

sa

Specifies the state assignment.

nvalues

Pointer to integer where the number of values returned will be stored.

DESCRIPTION

cgGetFloatStateAssignmentValues allows the application to retrieve the value(s) of a floating-point typed state assignment.

RETURN VALUES

Returns a pointer to an array of float values. The number of values in the array is returned via the nvalues parameter.

If no values are available, NULL will be returned and nvalues will be 0.

ERRORS

CG_INVALID_STATE_ASSIGNMENT_HANDLE_ERROR is generated if the handle sa is invalid.

CG_INVALID_PARAMETER_ERROR is generated if nvalues is NULL.

CG_INVALID_PARAMETER_TYPE_ERROR is generated if the state assignment is not float-typed.

SEE ALSO

the "cgGetStateAssignmentState" document, the "cgGetStateType" document, the "cgGetIntStateAssignmentValues" document, the "cgGetBoolStateAssignmentValues" document, the "cgGetStringStateAssignmentValue" document, the "cgGetProgramStateAssignmentValue" document, the "cgGetSamplerStateAssignmentValue" document, and the "cgGetTextureStateAssignmentValue" document