DTWAIN_ArrayConvertFix32ToFloat

Top  Previous  Next

The DTWAIN_ArrayConvertFix32ToFloat creates a DTWAIN_ARRAY of DTWAIN_FLOAT values from a DTWAIN_ARRAY of fixed point values.

 

DTWAIN_ARRAY DTWAIN_ArrayConvertFix32ToFloat ( DTWAIN_ARRAY Array )

 

Parameters

Array

A DTWAIN_ARRAY that holds fixed point values.

 

Return Values

If the function succeeds, a new DTWAIN_ARRAY is returned that contains DTWAIN_FLOAT values.  


On failure, NULL is returned.  Call DTWAIN_GetLastError() to get extended information.

 

Comments

The DTWAIN_ArrayConvertFix32ToFloat function returns a new DTWAIN_ARRAY that holds DTWAIN_FLOAT values that are equivalent to the fixed point values in the DTWAIN_ARRAY that was passed in.

 

A DTWAIN_ARRAY of fixed point values can be used to set or get entries that represent floating point values, but instead the fixed point entry will use integers to represent the whole number and decimal portions of the floating point number.  


If DTWAIN_ArrayConvertFix32ToFloat succeeds, the original DTWAIN_ARRAY of fixed point values that was passed to DTWAIN_ArrayConvertFix32ToFloat is destroyed and no longer can be used.


TWAIN State Transitions

None.

 

Prerequisite Function Call(s)

DTWAIN_SysInitialize


See Also

DTWAIN_ArrayFix32GetAt

DTWAIN_ArrayFix32SetAt