This property sets the angle of rotation for the scanned image. This property is only enabled when using a custom-built user interface (UiMode=2).
Property Value
-360 to 360 (in degrees)
Default value is 0
Explanation
The Rotation property sets the angle of rotation for the scanned image. The default value is 0. Negative numbers rotate the image counter clockwise by that number of degress, positive numbers rotate the image clockwise.
The Rotation property is enabled when the UiMode property is set to 2 (ikScanNONUI). Although the Orientation property is similiar to this property, when the Orientation property can only be set to 0(ikScanRotate0), then use the Rotation property instead. There are scan drivers that support both Orientation and Rotation, others that depending on the value of one of these properties will only rotate by a set number of degrees, and some scan drivers that use only Rotation and ignore Orientation. Because of this, it is recommended that when setting Rotation property values to something other than 0, then set the Orientation property to 0(ikScanRotate0). Furthermore, when the Orientation property is set to 1000(ikScanTextOrientationRecognition) or when a digital camera is used or if Rotation is not supported, this property will be ignored.
To check whether the scan driver support rotation use the GetCapEnum or GetCapEnumVariant methods.
Setting this value
This value can be set at runtime.
Retrieving this value
This value cannot be retrieved.