BARCODEDATA

Summary

This structure contains barcode information.

Syntax

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; 
   L_INT nBWR; 
   POINT Vertices[4]; 
} BARCODEDATA,* pBARCODEDATA; 

Members

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:

Linear (1D) barcode symbols

Value Meaning
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

Value Meaning
BARCODE_1D_PATCH_CODE [0x04000001] Patch Code type.

Postal barcode symbols

Value Meaning
BARCODE_1D_POST_NET [0x04000002] Postnet type.
BARCODE_1D_PLANET [0x04000004] Planet type.

4 State barcode symbols

Value Meaning
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

Value Meaning
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

Value Meaning
BARCODE_PDF417 [0x20002000] PDF417 type.

MicroPDF417 barcode symbol

Value Meaning
BARCODE_MICRO_PDF417 [0x20000001] MicroPDF417 type.

Data Matrix barcode symbol

Value Meaning
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

Value Meaning
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

Value Meaning
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 LBarCode::Write 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 LBarCode::Read 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 LBarCode::Read function.

nDupCount

Total count of barcodes duplicated for the current barcode. This member is filled by the LBarCode::Read function.

uFlags

Flags. This member will be filled only by LBarCode::Read 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 LBarCode::Read function when reading a MicroPDF417 symbol.

nAngle

Barcode angle in degrees, its value ranges from -18000 to 18000 with two digits precision. To obtain the real value angle divide it by 100. It 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.

Vertices

The polygon which represents the vertices X/Y coordination of the barcode on the bitmap by this sequence (top left, top right, bottom right, bottom left).

This value has to be updated just for 1D and QR types of barcodes.

Comments

This structure will be filled by LBarCode::Read when reading in barcode information.

You can also fill this structure before calling LBarCode::Write 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, 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:

For a table containing information useful when writing 1D barcode data, see Writing Linear 1D Barcodes.

Usage

Help Version 23.0.2024.2.29
Products | Support | Contact Us | Intellectual Property Notices
© 1991-2024 LEAD Technologies, Inc. All Rights Reserved.

LEADTOOLS Barcode C++ Class Library Help
Products | Support | Contact Us | Intellectual Property Notices
© 1991-2023 LEAD Technologies, Inc. All Rights Reserved.