ICAP_ORIENTATION

Featured Clients

Sectors: FinanceInformation TechnoloyGovernmentHealthcareIndustriesEducation(show all)

TWAIN Capability: ICAP_ORIENTATION

ICAP_ORIENTATION

Description

Defines which edge of the “paper” the image’s “top” is aligned with. This information is used to adjust the frames to match the scanning orientation of the paper. For instance, if an ICAP_SUPPORTEDSIZE of TWSS_ISOA4 has been negotiated, and ICAP_ORIENTATION is set to TWOR_LANDSCAPE, then the Source must rotate the frame it downloads to the scanner to reflect the orientation of the paper.

ICAP_ORIENTATION affects the values reported by ICAP_FRAMES when using ICAP_SUPPORTEDSIZES.

ICAP_ORIENTATION is ignored when set using ICAP_FRAMES or DAT_IMAGELAYOUT.

The upper-left of the image is defined as the location where both the primary and secondary scans originate. (The X axis is the primary scan direction and the Y axis is the secondary scan direction.) For a flatbed scanner, the light bar moves in the secondary scan direction. For a handheld scanner, the scanner is drug in the secondary scan direction. For a digital camera, the secondary direction is the vertical axis when the viewed image is considered upright.

Application

If one pivots the image about its center, then orienting the image in TWOR_LANDSCAPE has the effect of rotating the original image 90 degrees to the “left.” TWOR_PORTRAIT mode does not rotate the image. The image may be oriented along any of the four axes located 90 degrees from the unrotated image. Note that:

TWOR_ROT TWOR_PORTRAIT and TWOR_ROT TWOR_LANDSCAPE.

Source

Values

The Source is responsible for rotating the image if it allows this capability to be set.

Type: TW_UINT

Value after MSG_OPENDS: (may be remembered from a previous session)

After MSG_RESET/MSG_RESETALL: TWOR_PORTRAIT

Allowed Values: TWOR_ROT TWOR_ROT TWOR_ROT TWOR_ROT

TWOR_PORTRAIT equals TWOR_ROT TWOR_LANDSCAPE equals TWOR_ROT

Containers

MSG_GET TW_ONEVALUE TW_ENUMERATION

MSG_GETCURRENT TW_ONEVALUE

MSG_GETDEFAULT TW_ONEVALUE

MSG_SET TW_ONEVALUE

MSG_SETCONSTRAINT TW_ONEVALUE

TW_ENUMERATION

MSG_RESET TW_ONEVALUE

MSG_QUERYSUPPORT TW_ONEVALUE

Required By

None

TWAIN Version Introduced

Version 1.0

Related

ICAP_AUTOSIZE ICAP_MIRROR ICAP_ROTATION

TWAIN Notice

Where would you like to scan from? Scan in Web Apps Scan in Java Scan in .NET