Oemsetdecodeattemptlimit, Oemsetdecodecenteringwindow – Hand Held Products 4X00 User Manual

Page 58

Advertising
background image

2 - 44

IMAGETEAM™ 4X00 Series Software Development Kit (SDK) User’s Guide

This function allows the application to fully power down the imager for additional power control. This gives additional power
control to shutdown/resume (normally the only time the sensor fully powers off), but should be balanced since there are time
penalties associated with powering back up.

Result_t oemPowerOffImager(

void
)

Return Values

RESULT_SUCCESS
RESULT_ERR_UNSUPPORTED

Parameters

None.

oemSetDecodeAttemptLimit

This function is used to set the decode attempt maximum time limit. The limit, specified in milliseconds, is the maximum amount
of time the decoder may use to attempt a decode on the current image.

Result_t

oemSetDecodeAttemptLimit (
SetupType_t SetupType,
WORD nLimit
)

Return Values

RESULT_SUCCESS
RESULT_ERR_UNSUPPORTED
RESULT_ERR_PARAMETER

Parameters

Setup Type

SETUP_TYPE_CURRENT for current settings, or SETUP_TYPE_DEFAULT for default settings.

nLimit

The maximum amount of time the decoder may use to attempt a decode on the current image. Valid range for nLimit
is 1-10,000. A value of zero indicates no limit. The default value is 0.

oemSetDecodeCenteringWindow

This function allows the caller to Enable/Setup decode centering mode. In this mode, a decode call is only successful if the area
bounding the decoded symbol intersects a caller-defined rectangle located about the center of the captured image.

Note: This function allows the engine to discriminate symbols that are located physically close to each other so only one symbol

is captured during decode. Only the symbol intersecting the defined rectangle is returned.

Result_t

oemSetDecodeCenteringWindow (
BOOL bEnable,
RECT *pIntersectRect
)

Return Values

RESULT_SUCCESS
RESULT_ERR_PARAMETER

Parameters

bEnable

If TRUE, the centering is turned on; otherwise the centering is turned off.

pIntersectRect

Rectangular image region of which at least part of the decoded symbol must overlap to be considered a valid decode.

Advertising