BARCODEDATA

typedef struct tagBarCodeData 
{ 
   L_UINT uStructSize; 
   L_INT nGroup; 
   L_UINT32 ulType; 
   L_INT nUnits; 
   RECT rcBarLocation; 
   L_INT nSizeofBarCodeData; 
   L_CHAR * pszBarCodeData; 
   L_INT nIndexDuplicate; 
   L_INT nTotalCount; 
   L_INT nDupCount; 
   L_UINT uFlags; 
   L_UINT uDataCode; 
   L_INT nAngle; 
} BARCODEDATA,* pBARCODEDATA; 

This structure contains barcode information.

Member Description
uStructSize Size of BARCODEDATA structure, in bytes, for versioning. Use the sizeof operator to calculate this value.
nGroup Specifies whether the barcode symbol is a member of a group of symbols. This member is used for reading PDF417 symbols.
ulType Barcode type. Possible values are :
  Value Meaning
  Linear (1D) barcode symbols:  
  BARCODE_1D_EAN_13 [0x80000001] EAN 13 type. Used with consumer products internationally.
  BARCODE_1D_EAN_8 [0x80000002] EAN 8 type. The short version of EAN13.
  BARCODE_1D_UPC_A [0x80000004] UPC version A type. Used with consumer products in U.S.
  BARCODE_1D_UPC_E [0x80000008] UPC version E type. It is the short version of UPCA.
  BARCODE_1D_CODE_3_OF_9 [0x80000010] Code 3 of 9 (Code 39) type. Used especially in non-retail environments.
  BARCODE_1D_CODE_3_OF_9_EXTENDED [0x80040000] Code 3 of 9 (Code 39) type with extended characters encoded. Used especially in non-retail environments.
  BARCODE_1D_CODE_128 [0x80000020] Code 128 type. Very dense code, used extensively worldwide.
  BARCODE_1D_CODE_I2_OF_5 [0x80000040] Interleaved 2 of 5 type. Used in warehouse, industrial applications.
  BARCODE_1D_CODA_BAR [0x80000080] CODABAR (Ames Code/USD-4/NW-7/2 of 7 Code) type. Used in libraries and blood banks.
  BARCODE_1D_UCCEAN_128 [0x80000100] UCCEAND 128 type
  BARCODE_1D_CODE_93 [0x80000200] Code 93 type. Compressed form of Code 39.
  BARCODE_1D_CODE_93_EXTENDED [0x80000201] Code 93 Extended type. Compressed form of Code 39.
  BARCODE_1D_EANEXT_5 [0x80000400] 5-digit supplemental type. May be used with UPCA, UPCE, EAN13 and EAN8 on books to indicate a suggested retail price.
  BARCODE_1D_EANEXT_2 [0x80000800] 2-digit supplemental type. May be used with UPCA, UPCE, EAN13 and EAN8 to indicate magazines and newspaper issue numbers.
  BARCODE_1D_MSI [0x80001000] MSI (Modified Plessey) type. Used to mark retail shelves for inventory control.
  BARCODE_1D_CODE11 [0x80002000] Code 11(USD-8) type. Used in labeling telecommunications equipment.
  BARCODE_1D_CODE_S25 [0x80004000] Standard 2 of 5 (Industrial 2 of 5) type. Used in the photofinishing, warehouse sorting industries and sequentially numbering airline tickets.
  BARCODE_1D_RSS14 [0x80008000] GS1 Databar (formerly RSS14) type. Used in grocery industry, healthcare, and where items are too small to allow for older barcode symbologies.
  BARCODE_1D_RSS14_LIMITED [0x80010000] GS1 Databar (formerly RSS14) Limited type. Short version of GS1 Databar (formerly RSS14).
  BARCODE_1D_RSS14_EXPANDED [0x80020000] GS1 Databar (formerly RSS14) Expanded type. It encodes item identification plus supplementary strings such as weight and date. Used in grocery industry and healthcare.
  Patch Code barcode symbol:  
  BARCODE_1D_PATCH_CODE [0x04000001] Patch Code type.
  Postal barcode symbols:  
  BARCODE_1D_POST_NET [0x04000002] Postnet type.
  BARCODE_1D_PLANET [0x04000004] Planet type.
  4 State barcode symbols:
  BARCODE_1D_AUST_POST [0x04000008] Australian Post 4 State type.
  BARCODE_1D_RM4SCC [0x04000010] Royal Mail (RM4SCC) 4 State type.   
  BARCODE_1D_USPS4BC [0x04000080] USPS OneCode 4-State (4BC) type
  GS1 Databar (formerly RSS14) Stacked barcode symbols:
  BARCODE_1D_RSS14_STACKED [0x04000020] GS1 Databar (formerly RSS14) Stacked / Stacked Omni-Directional types. Used instead of GS1 Databar (formerly RSS14) if the available space is too narrow for the standard GS1 Databar.
  BARCODE_1D_RSS14_EXP_STACKED [0x04000040] GS1 Databar (formerly RSS14) Expanded Stacked barcode type. Used instead of GS1 Databar (formerly RSS14) Expanded if the available space is too narrow to fit in one line.
  PDF417 barcode symbol:  
  BARCODE_PDF417 [0x20002000] PDF417 type.
  MicroPDF417 barcode symbol:  
  BARCODE_MICRO_PDF417 [0x20000001] MicroPDF417 type.
  Data Matrix barcode symbol:  
  BARCODE_DM_DEF [0x10000101] Default Data Matrix size
  BARCODE_DM_10x10 [0x10000102] Data Matrix Type 10x10.
  BARCODE_DM_12x12 [0x10000103] Data Matrix Type 12x12.
  BARCODE_DM_14x14 [0x10000104] Data Matrix Type 14x14.
  BARCODE_DM_16x16 [0x10000105] Data Matrix Type 16x16.
  BARCODE_DM_18x18 [0x10000106] Data Matrix Type 18x18.
  BARCODE_DM_20x20 [0x10000107] Data Matrix Type 20x20.
  BARCODE_DM_22x22 [0x10000108] Data Matrix Type 22x22.
  BARCODE_DM_24x24 [0x10000109] Data Matrix Type 24x24.
  BARCODE_DM_26x26 [0x1000010A] Data Matrix Type 26x26.
  BARCODE_DM_32x32 [0x1000010B] Data Matrix Type 32x32.
  BARCODE_DM_36x36 [0x1000010C] Data Matrix Type 36x36.
  BARCODE_DM_40x40 [0x1000010D] Data Matrix Type 40x40.
  BARCODE_DM_44x44 [0x1000010E] Data Matrix Type 44x44.
  BARCODE_DM_48x48 [0x1000010F] Data Matrix Type 48x48.
  BARCODE_DM_52x52 [0x10000110] Data Matrix Type 52x52.
  BARCODE_DM_64x64 [0x10000111] Data Matrix Type 64x64.
  BARCODE_DM_72x72 [0x10000112] Data Matrix Type 72x72.
  BARCODE_DM_80x80 [0x10000113] Data Matrix Type 80x80.
  BARCODE_DM_88x88 [0x10000114] Data Matrix Type 88x88.
  BARCODE_DM_96x96 [0x10000115] Data Matrix Type 96x96.
  BARCODE_DM_104x104 [0x10000116] Data Matrix Type 104x104.
  BARCODE_DM_120x120 [0x10000117] Data Matrix Type 120x120.
  BARCODE_DM_132x132 [0x10000118] Data Matrix Type 132x132.
  BARCODE_DM_144x144 [0x10000119] Data Matrix Type 144x144.
  BARCODE_DM_8x18 [0x1000011A] Data Matrix Type 8x18.
  BARCODE_DM_8x32 [0x1000011B] Data Matrix Type 8x32.
  BARCODE_DM_12x26 [0x1000011C] Data Matrix Type 12x26.
  BARCODE_DM_12x36 [0x1000011D] Data Matrix Type 12x36.
  BARCODE_DM_16x36 [0x1000011E] Data Matrix Type 16x36.
  BARCODE_DM_16x48 [0x1000011F] Data Matrix Type 16x48.
  BARCODE_DM_WRITE_RECTANGLE [0x10000180] Default Data Matrix rectangle size.
  QR barcode symbol:
  BARCODE_QR_DEF [0x08000300] Default QR Code size
  BARCODE_QR_M2_1 [0x08000301] QR Code Model 2, Version 1
  BARCODE_QR_M2_2 [0x08000302] QR Code Model 2, Version 2
  BARCODE_QR_M2_3 [0x08000303] QR Code Model 2, Version 3
  BARCODE_QR_M2_4 [0x08000304] QR Code Model 2, Version 4
  BARCODE_QR_M2_5 [0x08000305] QR Code Model 2, Version 5
  BARCODE_QR_M2_6 [0x08000306] QR Code Model 2, Version 6
  BARCODE_QR_M2_7 [0x08000307] QR Code Model 2, Version 7
  BARCODE_QR_M2_8 [0x08000308] QR Code Model 2, Version 8
  BARCODE_QR_M2_9 [0x08000309] QR Code Model 2, Version 9
  BARCODE_QR_M2_10 [0x0800030A] QR Code Model 2, Version 10
  BARCODE_QR_M2_11 [0x0800030B] QR Code Model 2, Version 11
  BARCODE_QR_M2_12 [0x0800030C] QR Code Model 2, Version 12
  BARCODE_QR_M2_13 [0x0800030D] QR Code Model 2, Version 13
  BARCODE_QR_M2_14 [0x0800030E] QR Code Model 2, Version 14
  BARCODE_QR_M2_15 [0x0800030F] QR Code Model 2, Version 15
  BARCODE_QR_M2_16 [0x08000310] QR Code Model 2, Version 16
  BARCODE_QR_M2_17 [0x08000311] QR Code Model 2, Version 17
  BARCODE_QR_M2_18 [0x08000312] QR Code Model 2, Version 18
  BARCODE_QR_M2_19 [0x08000313] QR Code Model 2, Version 19
  BARCODE_QR_M2_20 [0x08000314] QR Code Model 2, Version 20
  BARCODE_QR_M2_21 [0x08000315] QR Code Model 2, Version 21
  BARCODE_QR_M2_22 [0x08000316] QR Code Model 2, Version 22
  BARCODE_QR_M2_23 [0x08000317] QR Code Model 2, Version 23
  BARCODE_QR_M2_24 [0x08000318] QR Code Model 2, Version 24
  BARCODE_QR_M2_25 [0x08000319] QR Code Model 2, Version 25
  BARCODE_QR_M2_26 [0x0800031A] QR Code Model 2, Version 26
  BARCODE_QR_M2_27 [0x0800031B] QR Code Model 2, Version 27
  BARCODE_QR_M2_28 [0x0800031C] QR Code Model 2, Version 28
  BARCODE_QR_M2_29 [0x0800031D] QR Code Model 2, Version 29
  BARCODE_QR_M2_30 [0x0800031E] QR Code Model 2, Version 30
  BARCODE_QR_M2_31 [0x0800031F] QR Code Model 2, Version 31
  BARCODE_QR_M2_32 [0x08000320] QR Code Model 2, Version 32
  BARCODE_QR_M2_33 [0x08000321] QR Code Model 2, Version 33
  BARCODE_QR_M2_34 [0x08000322] QR Code Model 2, Version 34
  BARCODE_QR_M2_35 [0x08000323] QR Code Model 2, Version 35
  BARCODE_QR_M2_36 [0x08000324] QR Code Model 2, Version 36
  BARCODE_QR_M2_37 [0x08000325] QR Code Model 2, Version 37
  BARCODE_QR_M2_38 [0x08000326] QR Code Model 2, Version 38
  BARCODE_QR_M2_39 [0x08000327] QR Code Model 2, Version 39
  BARCODE_QR_M2_40 [0x08000328] QR Code Model 2, Version 40
  BARCODE_QR_M1_1 [0x08000329] QR Code Model 1, Version 1
  BARCODE_QR_M1_2 [0x0800032A] QR Code Model 1, Version 2
  BARCODE_QR_M1_3 [0x0800032B] QR Code Model 1, Version 3
  BARCODE_QR_M1_4 [0x0800032C] QR Code Model 1, Version 4
  BARCODE_QR_M1_5 [0x0800032D] QR Code Model 1, Version 5
  BARCODE_QR_M1_6 [0x0800032E] QR Code Model 1, Version 6
  BARCODE_QR_M1_7 [0x0800032F] QR Code Model 1, Version 7
  BARCODE_QR_M1_8 [0x08000330] QR Code Model 1, Version 8
  BARCODE_QR_M1_9 [0x08000331] QR Code Model 1, Version 9
  BARCODE_QR_M1_10 [0x08000332] QR Code Model 1, Version 10
  BARCODE_QR_M1_11 [0x08000333] QR Code Model 1, Version 11
  BARCODE_QR_M1_12 [0x08000334] QR Code Model 1, Version 12
  BARCODE_QR_M1_13 [0x08000335] QR Code Model 1, Version 13
  BARCODE_QR_M1_14 [0x08000336] QR Code Model 1, Version 14
  BARCODE_QR_M1_DEF [0x08000337] Default Model 1 QR Code size
Other barcode symbol:  
BARCODE_1D_PHARMA_CODE [0x04000100] PharmaCode type. Used in the pharmaceutical industry as a packing control system.
nUnits Unit of measure for the rcBarLocation member. Possible values are:
  Value Meaning
  BARCODE_SCANLINES_PER_PIXELS [0] the rcBarLocation rectangle is measured in pixels.
  BARCODE_INCHES [1] the rcBarLocation rectangle is measured in inches. You must multiply the search area by 100 when using the L_BarCodeWrite function.
  BARCODE_MILLIMETERS [2] the rcBarLocation rectangle is measured in mm.
rcBarLocation The barcode location on the bitmap.
nSizeofBarCodeData Barcode data size. If it is zero, the string length will be considered as data size.
pszBarCodeData Pointer to the barcode data string.

 

nIndexDuplicate Index to the next duplicated barcode. This member will be filled only by L_BarCodeRead function. Possible values are:
  Value Meaning
  >=0 Next duplicated index.
  -1 The barcode is not duplicated.
  0xFF The barcode is the last duplicated one.
nTotalCount Total barcode count found by L_BarCodeRead function.
nDupCount Total count of barcodes duplicated for the current barcode. This member is filled by the L_BarCodeRead function.
uFlags Flags. This member will be filled only by L_BarCodeRead function. Possible value is:
  Value Meaning
  BARCODE_MICRO_PDF417_LINKED MicroPDF417 is linked to a linear symbol printed below it.

 

uDataCode

MicroPDF417 start code word function for Code128 emulation. This member will be filled by the L_BarCodeRead function when reading a MicroPDF417 symbol.

nAngle

Barcode angle in degrees. Values range from -18000 to 18000 with two-digit precision. To obtain the real value, divide nAngle by 100. This value is reported when the barcode is read, and it is not used for writing.

nBWR

Bar width reduction value, in micrometers, for each black bar in the barcode. It is reported when the barcode is read, and it is not used for writing.

Comments

This structure will be filled by L_BarCodeRead when reading in barcode information.

You can also fill this structure before calling L_BarCodeWrite to print the barcode symbol on the bitmap.

There is no limitation on the barcode angle, i.e. all angles can be detected,( whereas the deskew command is limited to +/- 20 degrees). It is very useful to detect the document image skew angle to correct the image angle. Provide this angle to deskew the image or rotate the image in the reverse direction.

Australian post barcode strings have a special format to distinguish different fields (i.e. FCC, DPID, and CIF). The string format puts dashes between fields as follows:  FCC-DIPD-CIF, where FCC is a 2-digit field (valid values are 11, 87, 45, 92, 59, 62, and 44), DPID is an 8-digit field representing the address, and CIF (optional) represents the customer information field. For more information, please refer to the standard. This string format applies to both reading and writing.

GS1 Databar (formerly RSS14) Expanded and Expanded Stacked strings need to be written conforming to a string format that indicates a particular encoding method, such as Method 1, Method 0100, or Method 0101. For example, suppose a string (01)00012345678905(10)ABC123 is encoded using Method 1  (i.e. General Identification Data). In this example the 14th digit of the item identification number (jn this case, "5"), if it exists, is considered as a check digit and is ignored. A string that is written without following any of these special encoding formats will be encoded by Method 00 (i.e. General Purpose Data).

When read, an extra digit in curly brackets (i.e. { and }) is added to indicate the linkage bit at the beginning of the string. The curly brackets are not part of the encoded barcode data, and they are not defined in the standard. Rather, they distinguish the linkage digit from other data. For example, if a barcode is written with string (01)00012345678905(10)ABC123 while the linkage bit is set to zero, the read function result will be {0}(01)00012345678905(10)ABC123, where {0} is the linkage digit and the remaining characters are the barcode data.

Notes:

  • Type RSS14 is now GS1 Databar. All references to RSS14 now refer to GS1 Databar.

  • Code Interleaved 2 of 5: I = # of digits and must be even.

  • Linear barcodes are not supported in UNICODE.

For a table containing information useful when writing 1D barcode data see https://www.leadtools.com/sdk/barcode/1d-chart.

Help Version 19.0.2017.10.27
Products | Support | Contact Us | Copyright Notices
© 1991-2017 LEAD Technologies, Inc. All Rights Reserved.