ICAP_AUTOMATICLENGTHDETECTION

Description

Controls the automatic detection of the length of a document, this is intended for use with an Automatic Document Feeder.

Application

If this capability is present, but does not support TWQC_SET when MSG_QUERYSUPPORT is called, then it indicates the fixed behavior of the Source (always TRUE or always FALSE).

If this capability reports TWQC_SET, then the Application can control the automatic detection of the length of a document.

If ICAP_AUTOMATICBORDERDETECTION (which detects width and length) is set to TRUE, then this capability is ignored.

Source

Values

If set to TRUE, the Source automatically crops the height of the image to the length of the document.

If set to FALSE (and assuming ICAP_AUTOMATICBORDERDETECTION is FALSE), the Source returns the full height specified by ICAP_FRAME or DAT_IMAGELAYOUT, regardless of the actual height of the captured document (for instance, a check in an A4 size area).

Type: TW_BOOL

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

After MSG_RESET/MSG_RESETALL: TRUE if DAT_IMAGEINFO values in State 6 are identical to the DAT_IMAGEINFO values after TWRC_XFERDONE, otherwise FALSE

Allowed Values: TRUE or FALSE

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 2.1

Related

ICAP_AUTOMATICBORDERDETECTION ICAP_FRAMES ICAP_SUPPORTEDSIZES