ICAP_IMAGEMERGE

Featured Clients

Sectors: FinanceInformation TechnoloyGovernmentHealthcareIndustriesEducation(show all)

TWAIN Capability: ICAP_IMAGEMERGE

ICAP_IMAGEMERGE

Description

Merges the front and rear image of a document in one of four orientations: front on the top, front on the bottom, front on the left or front on the right.

Application

The front and rear have the same settings. It is a customization for a source to allow different settings, for instance a front of TWPT_RGB and a rear of TWPT_BW.

The merged image can be found at an origin of (0, total-image-height / 2) or (total-image-width, 0), depending on the value of this capability.

Use the TWEI_IMAGEMERGED value with DAT_EXTIMAGEINFO to determine if an image is the result of a merge.

Source

This capability only has meaning when scanning duplex.

Rear or Front

Front or Rear

For TWIM_FRONTONTOP and TWIM_FRONTONBOTTOM the final image is twice the pixel height of the larger of the two images. The top image has its origin at the upper left hand corner. The bottom image has its origin on the left but down (total-image-height / 2) pixels.

Rear or Front

Front or Rear

For TWIM_FRONTONLEFT and TWIM_FRONTONRIGHT the final image is twice the pixel width of the larger of the two images. The left image has its origin at the upper left hand corner. The right image has its origin on the top but left (total-image-width / 2) pixels.

Values

The source chooses how many differences it wants to support between the front and the rear. The only one it is obligated to deal with is differences in the width and height. In both cases the larger value must be selected, and the extra space in the smaller image filled in with some color.

If the source cannot negotiate this capability because of a difference in the front and rear settings, it returns TWCC_CAPSEQERROR.

Type: TW_UINT

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

After MSG_RESET/MSG_RESETALL: TWIM_NONE

Allowed Values: TWIM_NONE TWIM_FRONTONTOP TWIM_FRONTONBOTTOM TWIM_FRONTONLEFT TWIM_FRONTONRIGHT

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

CAP_DUPLEXENABLED ICAP_IMAGEMERGEHEIGHTTHRESHOLD

TWAIN Notice

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