Property: ECCLevel

(TBarcode2D_DataMatrix)

Specifies which ECC level (error correction code level) will be used to increase strength of a Data Matrix (ECC 000 - 140) barcode symbol.

Syntax:

type

{ Defined in the pDataMatrix unit }

TDataMatrix_ECCLevel = (dmECC000, dmECC050, dmECC080, dmECC100, dmECC140);

property ECCLevel: TDataMatrix_ECCLevel;

Description:

The Data Matrix (ECC 000 - 140) symbology offers five levels of error correction, referred to as ECC 000, ECC 050, ECC 080, ECC 100 and ECC 140 respectively in increasing order of recovery capacity. In an application, it is important to understand that these error correction levels result in the generation of a proportional increase in the number of bits in the message (and hence increase in the size of the symbol), and offer different levels of error recovery.

The property specifies which ECC level (error correction code level) will be used to increase strength of a Data Matrix (ECC 000 - 140) barcode symbol. It can be one of these values (defined in the pDataMatrix unit):

• dmECC000: Indicates to use the ECC 000, namely, no error correction.
• dmECC050: Indicates to use the ECC 050, 25% data capacity is used for error correction, up to 2.8% damage can be corrected.
• dmECC080: Indicates to use the ECC 080, 33.3% data capacity is used for error correction, up to 5.5% damage can be corrected.
• dmECC100: Indicates to use the ECC 100, 50% data capacity is used for error correction, up to 12.6% damage can be corrected.
• dmECC140: Indicates to use the ECC 140, 75% data capacity is used for error correction, up to 25% damage can be corrected.

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

Contents