Barcode (CVCBarcode.dll) 14.1
Barcode Grading 1D

Functions

void CvcBcGetCodeGrading1D (CVC_BC_CONFIG config, BOOL *active, short *r_min_ref, short *r_max_ref)
 This function reads all parameters for the 1D Code Grading from the specified configuration. More...
 
void CvcBcGetCodeGrading1DEx (CVC_BC_CONFIG config, BOOL *active, short *r_min_ref, short *r_max_ref, BOOL *grade_decodes, BOOL *grade_reflectance_min, BOOL *grade_symbol_contrast, BOOL *grade_edge_contrast_min, BOOL *grade_modulation, BOOL *grade_defects, BOOL *grade_decodability)
 This function reads all parameters for the 1D Code Grading from the specified configuration. More...
 
short CvcBcSetCodeGrading1D (CVC_BC_CONFIG config, BOOL active, short r_min_ref, short r_max_ref)
 This function sets all parameters for decoding the 1D Code Grading. More...
 
short CvcBcSetCodeGrading1DEx (CVC_BC_CONFIG config, BOOL active, short r_min_ref, short r_max_ref, BOOL grade_decodes, BOOL grade_reflectance_min, BOOL grade_symbol_contrast, BOOL grade_edge_contrast_min, BOOL grade_modulation, BOOL grade_defects, BOOL grade_decodability)
 This function sets all parameters for decoding the 1D Code Grading. More...
 

Detailed Description

Function Documentation

◆ CvcBcGetCodeGrading1D()

void CvcBcGetCodeGrading1D ( CVC_BC_CONFIG  config,
BOOL *  active,
short *  r_min_ref,
short *  r_max_ref 
)

This function reads all parameters for the 1D Code Grading from the specified configuration.

The config parameter is the handle to the configuration from which the data is to be read. If config = NULL, the data is read from the default configuration.

All other parameters are pointers to variables in which the corresponding information is to be stored. The description of the parameters is specified in the associated function CvcBcSetCodeGrading1D.

Note
If one or more parameters have been corrected, the modified values can then be determined using the Get function.
Parameters
[in]configHandle to the configuration or NULL to use the default configuration.
[in]activeEvaluate / don't evaluate evaluate 1D Code Grading.
[in]r_min_refMinimum r ref value for the symbol contrast calculation (range 0 - 254, default 0).
[in]r_max_refMaximum r ref value for the symbol contrast calculation (range 1 - 255, default 255).
Supported platforms:
Win32
Win64
Related Topics:
CvcBcSetCodeGrading1D
CVC_BC_QUALITY_INFO

◆ CvcBcGetCodeGrading1DEx()

void CvcBcGetCodeGrading1DEx ( CVC_BC_CONFIG  config,
BOOL *  active,
short *  r_min_ref,
short *  r_max_ref,
BOOL *  grade_decodes,
BOOL *  grade_reflectance_min,
BOOL *  grade_symbol_contrast,
BOOL *  grade_edge_contrast_min,
BOOL *  grade_modulation,
BOOL *  grade_defects,
BOOL *  grade_decodability 
)

This function reads all parameters for the 1D Code Grading from the specified configuration.

Unlike the related function CvcBcGetCodeGrading1D, CvcBcGetCodeGrading1D allows for the readout of the filter flags that control which parameters that enter the calculation of the grade_overall result.

The config parameter is the handle to the configuration from which the data is to be read. If config = NULL, the data is read from the default configuration.

All other parameters are pointers to variables in which the corresponding information is to be stored. The description of the parameters is specified in the associated function CvcBcSetCodeGrading1D.

Note
If one or more parameters have been corrected, the modified values can then be determined using the Get function.
Parameters
[in]configHandle to the configuration or NULL to use the default configuration.
[out]activeEvaluate / don't evaluate evaluate 1D Code Grading.
[out]r_min_refMinimum r ref value for the symbol contrast calculation (range 0 - 254, default 0).
[out]r_max_refMaximum r ref value for the symbol contrast calculation (range 1 - 255, default 255).
[out]grade_decodesFlag specifying whether or not the grade decodes will enter the calculation of grade_overall.
[out]grade_reflectance_minFlag specifying whether or not the grade reflectance_min will enter the calculation of grade_overall.
[out]grade_symbol_contrastFlag specifying whether or not the grade symbol_contrast will enter the calculation of grade_overall.
[out]grade_edge_contrast_minFlag specifying whether or not the grade edge_contrast_min will enter the calculation of grade_overall.
[out]grade_modulationFlag specifying whether or not the grade modulation will enter the calculation of grade_overall.
[out]grade_defectsFlag specifying whether or not the grade defects will enter the calculation of grade_overall.
[out]grade_decodabilityFlag specifying whether or not the grade decodability will enter the calculation of grade_overall.
Supported platforms:
Win32
Win64
Related Topics:
CvcBcGetCodeGrading1D, CvcBcSetCodeGrading1DEx, CvcBcSetCodeGrading1D
CVC_BC_QUALITY_INFO

◆ CvcBcSetCodeGrading1D()

short CvcBcSetCodeGrading1D ( CVC_BC_CONFIG  config,
BOOL  active,
short  r_min_ref,
short  r_max_ref 
)

This function sets all parameters for decoding the 1D Code Grading.

The config parameter is the handle to the configuration from which the data is to be read. If config = NULL, the data is read from the default configuration.

You can use the parameters r_min_ref and r_max_ref to calibrate the reference values of the colours black and white for the symbol contrast.

The value of r_min_ref (black) can be in the range of 0 - 254, default 0.
The value of r_max_ref (white) can be in the range of 1 - 255, default 255.
The value of r_max_ref must always be higher than the value of r_min_ref.

Example: The black offset in an image is always a grey value of 15 instead of 0. If you set r_min_ref = 15 you can reach a contrast of 100% in the case r_min = 15 and r_max = 255.

Note
If one or more parameters have been corrected, the modified values can then be determined using the Get function.
Parameters
[in]configHandle to the configuration or NULL to use the default configuration.
[in]activeEvaluate / don't evaluate evaluate 1D Code Grading.

The parameter active to enables and disables the decoding of the code configuration config. Specifying TRUE enables and FALSE disables decoding.
[in]r_min_refMinimum r ref value for the symbol contrast calculation (range 0 - 254, default 0).
[in]r_max_refMaximum r ref value for the symbol contrast calculation (range 1 - 255, default 255).
Returns
CVC_BC_NO_ERROR on success, otherwise CVC_BC_PARAMETER_WARNING.
Supported platforms:
Win32
Win64
Related Topics:
CvcBcGetCodeGrading1D
CVC_BC_QUALITY_INFO

◆ CvcBcSetCodeGrading1DEx()

short CvcBcSetCodeGrading1DEx ( CVC_BC_CONFIG  config,
BOOL  active,
short  r_min_ref,
short  r_max_ref,
BOOL  grade_decodes,
BOOL  grade_reflectance_min,
BOOL  grade_symbol_contrast,
BOOL  grade_edge_contrast_min,
BOOL  grade_modulation,
BOOL  grade_defects,
BOOL  grade_decodability 
)

This function sets all parameters for decoding the 1D Code Grading.

Unlike the related function CvcBcSetCodeGrading1D, CvcBcSetCodeGrading1D allows for the selection of those parameters that enter the calculation of the grade_overall result.

The config parameter is the handle to the configuration from which the data is to be read. If config = NULL, the data is read from the default configuration.

You can use the parameters r_min_ref and r_max_ref to calibrate the reference values of the colours black and white for the symbol contrast.

The value of r_min_ref (black) can be in the range of 0 - 254, default 0.
The value of r_max_ref (white) can be in the range of 1 - 255, default 255.
The value of r_max_ref must always be higher than the value of r_min_ref.

Example: The black offset in an image is always a grey value of 15 instead of 0. If you set r_min_ref = 15 you can reach a contrast of 100% in the case r_min = 15 and r_max = 255.

Note
If one or more parameters have been corrected, the modified values can then be determined using the Get function.
Parameters
[in]configHandle to the configuration or NULL to use the default configuration.
[in]activeEvaluate / don't evaluate evaluate 1D Code Grading.

The parameter active to enables and disables the decoding of the code configuration config. Specifying TRUE enables and FALSE disables decoding.
[in]r_min_refMinimum r ref value for the symbol contrast calculation (range 0 - 254, default 0).
[in]r_max_refMaximum r ref value for the symbol contrast calculation (range 1 - 255, default 255).
[in]grade_decodesFlag specifying whether or not the grade decodes will enter the calculation of grade_overall.
[in]grade_reflectance_minFlag specifying whether or not the grade reflectance_min will enter the calculation of grade_overall.
[in]grade_symbol_contrastFlag specifying whether or not the grade symbol_contrast will enter the calculation of grade_overall.
[in]grade_edge_contrast_minFlag specifying whether or not the grade edge_contrast_min will enter the calculation of grade_overall.
[in]grade_modulationFlag specifying whether or not the grade modulation will enter the calculation of grade_overall.
[in]grade_defectsFlag specifying whether or not the grade defects will enter the calculation of grade_overall.
[in]grade_decodabilityFlag specifying whether or not the grade decodability will enter the calculation of grade_overall.
Returns
CVC_BC_NO_ERROR on success, otherwise CVC_BC_PARAMETER_WARNING.
Supported platforms:
Win32
Win64
Related Topics:
CvcBcGetCodeGrading1D, CvcBcGetCodeGrading1DEx, CvcBcSetCodeGrading1D
CVC_BC_QUALITY_INFO