Document Title Here
AET65 API
Version 1.0
idvation GmbH
Otto-Hesse-Straße 19 / T5
Phone +49 6151 9926567
D-64293 Darmstadt
Fax +49 6151 3689296
www.idvation.com
Page 56 of 84
Page 56 of 84
6.5. Key Constants for ABS_PROFILE_DATA (ABS_PKEY_xxxx)
Constants ABS_PKEY_xxxx are possible values for member Key of:
ABS_PKEY_WAIT_FOR_ACCEPTABLE 1
Disables default one-attempt approach of ABSRawGrab.
When set to zero (default), ABSRawGrab lets the user swipe only once. If the quality checks are
unsatisfied and thus no image is retrieved, the function still returns ABS_STATUS_OK and NULL is
passed through the output parameter ppImage.
When set to non-zero, the grab operation asks for additional swipes until the swipe is good enough to
pass the quality checks.
Note that when quality checks are disabled (i.e. both ABS_PKEY_SCAN_QUALITY_QUERY and
ABS_PKEY_IMAGE_QUALITY_QUERY are set to non-zero), this flag has no effect because any
swipe is then considered as acceptable.
ABS_PKEY_SCAN_QUALITY_QUERY 2
Sets scan quality check mode.
When set to non-zero (default), scanning quality problems are ignored during the swipe and thus they
are not sent to callback. You can still retrieve some information about scan quality in form of
ABS_SWIPE_INFO structure.
When set to zero, scanning quality problems are sent to the call back in form of
ABS_MSG_QUALITY_xxxx messages.
ABS_PKEY_IMAGE_QUALITY_QUERY 3
Sets image quality check mode.
When set to non-zero (default), image quality problems are ignored during the swipe and thus they
are not sent to callback. You can still retrieve some information about scan quality in form of
ABS_SWIPE_INFO structure.
When set to zero, image quality problems are sent to the call back in form of
ABS_MSG_QUALITY_xxxx messages.
ABS_PKEY_ALLOW_HW_SLEEP 4
Enables HW sleep mode.
When set to non-zero (default), HW sleep of the device is enabled during the raw grab operation.
When set to zero, the sleep is disabled.
Note that SONLY ignores this profile key, even in strict mode because SONLY uses its own, more
complex policy, to decide when to use the sleep mode.
ABS_PKEY_IMAGE_FORMAT 5
Specifies desired image format.
Value can be any ABS_PVAL_IFMT_xxxx constant. Note that various devices support different image
formats.
Using
unsupported
image
format
causes
ABSRawGrab
to
fail
with
ABS_STAUS_NOT_SUPPORTED, regardless whether strict mode is used or not.
