Hand Held Products 4X00 manual OemSetDecodeAttemptLimit, OemSetDecodeCenteringWindow

Page 58

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.

2 - 44

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

Image 58
Contents User’s Guide Disclaimer Table of Contents Page Symbology Identifiers Page Introduction Features of the 4X00 Series Image Engine API Library Summary Page Page Data Type Definitions Tchar Page OemAcquireImage OemAimerOnOemDisableSymbology OemDefaultSymbologyOemConnect OemEnableSymbologyAll OemDisableSymbologyAllOemEnableSymbology OemDisconnectOemGetDecodeAttemptLimit OemGetAPIRevisionOemGetDecodeCenteringWindow OemGetDecoderRevision OemGetDecodeModeOemGetDecodeTime Resultt oemGetErrorMessage OemGetErrorMessageOemGetExposureSettings Resultt oemGetExposureSettingsOemGetImage Resultt oemGetImagePrototype Resultt oemGetImageData OemGetImageDataOemGetImagerInfo Resultt oemGetImagerInfoResultt oemGetImagerProperties OemGetImagerPropertiesPnCols PImgPropResultt oemGetLastImage OemGetLastImageOemGetLastImageExt Resultt oemGetLastImageExtResultt oemGetLastImageSize OemGetLastImageSizeOemGetLeaveLightsOn Resultt oemGetLeaveLightsOnOemGetLinearRange OemGetPrintWeightOemGetMaxMessageChars OemGetScanDriverRevision OemGetSetupAllOemGetSearchTimeLimit OemGetSetupAztec OemGetSetupAusPostOemGetSetupBPO Resultt oemGetSetupCanPost OemGetSetupCanPostOemGetSetupChinaPost Resultt oemGetSetupChinaPostResultt oemGetSetupCodabar OemGetSetupCodabarOemGetSetupCodablock Resultt oemGetSetupCodablockOemGetSetupCode11 Resultt oemGetSetupCode11Resultt oemGetSetupCode128 OemGetSetupCode128OemGetSetupCode16K Resultt oemGetSetupCode16KResultt oemGetSetupCode32 OemGetSetupCode32OemGetSetupCode39 Resultt oemGetSetupCode39PbFullAscii OemGetSetupCode49Resultt oemGetSetupCode49 PbAppendResultt oemGetSetupCode93 OemGetSetupCode93OemGetSetupComposite Resultt oemGetSetupCompositeResultt oemGetSetupCompositeEx OemGetSetupCompositeExPbCompositeOnUpcEan Resultt oemGetSetupCouponCode OemGetSetupCouponCodeOemGetSetupDataMatrix Resultt oemGetSetupDataMatrixResultt oemGetSetupDutchPost OemGetSetupDutchPostOemGetSetupEAN8 Resultt oemGetSetupEAN8OemGetSetupEAN13 OemGetSetupIATA25 Resultt oemGetSetupIATA25Prototype Resultt oemGetSetupImager OemGetSetupImagerOemGetSetupInt25 Resultt oemGetSetupInt25OemGetSetupJapost OemGetSetupISBTOemGetSetupKoreanPost Resultt oemGetSetupMaxicode OemGetSetupMaxicodePCarrierMsgOnly Resultt oemGetSetupMesa OemGetSetupMesaP9MSEnabled Resultt oemGetSetupMSI OemGetSetupMSIPMinLength PMaxLength Resultt oemGetSetupMx25 OemGetSetupMx25OemGetSetupOCR Resultt oemGetSetupOCRPszGroupH PszGroupGPszCheckChar Resultt oemGetSetupPlanet OemGetSetupPlanetOemGetSetupPlessey Resultt oemGetSetupPlesseyResultt oemGetSetupPosiCode OemGetSetupPosiCodePLimited Resultt oemGetSetupPostnet OemGetSetupPostnetOemGetSetupQR Resultt oemGetSetupQRResultt oemGetSetupRSS OemGetSetupRSSOemGetSetupStrt25 Resultt oemGetSetupStrt25Resultt oemGetSetupTelepen OemGetSetupTelepenOemGetSetupTLC39 Resultt oemGetSetupTLC39Resultt oemGetSetupTrioptic OemGetSetupTriopticOemGetSetupUPCA Resultt oemGetSetupUPCAOemGetSetupUPCE Resultt oemGetSetupUPCEOemGetVideoReverse PE0EnabledPE1Enabled PbExpandVersionEOemImageStreamStart OemImageStreamInitOemImageStreamRead OemLeaveLightsOn OemPowerOffImagerOemImageStreamStop OemLightsOnOemSetDecodeCenteringWindow Resultt oemPowerOffImagerOemSetDecodeAttemptLimit Resultt oemSetDecodeAttemptLimitOemSetDecodeMode OemSetExposureSettingsOemSetExposureMode OemSetScanningLightsMode OemSetPrintWeightOemSetLinearRange Resultt oemSetLinearRangeOemSetupChinaPost OemSetupAztecOemSetSearchTimeLimit Resultt oemSetupCodabar OemSetupCodabarOemSetupCodablock Resultt oemSetupCodablockResultt oemSetupCode11 OemSetupCode11OemSetupCode128 Resultt oemSetupCode128Resultt oemSetupCode16K OemSetupCode16KOemSetupCode39 Resultt oemSetupCode39BFullAscii OemSetupCode49Resultt oemSetupCode49 BAppendOemSetupComposite OemSetupCode93OemSetupCompositeEx Resultt oemSetupDataMatrix OemSetupDataMatrixOemSetupEAN8 Resultt oemSetupEAN8Resultt oemSetupEAN13 OemSetupEAN13BAddendaReq Resultt oemSetupIATA25 OemSetupIATA25OemSetupInt25 Resultt oemSetupInt25Resultt oemSetupKoreanPost OemSetupKoreanPostOemSetupMaxicode Resultt oemSetupMaxicodeOemSetupMesa Resultt oemSetupMesaResultt oemSetupMSI OemSetupMSIOemSetupMx25 Resultt oemSetupMx25NFont OemSetupOCRResultt oemSetupOCR PszTemplateResultt oemSetupPlanet OemSetupPlanetOemSetupPlessey Resultt oemSetupPlesseyOemSetupPostnet OemSetupPosiCodeOemSetupQR Resultt oemSetupRSS OemSetupRSSOemSetupStrt25 Resultt oemSetupStrt25Resultt oemSetupTelepen OemSetupTelepenOemSetupUPCA Resultt oemSetupUPCAResultt oemSetupUPCE OemSetupUPCEBXmitNumSys OemStartIntellImgXfer BEnabledOemSetVideoReverse BExpandVersionEResultt oemStartIntellImgXfer OemWaitForDecode Resultt oemWaitForDecodeOemWaitForDecodeRaw Resultt oemWaitForDecodeRawOemWaitMultipleDecode Resultt oemWaitMultipleDecodeFpContinueCallBack OemWaitMultipleDecodeRawFpMultiReadCallBack Resultt oemWaitMultipleDecodeRawSymbology Identifiers Function Result Values Mail eutechsupport@handheld.com Mail latechsupport@handheld.comMail aptechsupport@handheld.com Imageteam 4X00 Series Software Development Kit SDK Page Hand Held Products, Inc