This property sets the orientation of the paper. This property is only enabled when using a custom-built user interface.
[TVIkScanOrientation Type]
Unit
ImageKit
type
TVIkScanOrientation = (vikScanRotate0
= 0, vikScanRotate90 = 1, vikScanRotate180 = 2, vikScanRotate270 =
3, vikScanTextOrientationRecognition = 1000);
Property Value
| Value | Explanation |
|---|---|
| vikScanRotate0 | 0 degrees (portrait orientation). Default value |
| vikScanRotate90 | 90 degrees |
| vikScanRotate180 | 180 degrees |
| vikScanRotate270 | 270 degrees (landscape orientation) |
| vikScanTextOrientationRecognition | Text orientation detection or automatic rotation |
*Rotation is counter-clockwise.
Explanation
The Orientation property sets the orientation of the paper. The default value is vikScanRotate0 (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 vikScanNONUI. 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 GetCapEnumToFloat method.
When the Orientation property is set to vikScanTextOrientationRecognition, 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 vikScanTextOrientationRecognition.
To check whether or not the scan driver supports vikScanTextOrientationRecognition, use the IsCapSupported method.
With a scan driver that supports vikScanTextOrientationRecognition, if the output is not appropriate to the vikScanTextOrientationRecognition 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 between the ImageKit7/8/9/10
In VCL the constants contain a "v". In ActiveX, the constants are: ikScanRotate0, ikScanRotate90, ikScanRotate180, ikScanRotate270, ikScanTextOrientationRecognition