DTWAIN_GetRotation

Top  Previous  Next

The DTWAIN_GetRotation function gets the current rotation value for the Source.

 

DTWAIN_BOOL DTWAIN_GetRotation (

DTWAIN_SOURCE

Source,

LPDTWAIN_FLOAT

lpRotation );

 

Parameters

Source

An open TWAIN Source.

 

lpResolution

Address of a DTWAIN_FLOAT  (LPDTWAIN_FLOAT ).  On return, this is filled in with the current rotation.

 

Return Values

The return value is TRUE if successful.  Otherwise FALSE is returned.

 

Comments

The DTWAIN_GetRotation function gets the rotation value for the Source, Source. On return, fills the DTWAIN_FLOAT that lpRotation points to .  Please note that lpRotation is an address of a DTWAIN_FLOAT (an LPDTWAIN_FLOAT).  The rotation is the rotation angle between -360 and +360 degrees for the images that will be acquired by the TWAIN device.

 

Note that some Sources do not support retrieving the rotation or setting the image's rotation, so the return value for DTWAIN_GetRotation will always be FALSE.  To test if a Source supports rotation, call DTWAIN_IsRotationSupported.

 

For languages that have difficulties with DTWAIN_FLOAT parameters, the alternate function that can be used as a replacement for DTWAIN_GetRotation is DTWAIN_GetRotationStriing.

 

TWAIN State Transitions

The Source must be in State 4. or higher

 

Prerequisite Function Call(s)

DTWAIN_SysInitialize.

DTWAIN Source Selection Function