CAP_CAMERAORDER

Description

This capability selects the order of output for Single Document Multiple Image (SDMI) mode based on an array of pixel types; it does not constrain the allowed pixel types.

For example, if the scanner is set up to deliver color and bitonal documents on the top (front) camera, then an array of {TWPT_RGB, TWPT_BW} will deliver first the color image, then the bitonal image, while an array of {TWPT_BW, TWPT_RGB} will deliver first the bitonal image, then the color image.

Application

Some sources support independent ordering of color, grayscale and bitonal, while other sources may link color and grayscale together. This can be detected by setting CAP_CAMERAORDER to all of the available ICAP_PIXELTYPE values {ex: TWPT_RGB, TWPT_GRAY, TWPT_BW} followed by a MSG_GET to examine the result. In this example a source that supports full, independent control will return back exactly the same list it was set to, while a source that links pixel types together will return a reduced list, such as {TWPT_RGB, TWPT_BW}.

Source

Values

Camera ordering only applies if CAP_CAMERAENABLED is set for more than one pixel type on the same camera, putting the scanner into Single Document Multiple Images mode. DAT_FILESYSTEM is required to perform the proper addressing. DAT_FILESYSTEM is used to address each camera.

The setting applies to both the top (front) and the bottom (rear), it is not allowed to have one ordering for the top and another for the bottom.

Type: TW_UINT

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

After MSG_RESET/MSG_RESETALL: (selected by the data source writer)

Allowed Values: All applicable ICAP_PIXELTYPE values

Containers

MSG_GET TW_ARRAY

MSG_GETCURRENT TW_ARRAY

MSG_GETDEFAULT TW_ARRAY

MSG_SET TW_ONEVALUE TW_ARRAY

MSG_SETCONSTRAINT TW_ONEVALUE

TW_ARRAY

MSG_RESET TW_ARRAY

MSG_QUERYSUPPORT TW_ONEVALUE

Required By

None

TWAIN Version Introduced

Version 2.0

Related

CAP_CAMERAENABLED