eVision C++ API 26.10.0-beta.2.dev
Loading...
Searching...
No Matches
eVision::EasyBarCode2::EBarCodeGradingParameters Struct Reference

Represents the grading Parameters associated with an EBarCode as defined by ISO15416. More...

#include <eVision/EasyBarCode/EasyBarCode2/EBarCodeGradingParameters.h>

Public Member Functions

std::string GetAdditionalRequirementName () const
 ISO 15416 defines an additional requirement that is symbology specific. This function returns its name for the current EBarCodeGradingParameters. Currently, "Quiet Zone" is always returned.

Static Public Member Functions

static std::string ConvertToAlphabeticGrade (uint8_t grade)
 ISO15416 defines grades as either number of letters. We use numbers internally but this function can be used to convert number to letters.

Public Attributes

uint8_t DecodeGrade
 Indicates whether the barcode was decoded. Grade is 40 if barcode was decoded and 0 if it was not.
uint8_t SymbolContrastGrade
 Indicates the fraction of total image contrast used by the barcode. Grade is between 0 (<= 51 gray values) and 40 (>= 180 gray values).
uint8_t MinimumReflectanceGrade
 Indicates the ratio between the smallest and largest gray value in the barcode. Grade is 40 if the smallest gray value of the barcode is <= half of its highest value and 0 otherwise.
uint8_t MinimumEdgeContrastGrade
 Indicates the smallest contrast between two adjacent bar and space (including quiet zones). Grade is 40 if the minimum edge contrast is >= 15% and 0 otherwise.
uint8_t ModulationGrade
 Indicates the importance of the minimum edge contrast relative to the symbol contrast. Grade is between 40 (>= 70%) and 0 (< 40%).
uint8_t DefectsGrade
 Indicates the importance of irregularities found within elements and quiet zones. Grade is between 40 (small irregularities) and 0 (large irregularities).
uint8_t DecodabilityGrade
 Indicates the importance of differences between the distances measured and expected. Grade is between 40 (distances measured are close to those expected) and 0 (distances measured are far from those expected).
uint8_t AdditionalRequirementsGrade
 Indicates a symbology specific requirement. The name of that specific requirement for the current EBarCodeGradingParameters may be retrieved with EBarCodeGradingParameters::GetAdditionalRequirementName. EBarCodeSymbologies::EBarCodeSymbologies_Code128, EBarCodeSymbologies::EBarCodeSymbologies_Gs1_128 and EBarCodeSymbologies::EBarCodeSymbologies_Ean13 all grade the size of the quiet zone of the barcode. Grade is 40 (large enough quiet zone) and 0 (quiet zone too small).
uint8_t GlobalGrade
 The global grade is the smallest of all of the other grades. If two scan lines yield different decoded strings, the Global Grade is set to 0. Grade is between 40 (best) and 0 (worst).

Detailed Description

Represents the grading Parameters associated with an EBarCode as defined by ISO15416.

Each grade is expressed as an integer between 0 and 40 instead of a float from 0.0 to 4.0 by steps of 0.1 to avoid rounding errors. Each grade represents the average grade obtained on 10 horizontal lines in the barcode.

License(s): None

Member Function Documentation

◆ ConvertToAlphabeticGrade()

std::string eVision::EasyBarCode2::EBarCodeGradingParameters::ConvertToAlphabeticGrade ( uint8_t grade)
static

ISO15416 defines grades as either number of letters. We use numbers internally but this function can be used to convert number to letters.

Parameters
gradeThe grade as an integer between 0 and 40.

◆ GetAdditionalRequirementName()

std::string eVision::EasyBarCode2::EBarCodeGradingParameters::GetAdditionalRequirementName ( ) const

ISO 15416 defines an additional requirement that is symbology specific. This function returns its name for the current EBarCodeGradingParameters. Currently, "Quiet Zone" is always returned.

Member Data Documentation

◆ AdditionalRequirementsGrade

uint8_t eVision::EasyBarCode2::EBarCodeGradingParameters::AdditionalRequirementsGrade

Indicates a symbology specific requirement. The name of that specific requirement for the current EBarCodeGradingParameters may be retrieved with EBarCodeGradingParameters::GetAdditionalRequirementName. EBarCodeSymbologies::EBarCodeSymbologies_Code128, EBarCodeSymbologies::EBarCodeSymbologies_Gs1_128 and EBarCodeSymbologies::EBarCodeSymbologies_Ean13 all grade the size of the quiet zone of the barcode. Grade is 40 (large enough quiet zone) and 0 (quiet zone too small).

◆ DecodabilityGrade

uint8_t eVision::EasyBarCode2::EBarCodeGradingParameters::DecodabilityGrade

Indicates the importance of differences between the distances measured and expected. Grade is between 40 (distances measured are close to those expected) and 0 (distances measured are far from those expected).

◆ DecodeGrade

uint8_t eVision::EasyBarCode2::EBarCodeGradingParameters::DecodeGrade

Indicates whether the barcode was decoded. Grade is 40 if barcode was decoded and 0 if it was not.

◆ DefectsGrade

uint8_t eVision::EasyBarCode2::EBarCodeGradingParameters::DefectsGrade

Indicates the importance of irregularities found within elements and quiet zones. Grade is between 40 (small irregularities) and 0 (large irregularities).

◆ GlobalGrade

uint8_t eVision::EasyBarCode2::EBarCodeGradingParameters::GlobalGrade

The global grade is the smallest of all of the other grades. If two scan lines yield different decoded strings, the Global Grade is set to 0. Grade is between 40 (best) and 0 (worst).

◆ MinimumEdgeContrastGrade

uint8_t eVision::EasyBarCode2::EBarCodeGradingParameters::MinimumEdgeContrastGrade

Indicates the smallest contrast between two adjacent bar and space (including quiet zones). Grade is 40 if the minimum edge contrast is >= 15% and 0 otherwise.

◆ MinimumReflectanceGrade

uint8_t eVision::EasyBarCode2::EBarCodeGradingParameters::MinimumReflectanceGrade

Indicates the ratio between the smallest and largest gray value in the barcode. Grade is 40 if the smallest gray value of the barcode is <= half of its highest value and 0 otherwise.

◆ ModulationGrade

uint8_t eVision::EasyBarCode2::EBarCodeGradingParameters::ModulationGrade

Indicates the importance of the minimum edge contrast relative to the symbol contrast. Grade is between 40 (>= 70%) and 0 (< 40%).

◆ SymbolContrastGrade

uint8_t eVision::EasyBarCode2::EBarCodeGradingParameters::SymbolContrastGrade

Indicates the fraction of total image contrast used by the barcode. Grade is between 0 (<= 51 gray values) and 40 (>= 180 gray values).