niHWS_SetScalingCoefficients

NI-HWS C Function Reference

niHWS_SetScalingCoefficients

C Function Prototype

tHWS_Status niHWS_SetScalingCoefficients  (tHWS_WfmRef wfmReference, long numCoeffs, const double* coeffArray);

Purpose

Establishes an nth degree polynomial scaling function.

When an analog waveform stored as integer data is retrieved by a floating-point Read or Retrieve function, NI-HWS scales the data according to this polynomial scaling function.

Parameters

Name Type Description
wfmReference tHWS_WfmRef A reference to the waveform. Waveforms are identified by reference for purposes of setting and getting waveform attributes and reading and writing data.
numCoeffs long The number of coefficients in coeffArray.
coeffArray const double* The array of polynomial scaling coefficients. The coefficient for the nth term of the polynomial is contained in the nth index of coeffArray.

For example, the coefficients for a 2nd degree polynomial,

y = ax2 + bx + c

would be

coeffArray[0] = c
coeffArray[1] = b
coeffArray[2] = a

Return Value