English dropdown-ico

Hand Held Products 4X00 manual

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90

Go to page of

Similar user manuals

A good user manual

The rules should oblige the seller to give the purchaser an operating instrucion of Hand Held Products 4X00, along with an item. The lack of an instruction or false information given to customer shall constitute grounds to apply for a complaint because of nonconformity of goods with the contract. In accordance with the law, a customer can receive an instruction in non-paper form; lately graphic and electronic forms of the manuals, as well as instructional videos have been majorly used. A necessary precondition for this is the unmistakable, legible character of an instruction.

What is an instruction?

The term originates from the Latin word „instructio”, which means organizing. Therefore, in an instruction of Hand Held Products 4X00 one could find a process description. An instruction's purpose is to teach, to ease the start-up and an item's use or performance of certain activities. An instruction is a compilation of information about an item/a service, it is a clue.

Unfortunately, only a few customers devote their time to read an instruction of Hand Held Products 4X00. A good user manual introduces us to a number of additional functionalities of the purchased item, and also helps us to avoid the formation of most of the defects.

What should a perfect user manual contain?

First and foremost, an user manual of Hand Held Products 4X00 should contain:
- informations concerning technical data of Hand Held Products 4X00
- name of the manufacturer and a year of construction of the Hand Held Products 4X00 item
- rules of operation, control and maintenance of the Hand Held Products 4X00 item
- safety signs and mark certificates which confirm compatibility with appropriate standards

Why don't we read the manuals?

Usually it results from the lack of time and certainty about functionalities of purchased items. Unfortunately, networking and start-up of Hand Held Products 4X00 alone are not enough. An instruction contains a number of clues concerning respective functionalities, safety rules, maintenance methods (what means should be used), eventual defects of Hand Held Products 4X00, and methods of problem resolution. Eventually, when one still can't find the answer to his problems, he will be directed to the Hand Held Products service. Lately animated manuals and instructional videos are quite popular among customers. These kinds of user manuals are effective; they assure that a customer will familiarize himself with the whole material, and won't skip complicated, technical information of Hand Held Products 4X00.

Why one should read the manuals?

It is mostly in the manuals where we will find the details concerning construction and possibility of the Hand Held Products 4X00 item, and its use of respective accessory, as well as information concerning all the functions and facilities.

After a successful purchase of an item one should find a moment and get to know with every part of an instruction. Currently the manuals are carefully prearranged and translated, so they could be fully understood by its users. The manuals will serve as an informational aid.

Table of contents for the manual

  • Page 1

    IMAGETEAM ™ 4X00 Series For Adaptus Imaging Technology Imagers: IT4000, IT4100, and IT4300 Software Development Kit (SDK) User’s Guide[...]

  • Page 2

    Disclaimer Hand Held Products, Inc. d/b/a Hand Held Products (“Hand Held Products”) reserves the right to make changes in specifications and other information contained in this do cument without prior notice, and the reader should in al l cases consult Hand Held Products to determine whether any such changes have been made . The information in [...]

  • Page 3

    i Chapter 1 - Introduction Design Overview ........ ......................................................................................................................... 1-1 User Layer ..................................................................................................................... ................ 1-1 OEM API Layer ... ....[...]

  • Page 4

    ii oemGetSetupCode39 ............................................................................................................. .... 2-19 oemGetSetupCode49 ............................................................................................................. .... 2-20 oemGetSetupCode93 .....................................................[...]

  • Page 5

    iii oemSetupCode128 ............................................................................................................... ...... 2-49 oemSetupCode16K ............................................................................................................... ..... 2-50 oemSetupCode39 ....................................................[...]

  • Page 6

    iv[...]

  • Page 7

    IMAGETEAM™ 4X00 Series Software Development Kit (SDK) User’s Guide 1 - 1 1 Introduc tion This document is an overview of the stru cture of the IT4X00 Series OEM imaging soft ware provided by Hand Held Products. Detailed information that descri bes the Hand Held Products OEM Application Programming Interface is provided as a part of the 4X00 Ser[...]

  • Page 8

    1 - 2 IMAGETEAM™ 4X00 Series Software Development Kit (SDK) User’s Guide Features of the 4X00 Series The 4X00 Series consists of the following: • The API Definition and Documentation • API Libraries • Sample Code The 4X00 Series functions are defined on a hi gher level so they can be ea sily understood and integrat ed into your applicatio[...]

  • Page 9

    IMAGETEAM™ 4X00 Series Software Development Kit (SDK) User’s Guide 1 - 3 Image Engine API Library Summary The following is a summary of the API functions. The full de scription of each of function is found on the page noted. Core Function Summary Description Page oemAimerOn Turn on/off the engine's aiming LEDs 2-1 oemConnect Initialize con[...]

  • Page 10

    1 - 4 IMAGETEAM™ 4X00 Series Software Development Kit (SDK) User’s Guide oemGetSetupCodabar Gets the Codabar sym bology decoding options 2-16 oemGetSetupCodablock Gets the Codablock sy mbology decoding options 2-16 oemGetSetupCode11 Gets the Code 11 symbology decoding options 2-17 oemGetSetupCode128 Gets the Code 128 symb ology decoding options[...]

  • Page 11

    IMAGETEAM™ 4X00 Series Software Development Kit (SDK) User’s Guide 1 - 5 oemSetDecodeMode Sets the decoding mode of the engine 2-45 oemSetLinearRange Sets the size of the window used in the Advanced Linear decoding mode 2-46 oemSetPrintWeight Adjust the print weight or rela tive blackness that the decoder expects 2-46 oemSetSearchTimeLimit Sets[...]

  • Page 12

    1 - 6 IMAGETEAM™ 4X00 Series Software Development Kit (SDK) User’s Guide Data T ype Definitions Throughout this document the foll owing variable types are used. These data ty pes are defined in th e Oemdecodece.h header file. oemWaitForDecodeRaw The engine scans until a symbol is decoded, or a timeout is reached - decoded message is returned in[...]

  • Page 13

    IMAGETEAM™ 4X00 Series Software Development Kit (SDK) User’s Guide 1 - 7 Result_t Enumerated integer type that define s API function result values. See Function Result Values on page 3-2. ScanIlluminat_t Enumerated integer type that identifies possible illumination modes used during image acquisition. SetupType_t Enumerated integer type that id[...]

  • Page 14

    1 - 8 IMAGETEAM™ 4X00 Series Software Development Kit (SDK) User’s Guide[...]

  • Page 15

    IMAGETEAM™ 4X00 Series Software Development Kit (SDK) User’s Guide 2 - 1 2 API F unction D escriptions The following is an alphabetic listing of each API function with its complete descript ion and a prototype for each function. A ll API functions return a result co de of type Result_t. See Function Result Values on page 3-2 for a table of resu[...]

  • Page 16

    2 - 2 IMAGETEAM™ 4X00 Series Software Development Kit (SDK) User’s Guide Pa r a m e t e r s bEnable If TRUE, the aiming mechanism is turned on; ot herwise the aiming mechanism is turned off. oemConnect The application should call this function before any other API functions. Once an applic ation has connected to the engine, all other API functi[...]

  • Page 17

    IMAGETEAM™ 4X00 Series Software Development Kit (SDK) User’s Guide 2 - 3 oemDisableSymbologyAll This function disables all symbologies from decoding, including an y unknown symbologies. Result_t oemDisableSymbologyAll ( void ) Return V alues RESULT_SUCCESS Pa r a m e t e r s None. oemDisconnect This function terminates the connection wi th the [...]

  • Page 18

    2 - 4 IMAGETEAM™ 4X00 Series Software Development Kit (SDK) User’s Guide oemGetAPIRevision This function returns an ASCII string containing the API's current revision. Result_t oemGetAPIRevision ( TCHAR *pszRev ) Return V alues RESULT_SUCCESS always Pa r a m e t e r s pszRev Upon successful return, this null-terminate d string is filled in[...]

  • Page 19

    IMAGETEAM™ 4X00 Series Software Development Kit (SDK) User’s Guide 2 - 5 Pa r a m e t e r s SetupType SETUP_TYPE_CURRENT for current settings, or SETUP_TYPE_DEFAULT for default settings. PbEnabled Pointer to a BOOL which returns TRUE if ce ntering mode enabled or FALSE if it's not. oemGetDecodeMode This function retrieves the decoding mode[...]

  • Page 20

    2 - 6 IMAGETEAM™ 4X00 Series Software Development Kit (SDK) User’s Guide oemGetErrorMessage This function returns a string contai ning the description of the error corresponding to the nError parameter. Result_t oemGetErrorMessage ( TCHAR *pszErrorMsg, Result_t nError ) Return V alues RESULT_SUCCESS always Pa r a m e t e r s pszErrorMsg Upon su[...]

  • Page 21

    IMAGETEAM™ 4X00 Series Software Development Kit (SDK) User’s Guide 2 - 7 oemGetImage This function retrieves an image from the engine and stores it in memo ry pointed to by pImageBuffer. Result_t oemGetImage ( BYTE *pImageBuffer, DWORD *pdwSize, WORD nTop, WORD nLeft, WORD nRight, WORD nBottom, WORD nSkip, WORD nBits, FileFormat_t nFormat, WORD[...]

  • Page 22

    2 - 8 IMAGETEAM™ 4X00 Series Software Development Kit (SDK) User’s Guide nExposeAttempts The number of attempts the unit makes to ge t the image to the co rrect exposure level. nGap How close the white value of the image mu st be to the nWhiteValue for the image to be accepted. A value of 0 (zero) can be passed in to cause the unit to us e its [...]

  • Page 23

    IMAGETEAM™ 4X00 Series Software Development Kit (SDK) User’s Guide 2 - 9 Pa r a m e t e r s pnCols Upon successful return, this variable points to the number of column pixels in the Imager. pnRows Upon successful return, this variable points to the number of row pixels in the Imager. pnBits Upon successful return, this variabl e points to the n[...]

  • Page 24

    2 - 10 IMAGETEAM™ 4X00 Series Software Development Kit (SDK) User’s Guide oemGetLastImage This function is used to retrieve the last image acquired by the image engine. Result_t oemGetLastImage ( BYTE *pImageBuffer DWORD *pImageSize ) Return Values RESULT_SUCCESS RESULT_ERR_PARAMETER RESULT_ERR_NOIMAGE Parameters pImageBuffer Pointer to the use[...]

  • Page 25

    IMAGETEAM™ 4X00 Series Software Development Kit (SDK) User’s Guide 2 - 11 oemGetLastImageSize This function returns the number of rows, number of columns and size in bytes of t he last image returned by one of the other imaging functions: oemAcquireImage, oemGe tImage/oemGetImageData or oemImageStreamRead. Result_t oemGetLastImageSize ( WORD *p[...]

  • Page 26

    2 - 12 IMAGETEAM™ 4X00 Series Software Development Kit (SDK) User’s Guide oemGetLinearRange This function is used to get the size of the window used in th e Advanced Linear decoding mode. Result_t oemGetLinearRange ( SetupType_t SetupType, WORD *pnLinearRange ) Return V alues RESULT_SUCCESS RESULT_ERR_UNSUPPORTED Pa r a m e t e r s SetupType SE[...]

  • Page 27

    IMAGETEAM™ 4X00 Series Software Development Kit (SDK) User’s Guide 2 - 13 oemGetScanDriverRevision This function returns the revision of the scan driv er component that interfaces to the OEM API layer. Result_t oemGetScanDriverRevision( TCHAR *pszRev ) Return V alues RESULT_ERR_PARAMETER RESULT_ERR_UNSUPPORTED RESULT_ERR_SUCCESS Pa r a m e t e [...]

  • Page 28

    2 - 14 IMAGETEAM™ 4X00 Series Software Development Kit (SDK) User’s Guide oemGetSetupAusPost This function is used to get the Australian Postal Code symbology-specific options. Result_t oemGetSetupAusPost ( SetupType_t SetupType, BOOL *pEnabled ) Return V alues RESULT_SUCCESS RESULT_ERR_PARAMETER Pa r a m e t e r s SetupType SETUP_TYPE_CURRENT [...]

  • Page 29

    IMAGETEAM™ 4X00 Series Software Development Kit (SDK) User’s Guide 2 - 15 Return V alues RESULT_SUCCESS RESULT_ERR_PARAMETER Pa r a m e t e r s SetupType SETUP_TYPE_CURRENT for current settings, or SETUP_TYPE_DEFAULT for default settings. pEnabled Points to a BOOL variable that contains the enabled state of this symbology upon returning from th[...]

  • Page 30

    2 - 16 IMAGETEAM™ 4X00 Series Software Development Kit (SDK) User’s Guide oemGetSetupCodabar This function is used to get th e Codabar symbology-specific options. Result_t oemGetSetupCodabar ( SetupType_t SetupType, BOOL *pEnabled, WORD *pMinLength, WORD *pMaxLength BOOL *pbSSXmit, BOOL *pbCheckCharOn, BOOL *pbXmitCheckChar ) Return V alues RES[...]

  • Page 31

    IMAGETEAM™ 4X00 Series Software Development Kit (SDK) User’s Guide 2 - 17 Pa r a m e t e r s SetupType SETUP_TYPE_CURRENT for current settings, or SETUP_TYPE_DEFAULT for default settings. pEnabled Points to a BOOL variable that contains the enabled state of this symbology upon returning from the function. A TRUE means the symbology is enabled; [...]

  • Page 32

    2 - 18 IMAGETEAM™ 4X00 Series Software Development Kit (SDK) User’s Guide oemGetSetupCode128 This function is used to get the Code 128 symbology-specific options. Result_t oemGetSetupCode128 ( SetupType_t SetupType, BOOL *pEnabled, WORD *pMinLength, WORD *pMaxLength ) Return V alues RESULT_SUCCESS RESULT_ERR_PARAMETER Pa r a m e t e r s SetupTy[...]

  • Page 33

    IMAGETEAM™ 4X00 Series Software Development Kit (SDK) User’s Guide 2 - 19 oemGetSetupCode32 This function is used to get the Code 32 symbology specific options. Result_t oemGetSetupCode32 ( SetupType_t SetupType, BOOL *pEnabled, ) Return V alues RESULT_SUCCESS RESULT_ERR_PARAMETER Pa r a m e t e r s SetupType SETUP_TYPE_CURRENT for current sett[...]

  • Page 34

    2 - 20 IMAGETEAM™ 4X00 Series Software Development Kit (SDK) User’s Guide Pa r a m e t e r s SetupType SETUP_TYPE_CURRENT for current settings, or SETUP_TYPE_DEFAULT for default settings. pEnabled Points to a BOOL variable that contains the enabled state of this symbology upon returning from the function. A TRUE means the symbology is enabled; [...]

  • Page 35

    IMAGETEAM™ 4X00 Series Software Development Kit (SDK) User’s Guide 2 - 21 Pa r a m e t e r s SetupType SETUP_TYPE_CURRENT for current settings, or SETUP_TYPE_DEFAULT for default settings. pEnabled Points to a BOOL variable that contains the enabled state of this symbology upon returning from the function. A TRUE means the symbology is enabled; [...]

  • Page 36

    2 - 22 IMAGETEAM™ 4X00 Series Software Development Kit (SDK) User’s Guide Pa r a m e t e r s SetupType SETUP_TYPE_CURRENT for current settings, or SETUP_TYPE_DEFAULT for default settings. pEnabled Points to a BOOL variable that contains the enabled state of this symbology upon returning from the function. A TRUE means the symbology is enabled; [...]

  • Page 37

    IMAGETEAM™ 4X00 Series Software Development Kit (SDK) User’s Guide 2 - 23 oemGetSetupCouponCode This function is used to get the UPC-A with extended Coupon Code symbology specific options. Result_t oemGetSetupCouponCode ( SetupType_t SetupType, BOOL *pEnabled ) Return V alues RESULT_SUCCESS RESULT_ERR_PARAMETER Pa r a m e t e r s SetupType SETU[...]

  • Page 38

    2 - 24 IMAGETEAM™ 4X00 Series Software Development Kit (SDK) User’s Guide oemGetSetupDutchPost This function is used to get theKIX (N etherlands) Post symbology-specific options. Result_t oemGetSetupDutchPost ( SetupType_t SetupType, BOOL *pEnabled ) Return V alues RESULT_SUCCESS RESULT_ERR_PARAMETER Pa r a m e t e r s SetupType SETUP_TYPE_CURR[...]

  • Page 39

    IMAGETEAM™ 4X00 Series Software Development Kit (SDK) User’s Guide 2 - 25 Pa r a m e t e r s SetupType SETUP_TYPE_CURRENT for current settings, or SETUP_TYPE_DEFAULT for default settings. pEnabled Points to a BOOL variable that contains the enabled state of this symbology upon returning from the function. A TRUE means the symbology is enabled; [...]

  • Page 40

    2 - 26 IMAGETEAM™ 4X00 Series Software Development Kit (SDK) User’s Guide Pa r a m e t e r s SetupType SETUP_TYPE_CURRENT for current settings, or SETUP_TYPE_DEFAULT for default settings. pEnabled Points to a BOOL variable that contains the enabled state of this symbology upon returning from the function. A TRUE means the symbology is enabled; [...]

  • Page 41

    IMAGETEAM™ 4X00 Series Software Development Kit (SDK) User’s Guide 2 - 27 oemGetSetupImager This function gets the cu rrent Imager setup values. Prototype Result_t oemGetSetupImager ( SetupType_t SetupType, ImagerSetup_t *pImagerSetup ) Return V alues RESULT_SUCCESS Pa r a m e t e r s pImagerSetup Data structure that sets up the Imager. See oem[...]

  • Page 42

    2 - 28 IMAGETEAM™ 4X00 Series Software Development Kit (SDK) User’s Guide oemGetSetupISBT This function is used to get the ISBT 128 symbology-specific options. Result_t oemGetSetupISBT ( SetupType_t SetupType, BOOL *pEnabled ) Return V alues RESULT_SUCCESS RESULT_ERR_PARAMETER Pa r a m e t e r s SetupType SETUP_TYPE_CURRENT for current settings[...]

  • Page 43

    IMAGETEAM™ 4X00 Series Software Development Kit (SDK) User’s Guide 2 - 29 Pa r a m e t e r s SetupType SETUP_TYPE_CURRENT for current settings, or SETUP_TYPE_DEFAULT for default settings. pEnabled Points to a BOOL variable that contains the enabled state of this symbology upon returning from the function. A TRUE means the symbology is enabled; [...]

  • Page 44

    2 - 30 IMAGETEAM™ 4X00 Series Software Development Kit (SDK) User’s Guide oemGetSetupMesa This function is used to get the Azte c Mesa Code symbology-specific options. Result_t oemGetSetupMesa ( SetupType_t SetupType, BOOL *pUMSEnabled, BOOL *pEMSEnabled, BOOL *p3MSEnabled, BOOL *p1MSEnabled, BOOL *pIMSEnabled, BOOL *p9MSEnabled ) Return V alue[...]

  • Page 45

    IMAGETEAM™ 4X00 Series Software Development Kit (SDK) User’s Guide 2 - 31 Pa r a m e t e r s SetupType SETUP_TYPE_CURRENT for current settings, or SETUP_TYPE_DEFAULT for default settings. pEnabled Points to a BOOL variable that contains the enabled state of this symbology upon returning from the function. A TRUE means the symbology is enabled; [...]

  • Page 46

    2 - 32 IMAGETEAM™ 4X00 Series Software Development Kit (SDK) User’s Guide oemGetSetupMx25 This function is used to get the Matr ix 2 of 5 symbology specific options. Result_t oemGetSetupMx25 ( SetupType_t SetupType, BOOL *pEnabled, WORD *pMinLength, WORD *pMaxLength ) Return V alues RESULT_SUCCESS RESULT_ERR_PARAMETER Pa r a m e t e r s SetupTy[...]

  • Page 47

    IMAGETEAM™ 4X00 Series Software Development Kit (SDK) User’s Guide 2 - 33 Pa r a m e t e r s SetupType SETUP_TYPE_CURRENT for current settings, or SETUP_TYPE_DEFAULT for default settings. nFont This determines which OCR fonts (if any) are select ed for decoding. The following values are used: OCR_DISABLED OCR_A OCR_B OCR_MONEY OCR_MICR (current[...]

  • Page 48

    2 - 34 IMAGETEAM™ 4X00 Series Software Development Kit (SDK) User’s Guide Pa r a m e t e r s SetupType SETUP_TYPE_CURRENT for current settings, or SETUP_TYPE_DEFAULT for default settings. pEnabled Points to a BOOL variable that contains the enabled state of this symbology upon returning from the function. A TRUE means the symbology is enabled; [...]

  • Page 49

    IMAGETEAM™ 4X00 Series Software Development Kit (SDK) User’s Guide 2 - 35 Pa r a m e t e r s SetupType SETUP_TYPE_CURRENT for current settings, or SETUP_TYPE_DEFAULT for default settings. pEnabled Points to a BOOL variable that contains the enabled state of this symbology upon returning from the function. A TRUE means the symbology is enabled; [...]

  • Page 50

    2 - 36 IMAGETEAM™ 4X00 Series Software Development Kit (SDK) User’s Guide oemGetSetupPostnet This function is used to get th e Postnet symbology-specific options. Result_t oemGetSetupPostnet ( SetupType_t SetupType, BOOL *pEnabled, BOOL *bXmitCheckDigit ) Return V alues RESULT_SUCCESS RESULT_ERR_PARAMETER Pa r a m e t e r s SetupType SETUP_TYPE[...]

  • Page 51

    IMAGETEAM™ 4X00 Series Software Development Kit (SDK) User’s Guide 2 - 37 oemGetSetupRSS This function is used to get the RSS Expanded symbology-specific options. Result_t oemGetSetupRSS ( SetupType_t SetupType, BOOL *pEnabled, WORD *pMinLength, WORD *pMaxLength ) Return V alues RESULT_SUCCESS RESULT_ERR_PARAMETER Pa r a m e t e r s SetupType S[...]

  • Page 52

    2 - 38 IMAGETEAM™ 4X00 Series Software Development Kit (SDK) User’s Guide oemGetSetupTelepen This function is used to get the Telepen symbology specific options. Result_t oemGetSetupTelepen ( SetupType_t SetupType, BOOL *pEnabled, WORD *pMinLength, WORD *pMaxLength, BOOL *pOldStyle ) Return V alues RESULT_SUCCESS RESULT_ERR_PARAMETER Pa r a m e[...]

  • Page 53

    IMAGETEAM™ 4X00 Series Software Development Kit (SDK) User’s Guide 2 - 39 oemGetSetupTrioptic This function is used to get the Tri optic Code symbology specific options. Result_t oemGetSetupTrioptic ( SetupType_t SetupType, BOOL *pEnabled, ) Return V alues RESULT_SUCCESS RESULT_ERR_PARAMETER Pa r a m e t e r s SetupType SETUP_TYPE_CURRENT for c[...]

  • Page 54

    2 - 40 IMAGETEAM™ 4X00 Series Software Development Kit (SDK) User’s Guide Pa r a m e t e r s SetupType SETUP_TYPE_CURRENT for current settings, or SETUP_TYPE_DEFAULT for default settings. pEnabled Points to a BOOL variable that contains the enabled state of this symbology upon returning from the function. A TRUE means the symbology is enabled; [...]

  • Page 55

    IMAGETEAM™ 4X00 Series Software Development Kit (SDK) User’s Guide 2 - 41 Pa r a m e t e r s SetupType SETUP_TYPE_CURRENT for current settings, or SETUP_TYPE_DEFAULT for default settings. pE0Enabled Points to a BOOL variable that contains the enabled state of UPC-E0 symbology upon returning from the function. A TRUE means the symbology is enabl[...]

  • Page 56

    2 - 42 IMAGETEAM™ 4X00 Series Software Development Kit (SDK) User’s Guide oemImageStreamInit This function is used to intialize the imag e stream interface. The caller is allowed to specifiy the skip (subsample) value. Note: If nSkip is greater than 1, the resultin g image will be subsampled by nSkip. Result_t oemImageStreamInit ( WORD nSkip, R[...]

  • Page 57

    IMAGETEAM™ 4X00 Series Software Development Kit (SDK) User’s Guide 2 - 43 oemImageStreamStop This function causes the Image Engine to stop continous collecting of image s started by oemImageStreamInit() and oemImageStreamStart(). If this function is not called, the imager will continue to ac quire images (illumination will stay on) which causes[...]

  • Page 58

    2 - 44 IMAGETEAM™ 4X00 Series Software Development Kit (SDK) User’s Guide This function allows the applicat ion to fully power down the imag er 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 associate[...]

  • Page 59

    IMAGETEAM™ 4X00 Series Software Development Kit (SDK) User’s Guide 2 - 45 oemSetDecodeMode This function sets the de coding mode of the engine. Result_t oemSetDecodeMode ( SetupType_t SetupType, WORD nMode ) Return V alues RESULT_SUCCESS RESULT_ERR_PARAMETER RESULT_ERR_UNSUPPORTED Pa r a m e t e r s SetupType SETUP_TYPE_CURRENT for current sett[...]

  • Page 60

    2 - 46 IMAGETEAM™ 4X00 Series Software Development Kit (SDK) User’s Guide oemSetLinearRange This function sets the size of the window used in the Advanced Linear decoding mode. Result_t oemSetLinearRange ( SetupType_t SetupType, WORD nLinearRange ) Return V alues RESULT_SUCCESS RESULT_ERR_PARAMETER RESULT_ERR_UNSUPPORTED Pa r a m e t e r s Setu[...]

  • Page 61

    IMAGETEAM™ 4X00 Series Software Development Kit (SDK) User’s Guide 2 - 47 oemSetSearchTimeLimit This function is used to set the maximum time limit for the decoders se arch processing. The limit, specified in milliseconds, is the maximum amount of time the search process may use to look for poten tial labels in the current image. Result_t oemSe[...]

  • Page 62

    2 - 48 IMAGETEAM™ 4X00 Series Software Development Kit (SDK) User’s Guide Pa r a m e t e r s nMinLength The minimum length decoded Chi na Post message the engine should return. China Post messages smaller than this minimum length are not reported by th e engine. The minimum allowable valu e (as well as the default) is 4. nMaxLength The maximum [...]

  • Page 63

    IMAGETEAM™ 4X00 Series Software Development Kit (SDK) User’s Guide 2 - 49 Pa r a m e t e r s nMinLength The minimum length decoded Codablock me ssage the engine should return. Coda block messages smaller than this minimum length are not reported by th e engine. The minimum allowable valu e (as well as the default) is 0. nMaxLength The maximum l[...]

  • Page 64

    2 - 50 IMAGETEAM™ 4X00 Series Software Development Kit (SDK) User’s Guide oemSetupCode16K This function is used to set the Code 16K symbology-specific options. Result_t oemSetupCode16K ( WORD nMinLength, WORD nMaxLength ) Return V alues RESULT_SUCCESS RESULT_ERR_PARAMETER Pa r a m e t e r s nMinLength The minimum length decoded Code 16K message[...]

  • Page 65

    IMAGETEAM™ 4X00 Series Software Development Kit (SDK) User’s Guide 2 - 51 Pa r a m e t e r s bSSXmit Points to a BOOL variable that determines if the start a nd stop characters are returned in the data string after a successful Code 39 decode. If bSSXmit is TRUE, the start and stop characters are included. If FALSE, they are not included. The d[...]

  • Page 66

    2 - 52 IMAGETEAM™ 4X00 Series Software Development Kit (SDK) User’s Guide oemSetupCode93 This function is used to set the Code 93 symbology-specific options. Result_t oemSetupCode93 ( WORD nMinLength, WORD nMaxLength ) Return V alues RESULT_SUCCESS RESULT_ERR_PARAMETER Pa r a m e t e r s nMinLength The minimum length decoded Code 93 message the[...]

  • Page 67

    IMAGETEAM™ 4X00 Series Software Development Kit (SDK) User’s Guide 2 - 53 Pa r a m e t e r s nMinLength The minimum length decoded EANoUCC Composite message the engine should return. EANoUCC Composite messages smaller than this minimum length are not reported by the engine. T he minimum allowable value (as well as the default) is 1. nMaxLength [...]

  • Page 68

    2 - 54 IMAGETEAM™ 4X00 Series Software Development Kit (SDK) User’s Guide Pa r a m e t e r s bXmitCheckChar Points to a BOOL variable that determines if the engine will return the check character as part of the data string after a successful decode. If TRUE, the engine re turns the check character. If FALSE, the check character is not returned.[...]

  • Page 69

    IMAGETEAM™ 4X00 Series Software Development Kit (SDK) User’s Guide 2 - 55 oemSetupIATA25 This function is used to set the Straight 2 of 5 IATA symbology-specific options. Result_t oemSetupIATA25 ( WORD nMinLength, WORD nMaxLength ) Return V alues RESULT_SUCCESS RESULT_ERR_PARAMETER Pa r a m e t e r s nMinLength The minimum length decoded IATA 2[...]

  • Page 70

    2 - 56 IMAGETEAM™ 4X00 Series Software Development Kit (SDK) User’s Guide oemSetupKoreanPost This function is used to set the Ko rean Post symbology-specific options. Result_t oemSetupKoreanPost ( WORD nMinLength, WORD nMaxLength ) Return V alues RESULT_SUCCESS RESULT_ERR_PARAMETER Pa r a m e t e r s nMinLength The minimum length decoded Korean[...]

  • Page 71

    IMAGETEAM™ 4X00 Series Software Development Kit (SDK) User’s Guide 2 - 57 oemSetupMesa This function is used to set the Azte c Mesa Code symbology-specific options. Note: The minimum and maximu m parameters are set using oemSetupAztec (page 2-47). Result_t oemSetupMesa ( BOOL *pUMSEnabled, BOOL *pEMSEnabled, BOOL *p3MSEnabled, BOOL *p1MSEnabled[...]

  • Page 72

    2 - 58 IMAGETEAM™ 4X00 Series Software Development Kit (SDK) User’s Guide oemSetupMSI This function is used to set th e MSI symbology-specific options. Result_t oemSetupMSI ( WORD nMinLength, WORD nMaxLength, BOOL bXmitCheckChar ) Return V alues RESULT_SUCCESS RESULT_ERR_PARAMETER Pa r a m e t e r s nMinLength The minimum length decoded MSI mes[...]

  • Page 73

    IMAGETEAM™ 4X00 Series Software Development Kit (SDK) User’s Guide 2 - 59 oemSetupOCR This function is used to set the Optical Character Recognition (OCR) decoding options. OCR char acter recognition is less secur e than reading bar codes. Misreads may oc cur if a check character is not used. Result_t oemSetupOCR ( OCRMode_t nFont, TCHAR *pszTe[...]

  • Page 74

    2 - 60 IMAGETEAM™ 4X00 Series Software Development Kit (SDK) User’s Guide oemSetupPDF417 This function is used to set th e PDF417 symbology-specific options. Result_t oemSetupPDF417( WORD nMinLength, WORD nMaxLength ) Return V alues RESULT_SUCCESS RESULT_ERR_PARAMETER Pa r a m e t e r s nMinLength The minimum length decoded PDF417 message the e[...]

  • Page 75

    IMAGETEAM™ 4X00 Series Software Development Kit (SDK) User’s Guide 2 - 61 oemSetupPosiCode This function is used to set the PosiCode symbology-specific options. Result_t oemSetupPosiCode ( WORD nMinLength, WORD nMaxLength, WORD nLimited ) Return V alues RESULT_SUCCESS RESULT_ERR_PARAMETER Pa r a m e t e r s nMinLength The minimum length decoded[...]

  • Page 76

    2 - 62 IMAGETEAM™ 4X00 Series Software Development Kit (SDK) User’s Guide Pa r a m e t e r s nMinLength The minimum length decoded QR Code message the engine should return. QR Code me ssages smaller than this minimum length are not reported by th e engine. The minimum allowable valu e (as well as the default) is 1. nMaxLength The maximum length[...]

  • Page 77

    IMAGETEAM™ 4X00 Series Software Development Kit (SDK) User’s Guide 2 - 63 oemSetupTelepen This function is used to set th e Telepen symbology-specific options. Result_t oemSetupTelepen ( WORD nMinLength, WORD nMaxLength, BOOL bOldStyle ) Return V alues RESULT_SUCCESS RESULT_ERR_PARAMETER Pa r a m e t e r s nMinLength The minimum length decoded [...]

  • Page 78

    2 - 64 IMAGETEAM™ 4X00 Series Software Development Kit (SDK) User’s Guide Pa r a m e t e r s bXmitCheckDigit Points to a BOOL variable that determines if the engine will return the check di git as part of the data string after a successful decode. If TRUE, the engine re turns the check digit. If FA LSE, the check digit is not returned. The defa[...]

  • Page 79

    IMAGETEAM™ 4X00 Series Software Development Kit (SDK) User’s Guide 2 - 65 Pa r a m e t e r s bXmitCheckDigit Points to a BOOL variable that determines if the engine will return the check di git as part of the data string after a successful decode. If TRUE, the engine re turns the check digit. If FA LSE, the check digit is not returned. The defa[...]

  • Page 80

    2 - 66 IMAGETEAM™ 4X00 Series Software Development Kit (SDK) User’s Guide This function uses the dimensions of the bar code as its coordinate system. Thus, all parameters describin g the image size and position are in units called Intelligent Ba r Code Units. An Intelligent Bar Code Unit is equivalent to the narrow element widt h of the bar cod[...]

  • Page 81

    IMAGETEAM™ 4X00 Series Software Development Kit (SDK) User’s Guide 2 - 67 Pa r a m e t e r s pImageDesc Pointer to a data structure describ ing the image to to be retrieved. typedef struct { int AspectRatio; int OffsetX; int OfsetY; unsigned int width; unsigned int height; int resolution; FileFormat_t format; int reserved; } IntellImgDesc _t; A[...]

  • Page 82

    2 - 68 IMAGETEAM™ 4X00 Series Software Development Kit (SDK) User’s Guide Pa r a m e t e r s dwTimeout Time in milliseconds that the engine scans until finding a decode. The timeout value must be greater than zero. pchMessage Upon successful return, this variable po ints to the decoded message. The ca ller should allocate enough memory for this[...]

  • Page 83

    IMAGETEAM™ 4X00 Series Software Development Kit (SDK) User’s Guide 2 - 69 Pa r a m e t e r s dwTimeout Time in milliseconds that the engine scans until finding a decode. The timeout value must be greater than zero. pchMessage Upon successful return, this variable po ints to the decoded message. The ca ller should allocate enough memory for this[...]

  • Page 84

    2 - 70 IMAGETEAM™ 4X00 Series Software Development Kit (SDK) User’s Guide Pa r a m e t e r s dwTimeout Maximum amount of time in millisec onds that the decoder may use to attempt to find and decode symbols. fpMultiReadCallBack Pointer to a callback function that takes a DecodeMsg_t variable as a pa rameter and returns a BOOL. Upon a successful [...]

  • Page 85

    IMAGETEAM™ 4X00 Series Software Development Kit (SDK) User’s Guide 3 - 1 3 S ymbology Identifiers Symbology Identifiers The following symbology identifiers are def ined in the Oemdecodece.h header file. Note: AIMID output is a pointer to the second character of the AIM ID string in the fo llowing chart. SymModifier is a pointer t o the modifier[...]

  • Page 86

    3 - 2 IMAGETEAM™ 4X00 Series Software Development Kit (SDK) User’s Guide Function Result V alues The following function result values are a sample of the values defined in th e Oemdecodece.h header file. RESULT_SUCCESS The API function succeeded. RESULT_ERR_BADREGION An image was reques ted using an invalid image region. RESULT_ERR_DRIVER The A[...]

  • Page 87

    IMAGETEAM™ 4X00 Series Software Development Kit (SDK) 4 - 1 4 Customer Suppor t T echnical Assist ance If you need assistance using the SDK, please call your Distributo r or the nearest Hand Held Pr oducts technical support office: North America/Canada: Telephone: (800) 782-4263, option 4 (8 a.m. to 6 p.m. EST) Fax: (315) 685-4960 E-mail: natechs[...]

  • Page 88

    4 - 2 IMAGETEAM™ 4X00 Series Software Development Kit (SDK)[...]

  • Page 89

    [...]

  • Page 90

    ™ Hand Held Products, Inc. 700 Visions Drive P.O. Box 208 Skaneateles Falls, NY 13153-0208 4X00SDK-UG Rev A 6/05 Note: This document replaces the OEMAPI-UG Rev C[...]