(TBarcode2D_GridMatrix)

Contains the factual error correction code level of a Grid Matrix barcode symbol.

**type**

__{ Defined in the pGridMatrix unit }__

TGridMatrix_EccLevel = (elLevel_Recommend, elLevel_1, elLevel_2, elLevel_3, elLevel_4, elLevel_5, elLevel_LowestRecommend);

**property** CurrentECCLevel: 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 always contains the factual error correction code level of a Grid Matrix barcode symbol. It can be one of these values (defined in the *pGridMatrix* unit):

**elLevel_1**: The ECC level of a Grid Matrix barcode symbol is 1. The percentage of total capacity for ECC data is 10%.**elLevel_2**: The ECC level of a Grid Matrix barcode symbol is 2. The percentage of total capacity for ECC data is 20%.**elLevel_3**: The ECC level of a Grid Matrix barcode symbol is 3. The percentage of total capacity for ECC data is 30%.**elLevel_4**: The ECC level of a Grid Matrix barcode symbol is 4. The percentage of total capacity for ECC data is 40%.**elLevel_5**: The ECC level of a Grid Matrix barcode symbol is 5. The percentage of total capacity for ECC data is 50%.

If the ECCLevelUpgrade property is set to true, the remaining data capacity of a Grid Matrix barcode symbol will be used to automatically upgrade the error correction code level, the highest error correction code level that can be accommodated by current symbol size will by used for creating more robust symbols. Read the property to retrieve the factual error correction code level of the Grid Matrix barcode symbol.

If the ECCLevelUpgrade property is set to false, the error correction code level specified by the ECCLevel property will be used always. The value of this property is always equal to the value of the ECCLevel property.

The property is read only.

See also the "Error checking and correcting (ECC)" section in the "TBarcode2D_GridMatrix" article.

Copyright © 2001-2024 Han-soft Corporation. All rights reserved.