(TBarcodeFmx2D_GridMatrix)
Specifies which ECC level (error correction code level) will be used to increase strength of a Grid Matrix barcode symbol.
type
{ Defined in the pfmxGridMatrix unit }
TGridMatrix_EccLevel = (elLevel_Recommend, elLevel_1, elLevel_2, elLevel_3, elLevel_4, elLevel_5, elLevel_LowestRecommend);
property ECCLevel: TGridMatrix_EccLevel;
The Grid Matrix symbology offers five levels of error correction, from 1 to 5 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 Grid Matrix barcode symbol. It can be one of these values (defined in the pfmxGridMatrix unit):
elLevel_1: Indicates to use the ECC level 1. The percentage of total capacity for ECC data is 10%. Note, it is inapplicable to the version 1.
elLevel_2: Indicates to use the ECC level 2. The percentage of total capacity for ECC data is 20%.
elLevel_3: Indicates to use the ECC level 3. The percentage of total capacity for ECC data is 30%.
elLevel_4: Indicates to use the ECC level 4. The percentage of total capacity for ECC data is 40%.
elLevel_5: Indicates to use the ECC level 5. The percentage of total capacity for ECC data is 50%.
elLevel_Recommend: For each symbol version, the denotative ECC levels are listed in the following table:
| Version | Denotative ECC level |
|---|---|
| 1 | ECC level 5 |
| 2, 3 | ECC level 4 |
| 4 - 13 | ECC level 3 |
elLevel_LowestRecommend: For each symbol version, the denotative lowest ECC levels are listed in the following table:
| Version | Denotative ECC level |
|---|---|
| 1 | ECC level 4 |
| 2 | ECC level 2 |
| 3 - 13 | ECC level 1 |
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_GridMatrix" article.