DTWAIN_SetRotation

Top  Previous  Next

The DTWAIN_SetRotation function sets the current rotation value for the Source.

 

DTWAIN_BOOL DTWAIN_SetRotation (

DTWAIN_SOURCE

Source,

DTWAIN_FLOAT

Rotation );

 

Parameters

Source

An open TWAIN Source.

 

Resolution

The rotation value to set the Source.

 

Return Values

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

 

Comments

The DTWAIN_SetRotation function sets the current rotation value for the  Source, Source.  The Rotation argument denotes the rotation value of the acquired image.  Note that some Sources do not support a  rotation setting, so the return value for DTWAIN_SetRotation will always be FALSE.  To test if a Source supports setting the rotation, call DTWAIN_IsRotationSupported..

 

If the rotation value is out of range of the Source, DTWAIN will choose the closest rotation value that the Source regards as valid.  The rotation is the rotation angle between -360 and +360 degrees for the images that will be acquired by the TWAIN device.

 

To get the current rotation value, call DTWAIN_GetRotation

 

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

 

 

TWAIN State Transitions

The Source must be in State 4. or higher

 

Prerequisite Function Call(s)

DTWAIN_SysInitialize

 

DTWAIN Source Selection Function