Property: ECCLevel

(TBarcodeFmx2D_PDF417)

Specifies which ECC level (error correction code level) will be used to increase strength of a PDF417 barcode symbol.

Syntax:

type

{ Defined in the pfmxPDF417Custom 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;

Description:

The PDF417 symbology offers 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. 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 pfmxPDF417Custom unit, they are listed in following table:

Property valueECC LevelNumber of
Error correction codewrods
elECC_0ECC 02
elECC_1ECC 14
elECC_2ECC 28
elECC_3ECC 316
elECC_4ECC 432
elECC_5ECC 564
elECC_6ECC 6128
elECC_7ECC 7256
elECC_8ECC 8512

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 "TBarcodeFmx2D_PDF417" article.

Contents