(TBarcode2D_PDF417, TBarcode2D_CCC)
Specifies which ECC level (error correction code level) will be used to increase strength of a PDF417 barcode symbol, or of the CC-C 2D component in an EAN.UCC composite barcode symbol.
type
{ Defined in the pPDF417Custom unit }
TPDF417_EccLevel = (elEcc_0, elEcc_1, elEcc_2, elEcc_3, elEcc_4, elEcc_5, elEcc_6, elEcc_7, elEcc_8, elEcc_Auto);
property ECCLevel: TPDF417_EccLevel;
The PDF417 symbology and the CC-C symbology (the CC-C is one of the three choices for the 2D component in a barcode symbol encoded in EAN.UCC composite barcode symbology, and it's a variant of PDF417) offer nine levels of error correction, referred to as ECC 0 to ECC 8 respectively in increasing order of recovery capacity.
The property specifies which ECC level (error correction code level) will be used to increase strength of a PDF417 barcode symbol, or of the CC-C 2D component in an EAN.UCC composite barcode symbol. It can be one of values from elECC_0 to elECC_8, corresponding to the ECC level from 0 to 8. Also, it can be set to elEcc_Auto, indicates the recommended minimum ECC level will be used, depending on the length of barcode text. These ECC levels are defined in the pPDF417Custom unit, they are listed in following table:
| Property value | ECC Level | Number of Error correction codewrods |
|---|---|---|
| elECC_0 | ECC 0 | 2 |
| elECC_1 | ECC 1 | 4 |
| elECC_2 | ECC 2 | 8 |
| elECC_3 | ECC 3 | 16 |
| elECC_4 | ECC 4 | 32 |
| elECC_5 | ECC 5 | 64 |
| elECC_6 | ECC 6 | 128 |
| elECC_7 | ECC 7 | 256 |
| elECC_8 | ECC 8 | 512 |
If the ECCLevelUpgrade property is set to true, the highest error correction code level that can be accommodated by current symbol size will by used for creating more robust symbols. Note, the new level is always no lower than the level specified by this property, and the symbol size will not be increased, it may be determined depending on the length of barcode text, and the error correction code level specified by this property. In other words, only the remaining capacity in current symbol size will be used to upgrade the error correction code level.
The CurrentECCLevel property can always be used to get the factual error correction code level.
See also the "Error checking and correcting (ECC)" section in the "TBarcode2D_PDF417" and the "TBarcode2D_CCC" articles.