This property sets the orientation of the paper. This property is only enabled when using a custom-built user interface (UiMode=2).
imagekitcontrolname.GetScan().SetOrientation(long Val)
* ImageKit10ALib refers to the ANSI version, ImageKit10Lib refers to the Unicode version.
Property Value
| Value | Explanation |
|---|---|
| 0 | 0 degrees (portrait orientation). Default |
| 1 | 90 degrees |
| 2 | 180 degrees |
| 3 | 270 degrees (landscape orientation) |
| 1000 | Text orientation detection or automatic rotation |
*Rotation is counter-clockwise.
The following constants can be used: (ikScanRotate0 = 0, ikScanRotate90 = 1, ikScanRotate180 = 2, ikScanRotate270 = 3), (ikScanTextOrientationRecognition = 1000)
Explanation
The Orientation property sets the orientation of the paper. The default value is 0 (portrait orientation). This property allows you to rotate the scan output of a page placed on the document plate or change the orientation of pages scanned from an ADF. This property is enabled when the UiMode property is 2 (ikScanNONUI). The Orientation property is disabled for digital cameras and scanners that do not support this function. The possible setting values supported by a scan device can be retrieved using the GetCapEnum or the GetCapEnumVariant method.
When the Orientation property is set to 1000 (ikScanTextOrientationRecognition), the orientation of the text contained in the document is recognized and the scan output is rotated in 90 degree increments to "correct" the text orientation. Canon DR scan drivers use "text orientation recognition". Panasonic scan drivers use "document orientation adjustment". Scan drivers that support TWAIN specification's "automatic rotation" also use the value of 1000 (ikScanTextOrientationRecognition).
To check whether or not the scan driver supports 1000 (ikScanTextOrientationRecognition), use the IsCapSupported method or the IsCapSupportedVariant method.
With a scan driver that supports 1000 (ikScanTextOrientationRecognition), if the output is not appropriate to the ikScanTextOrientationRecognition settings, please set the paper to portrait orientation.
Setting this value
This value can be set at runtime.
Retrieving this value
This value can be retrieved at runtime.
[Differences from the ImageKit7 ActiveX]
Text orientation recognition or automatic rotation was added in the Ik8.