DTWAIN_ArrayFix32SetAt

Top Previous Next

The DTWAIN_ArrayFix32SetAt sets the Integer and Fractional portions of a fixed point value within an array of fixed point values.

DTWAIN_BOOL DTWAIN_ArrayFix32SetAt (

DTWAIN_ARRAY	Array,
LONG	Index,
LONG	Whole,
LONG	Frac );

Parameters

Array

A DTWAIN_ARRAY that holds fixed point values.

Index

Position in array to set the fixed point element

Whole

LONG value that will set as the integer portion of the fixed point value.

Frac

LONG value that will set the fractional portion of the fixed point value.

Return Values

If the function succeeds, TRUE is returned. If the function fails FALSE is returned.

Comments

The DTWAIN_ArrayFix32SetAt function sets the integer and fractional portions of an entry in a DTWAIN_ARRAY that consists of fixed point values. The Index is the element within the array. The Whole is the integer portion, and the Frac is the fractional portion of the number.

The usage of DTWAIN_ArrayFix32SetAt should be used for computer languages utilizing that DTWAIN that has minimal, if any floating point support for IEEE 64-bit floating point values (DTWAIN_FLOAT). Languages such as Macro Scheduler, XBase++, and other languages that lack proper floating point support should utilize this and other floating point functions instead of the traditional DTWAIN functions that handle floating point data. See Floating Point Issues in this manual for more information, as well as the examples that shows usage of this and other functions.

Since most computer languages handle DTWAIN_FLOAT with no issues, the DTWAIN_ArrayFix32SetAt should rarely be used, if it is ever used.

TWAIN State Transitions

None.

Prerequisite Function Call(s)

DTWAIN_SysInitialize