Functions
void	CvcBcGetCodeGrading (CVC_BC_CONFIG config, BOOL active, BOOL symbol_contrast, BOOL axial_nonuniformity, BOOL grid_nonuniformity, BOOL unused_error_correction, BOOL print_growth, BOOL angle_of_distortion, short r_min_ref, short *r_max_ref)
	This function reads the parameters for code grading (only active with Data Matrix barcode). More...

void	CvcBcGetCodeGradingEx (CVC_BC_CONFIG config, BOOL active, BOOL symbol_contrast, BOOL axial_nonuniformity, BOOL grid_nonuniformity, BOOL unused_error_correction, BOOL print_growth, BOOL angle_of_distortion, BOOL modulation, BOOL reflectance_margin, BOOL fixed_pattern_damage, short r_min_ref, short r_max_ref)
	Retrieves the currently set parameters related to calculating grades on Data Matrix codes (extended). More...

void	CvcBcGetQRCodeGrading (CVC_BC_CONFIG config, BOOL active, BOOL symbol_contrast, BOOL axial_nonuniformity, BOOL grid_nonuniformity, BOOL unused_error_correction, BOOL angle_of_distortion, BOOL modulation, BOOL fixed_pattern_damage, BOOL format_information, BOOL version_information, BOOL reduced_quiet_zone, short r_min_ref, short *r_max_ref)
	Retrieves the currently set parameters related to calculating grades on QR codes. More...

void	CvcBcGetQRCodeGradingEx (CVC_BC_CONFIG config, BOOL active, BOOL symbol_contrast, BOOL axial_nonuniformity, BOOL grid_nonuniformity, BOOL unused_error_correction, BOOL angle_of_distortion, BOOL modulation, BOOL reflectance_margin, BOOL fixed_pattern_damage, BOOL format_information, BOOL version_information, BOOL reduced_quiet_zone, short r_min_ref, short r_max_ref)
	Retrieves the currently set parameters related to calculating grades on QR codes (extended). More...

short	CvcBcSetCodeGrading (CVC_BC_CONFIG config, BOOL active, BOOL symbol_contrast, BOOL axial_nonuniformity, BOOL grid_nonuniformity, BOOL unused_error_correction, BOOL print_growth, BOOL angle_of_distortion, short r_min_ref, short r_max_ref)
	This function sets all the parameters for the code grading (only active with Data Matrix barcode). More...

short	CvcBcSetCodeGradingEx (CVC_BC_CONFIG config, BOOL active, BOOL symbol_contrast, BOOL axial_nonuniformity, BOOL grid_nonuniformity, BOOL unused_error_correction, BOOL print_growth, BOOL angle_of_distortion, BOOL modulation, BOOL reflectance_margin, BOOL fixed_pattern_damage, short r_min_ref, short r_max_ref)
	Defines the parameters for calculating grades on Data Matrix codes (extended). More...

short	CvcBcSetQRCodeGrading (CVC_BC_CONFIG config, BOOL active, BOOL symbol_contrast, BOOL axial_nonuniformity, BOOL grid_nonuniformity, BOOL unused_error_correction, BOOL angle_of_distortion, BOOL modulation, BOOL fixed_pattern_damage, BOOL format_information, BOOL version_information, BOOL reduced_quiet_zone, short r_min_ref, short r_max_ref)
	Defines the parameters for calculating grades on QR codes. More...

short	CvcBcSetQRCodeGradingEx (CVC_BC_CONFIG config, BOOL active, BOOL symbol_contrast, BOOL axial_nonuniformity, BOOL grid_nonuniformity, BOOL unused_error_correction, BOOL angle_of_distortion, BOOL modulation, BOOL reflectance_margin, BOOL fixed_pattern_damage, BOOL format_information, BOOL version_information, BOOL reduced_quiet_zone, short r_min_ref, short r_max_ref)
	Defines the parameters for calculating grades on QR codes (extended). More...

Detailed Description

Function Documentation

◆ CvcBcGetCodeGrading()

void CvcBcGetCodeGrading	(	CVC_BC_CONFIG	config,
		BOOL *	active,
		BOOL *	symbol_contrast,
		BOOL *	axial_nonuniformity,
		BOOL *	grid_nonuniformity,
		BOOL *	unused_error_correction,
		BOOL *	print_growth,
		BOOL *	angle_of_distortion,
		short *	r_min_ref,
		short *	r_max_ref
	)

This function reads the parameters for code grading (only active with Data Matrix barcode).

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 CvcBcSetCodeGrading function.

Parameters

[in]	config	Handle to the configuration or `NULL` to use the default configuration.
[out]	active	Evaluate / don't evaluate evaluate code (default CVC_BC_ON).
[out]	symbol_contrast	Evaluate / don't evaluate symbol contrast.
[out]	axial_nonuniformity	Evaluate / don't evaluate axial nonuniformity.
[out]	grid_nonuniformity	Evaluate / don't evaluate grid nonuniformity.
[out]	unused_error_correction	Evaluate / don't evaluate unused error correction.
[out]	print_growth	Evaluate / don't evaluate print growth.
[out]	angle_of_distortion	Evaluate / don't evaluate angle of distortion.
[out]	r_min_ref	Minimum r ref value for the symbol contrast calculation (ranging from `0` from `254`, default `0`).
[out]	r_max_ref	Maximum r ref value for the symbol contrast calculation (ranging from `1` from `255`, default `255`).

Supported platforms:: Win32
Win64

Related Topics:: CvcBcSetCodeGrading

◆ CvcBcGetCodeGradingEx()

void CvcBcGetCodeGradingEx	(	CVC_BC_CONFIG	config,
		BOOL *	active,
		BOOL *	symbol_contrast,
		BOOL *	axial_nonuniformity,
		BOOL *	grid_nonuniformity,
		BOOL *	unused_error_correction,
		BOOL *	print_growth,
		BOOL *	angle_of_distortion,
		BOOL *	modulation,
		BOOL *	reflectance_margin,
		BOOL *	fixed_pattern_damage,
		short *	r_min_ref,
		short *	r_max_ref
	)

Retrieves the currently set parameters related to calculating grades on Data Matrix codes (extended).

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 CvcBcSetCodeGradingEx function.

Parameters

[in]	config	Handle to the configuration or `NULL` to use the default configuration.
[out]	active	Evaluate / don't evaluate evaluate code (default CVC_BC_ON).
[out]	symbol_contrast	Evaluate / don't evaluate symbol contrast.
[out]	axial_nonuniformity	Evaluate / don't evaluate axial nonuniformity.
[out]	grid_nonuniformity	Evaluate / don't evaluate grid nonuniformity.
[out]	unused_error_correction	Evaluate / don't evaluate unused error correction.
[out]	print_growth	Evaluate / don't evaluate print growth.
[out]	angle_of_distortion	Evaluate / don't evaluate angle of distortion.
[out]	modulation	Evaluate / don't evaluate modulation.
[out]	reflectance_margin	Evaluate / don't evaluate reflectance margin.
[out]	fixed_pattern_damage	Evaluate / don't evaluate fixed pattern damage.
[out]	r_min_ref	Minimum r ref value for the symbol contrast calculation (ranging from `0` from `254`, default `0`).
[out]	r_max_ref	Maximum r ref value for the symbol contrast calculation (ranging from `1` from `255`, default `255`).

Supported platforms:: Win32
Win64

Related Topics:: CvcBcSetCodeGradingEx

◆ CvcBcGetQRCodeGrading()

void CvcBcGetQRCodeGrading	(	CVC_BC_CONFIG	config,
		BOOL *	active,
		BOOL *	symbol_contrast,
		BOOL *	axial_nonuniformity,
		BOOL *	grid_nonuniformity,
		BOOL *	unused_error_correction,
		BOOL *	angle_of_distortion,
		BOOL *	modulation,
		BOOL *	fixed_pattern_damage,
		BOOL *	format_information,
		BOOL *	version_information,
		BOOL *	reduced_quiet_zone,
		short *	r_min_ref,
		short *	r_max_ref
	)

Retrieves the currently set parameters related to calculating grades on QR codes.

Parameters

[in]	config	Handle to the configuration or `NULL` to use the default configuration.
[out]	active	Flag that tells whether or not code grading is active.
[out]	symbol_contrast	Flag that tells whether or not the calculation of the `symbol_contrast` grade is active.
[out]	axial_nonuniformity	Flag that tells whether or not the calculation of the `axial_nonuniformity` grade is active.
[out]	grid_nonuniformity	Flag that tells whether or not the calculation of the `grid_nonuniformity` grade is active.
[out]	unused_error_correction	Flag that tells whether or not the calculation of the `unused_error_correction` grade is active.
[out]	angle_of_distortion	Flag that tells whether or not the calculation of the angle of distortion is active. This value does not enter the calculation of the `scan_grade` value.
[out]	modulation	Flag that tells whether or not the calculation of the `modulation` grade is active.
[out]	fixed_pattern_damage	Flag that tells whether or not the calculation of the `fixed_pattern_damage` grade is active.
[out]	format_information	Flag that tells whether or not the calculation of the `format_information` grade is active.
[out]	version_information	Flag that tells whether or not the calculation of the `version_information` grade is active.
[out]	reduced_quiet_zone	If this flag is set to `true`, the quiet zone expected by CVC Barcode may be reduced to one module size (standard are 4 module sizes for QR codes and 2 module sizes for micro QR codes).
[out]	r_min_ref	Minimum reference value for the calculation of the symbol contrast (value range: 0...254; default value: 0).
[out]	r_max_ref	Minimum reference value for the calculation of the symbol contrast (value range: 1...255; default value: 255).

Supported platforms:: Win32
Win64

Related Topics:: CvcBcSetQRCodeGrading
CVC_BC_QUALITY_INFO

◆ CvcBcGetQRCodeGradingEx()

void CvcBcGetQRCodeGradingEx	(	CVC_BC_CONFIG	config,
		BOOL *	active,
		BOOL *	symbol_contrast,
		BOOL *	axial_nonuniformity,
		BOOL *	grid_nonuniformity,
		BOOL *	unused_error_correction,
		BOOL *	angle_of_distortion,
		BOOL *	modulation,
		BOOL *	reflectance_margin,
		BOOL *	fixed_pattern_damage,
		BOOL *	format_information,
		BOOL *	version_information,
		BOOL *	reduced_quiet_zone,
		short *	r_min_ref,
		short *	r_max_ref
	)

Retrieves the currently set parameters related to calculating grades on QR codes (extended).

Parameters

[in]	config	Handle to the configuration or `NULL` to use the default configuration.
[out]	active	Flag that tells whether or not code grading is active.
[out]	symbol_contrast	Flag that tells whether or not the calculation of the `symbol_contrast` grade is active.
[out]	axial_nonuniformity	Flag that tells whether or not the calculation of the `axial_nonuniformity` grade is active.
[out]	grid_nonuniformity	Flag that tells whether or not the calculation of the `grid_nonuniformity` grade is active.
[out]	unused_error_correction	Flag that tells whether or not the calculation of the `unused_error_correction` grade is active.
[out]	angle_of_distortion	Flag that tells whether or not the calculation of the angle of distortion is active. This value does not enter the calculation of the `scan_grade` value.
[out]	modulation	Flag that tells whether or not the calculation of the `modulation` grade is active.
[out]	reflectance_margin	Flag that tells whether or not the calculation of the `reflectance_margin` is active.
[out]	fixed_pattern_damage	Flag that tells whether or not the calculation of the `fixed_pattern_damage` grade is active.
[out]	format_information	Flag that tells whether or not the calculation of the `format_information` grade is active.
[out]	version_information	Flag that tells whether or not the calculation of the `version_information` grade is active.
[out]	reduced_quiet_zone	If this flag is set to `true`, the quiet zone expected by CVC Barcode may be reduced to one module size (standard are 4 module sizes for QR codes and 2 module sizes for micro QR codes).
[out]	r_min_ref	Minimum reference value for the calculation of the symbol contrast (value range: 0...254; default value: 0).
[out]	r_max_ref	Minimum reference value for the calculation of the symbol contrast (value range: 1...255; default value: 255).

Supported platforms:: Win32
Win64

Related Topics:: CvcBcSetQRCodeGradingEx
CVC_BC_QUALITY_INFO

◆ CvcBcSetCodeGrading()

short CvcBcSetCodeGrading	(	CVC_BC_CONFIG	config,
		BOOL	active,
		BOOL	symbol_contrast,
		BOOL	axial_nonuniformity,
		BOOL	grid_nonuniformity,
		BOOL	unused_error_correction,
		BOOL	print_growth,
		BOOL	angle_of_distortion,
		short	r_min_ref,
		short	r_max_ref
	)

This function sets all the parameters for the code grading (only active with Data Matrix barcode).

Parameters

[in]	config	Handle to the configuration or `NULL` to use the default configuration.
[in]	active	Evaluate / don't evaluate evaluate code (default CVC_BC_ON). The active parameter activates the code grading with the selected parameters. If the code grading is active the scan grade will be calculate. The parameters symbol_contrast, axial_nonuniformity, grid_nonuniformity, unused_error_correction, print_growth, and angle_of_distrotion can be selected separately.
[in]	symbol_contrast	Evaluate / don't evaluate symbol contrast. The parameter symbol_contrast = `TRUE` specifies that the symbol contrast will be calculated and considered in the scan grade.
[in]	axial_nonuniformity	Evaluate / don't evaluate axial nonuniformity. The parameter axial_nonuniformity = `TRUE` specifies that the axial nonuniformity will be calculated and considered in the scan grade.
[in]	grid_nonuniformity	Evaluate / don't evaluate grid nonuniformity. The parameter grid_nonuniformity = `TRUE` specifies that the grid nonuniformity will be calculated and considered in the scan grade.
[in]	unused_error_correction	Evaluate / don't evaluate unused error correction. The parameter unused_error_correction = `TRUE` specifies that the unused error correction will be calculated and considered in the scan grade.
[in]	print_growth	Evaluate / don't evaluate print growth. The parameter print_growth = `TRUE` specifies that the print growth will be calculated and considered in the scan grade.
[in]	angle_of_distortion	Evaluate / don't evaluate angle of distortion. The parameter angle_of_distortion = `TRUE` specifies that the angle of distortion will be calculated but it will be not considered in the scan grade.
[in]	r_min_ref	Minimum r ref value for the symbol contrast calculation (ranging from `0` from `254`, default `0`). You can use the r_min_ref and r_max_ref parameters to calibrate the reference values of the colours black and white for the symbol contrast. The r_min_ref (black) can be in the range between `0` and `254`, default `0`. The r_max_ref (white) can be in the range between `1` and `255`, default `255`. The value r_max_ref must always be higher than the value 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`.
[in]	r_max_ref	Maximum r ref value for the symbol contrast calculation (ranging from `1` from `255`, default `255`). You can use the r_min_ref and r_max_ref parameters to calibrate the reference values of the colours black and white for the symbol contrast. The r_min_ref (black) can be in the range between `0` and `254`, default `0`. The r_max_ref (white) can be in the range between `1` and `255`, default `255`. The value r_max_ref must always be higher than the value 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`.

Returns: CVC_BC_NO_ERROR on success, otherwise CVC_BC_PARAMETER_WARNING.

Supported platforms:: Win32
Win64

Related Topics:: CvcBcGetCodeGrading
Code grading specification
CVC_BC_INFO Structure for Code Grading

◆ CvcBcSetCodeGradingEx()

short CvcBcSetCodeGradingEx	(	CVC_BC_CONFIG	config,
		BOOL	active,
		BOOL	symbol_contrast,
		BOOL	axial_nonuniformity,
		BOOL	grid_nonuniformity,
		BOOL	unused_error_correction,
		BOOL	print_growth,
		BOOL	angle_of_distortion,
		BOOL	modulation,
		BOOL	reflectance_margin,
		BOOL	fixed_pattern_damage,
		short	r_min_ref,
		short	r_max_ref
	)

Defines the parameters for calculating grades on Data Matrix codes (extended).

Parameters

[in]	config	Handle to the configuration or `NULL` to use the default configuration.
[in]	active	Evaluate / don't evaluate code (default CVC_BC_ON). The active parameter activates the code grading with the selected parameters. If the code grading is active the scan grade will be calculate. The parameters symbol_contrast, axial_nonuniformity, grid_nonuniformity, unused_error_correction, print_growth, and angle_of_distortion can be selected separately.
[in]	symbol_contrast	Evaluate / don't evaluate symbol contrast. The parameter symbol_contrast = `TRUE` specifies that the symbol contrast will be calculated and considered in the scan grade.
[in]	axial_nonuniformity	Evaluate / don't evaluate axial nonuniformity. The parameter axial_nonuniformity = `TRUE` specifies that the axial nonuniformity will be calculated and considered in the scan grade.
[in]	grid_nonuniformity	Evaluate / don't evaluate grid nonuniformity. The parameter grid_nonuniformity = `TRUE` specifies that the grid nonuniformity will be calculated and considered in the scan grade.
[in]	unused_error_correction	Evaluate / don't evaluate unused error correction. The parameter unused_error_correction = `TRUE` specifies that the unused error correction will be calculated and considered in the scan grade.
[in]	print_growth	Evaluate / don't evaluate print growth. The parameter print_growth = `TRUE` specifies that the print growth will be calculated and considered in the scan grade.
[in]	angle_of_distortion	Evaluate / don't evaluate angle of distortion. The parameter angle_of_distortion = `TRUE` specifies that the angle of distortion will be calculated but it will be not considered in the scan grade.
[in]	modulation	Evaluate / don't evaluate modulation. The parameter modulation = `TRUE` specifies that the modulation will be calculated and considered in the scan grade.
[in]	reflectance_margin	Evaluate / don't evaluate reflectance margin. The parameter reflectance_margin = `TRUE` specifies that the reflectance margin will be calculated and considered in the scan grade.
[in]	fixed_pattern_damage	Evaluate / don't evaluate fixed pattern damage. The parameter fixed_pattern_damage = `TRUE` specifies that the fixed pattern damage will be calculated and considered in the scan grade.
[in]	r_min_ref	Minimum r ref value for the symbol contrast calculation (ranging from `0` from `254`, default `0`). You can use the r_min_ref and r_max_ref parameters to calibrate the reference values of the colours black and white for the symbol contrast. The r_min_ref (black) can be in the range between `0` and `254`, default `0`. The r_max_ref (white) can be in the range between `1` and `255`, default `255`. The value r_max_ref must always be higher than the value 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`.
[in]	r_max_ref	Maximum r ref value for the symbol contrast calculation (ranging from `1` from `255`, default `255`). You can use the r_min_ref and r_max_ref parameters to calibrate the reference values of the colours black and white for the symbol contrast. The r_min_ref (black) can be in the range between `0` and `254`, default `0`. The r_max_ref (white) can be in the range between `1` and `255`, default `255`. The value r_max_ref must always be higher than the value 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`.

Returns: CVC_BC_NO_ERROR on success, otherwise CVC_BC_PARAMETER_WARNING.

Supported platforms:: Win32
Win64

Related Topics:: CvcBcGetCodeGradingEx
Code grading specification
CVC_BC_INFO Structure for Code Grading

◆ CvcBcSetQRCodeGrading()

short CvcBcSetQRCodeGrading	(	CVC_BC_CONFIG	config,
		BOOL	active,
		BOOL	symbol_contrast,
		BOOL	axial_nonuniformity,
		BOOL	grid_nonuniformity,
		BOOL	unused_error_correction,
		BOOL	angle_of_distortion,
		BOOL	modulation,
		BOOL	fixed_pattern_damage,
		BOOL	format_information,
		BOOL	version_information,
		BOOL	reduced_quiet_zone,
		short	r_min_ref,
		short	r_max_ref
	)

Defines the parameters for calculating grades on QR codes.

By default, grading for QR is disabled. Enable it by calling this function and setting the active parameter to true.

When grading QR codes, it should be the aim to have the code plus the code's entire quiet zone (usually 4 module sizes for standard size codes and 2 module sizes for micro QR codes) contained inside the area of interest used for grading. If this is not the case, CVC Barcode will distinguish two situations:

the quiet zone extends beyones the area of interest, but the code is fully visible inside the area of interest.
Parts of the code are outside the area of interest.

In case 1. the fact that part of the quiet zone is outside the area of interest will not reduce the grading result. The code_quiet_zone_out_of_aoi member of the grading result will be set to true to indicate the situation, and only the part of the quiet zone that lies within the area of interest will be taken into account when calculating grading results. Generally speaking, however, it is preferable to have the whole quiet zone inside the are of interest.

In case 2 the code_out_of_aoi member of the result will be set to true. Only the parts of the code that lie within the area of interest will be used for grading, but code words that lie outside the area of interest will usually reduce the unused_error_correction grade.

Parameters

[in]	config	Handle to the configuration or `NULL` to use the default configuration.
[in]	active	Activates (`true`) or deactivates (`false`) code grading. By default, code grading is deactivated.
[in]	symbol_contrast	Activates (`true`) or deactivates (`false`) the calculation of the `symbol_contrast` grade.
[in]	axial_nonuniformity	Activates (`true`) or deactivates (`false`) the calculation of the `axial_nonuniformity` grade.
[in]	grid_nonuniformity	Activates (`true`) or deactivates (`false`) the calculation of the `grid_nonuniformity` grade.
[in]	unused_error_correction	Activates (`true`) or deactivates (`false`) the calculation of the `unused_error_correction` grade.
[in]	angle_of_distortion	Activates (`true`) or deactivates (`false`) the calculation of the angle of distortion. This value does not enter the calculation of the `scan_grade` value.
[in]	modulation	Activates (`true`) or deactivates (`false`) the calculation of the `modulation` grade.
[in]	fixed_pattern_damage	Activates (`true`) or deactivates (`false`) the calculation of the `fixed_pattern_damage` grade.
[in]	format_information	Activates (`true`) or deactivates (`false`) the calculation of the `format_information` grade.
[in]	version_information	Activates (`true`) or deactivates (`false`) the calculation of the `version_information` grade.
[in]	reduced_quiet_zone	With this flag the quiet zone expected by CVC Barcode may be reduced to one module size (standard are 4 module sizes for QR codes and 2 module sizes for micro QR codes).
[in]	r_min_ref	Minimum reference value for the calculation of the symbol contrast (value range: 0...254; default value: 0).
[in]	r_max_ref	Minimum reference value for the calculation of the symbol contrast (value range: 1...255; default value: 255).

Returns: CVC_BC_NO_ERROR on success, otherwise CVC_BC_PARAMETER_WARNING.

Supported platforms:: Win32
Win64

Related Topics:: CvcBcGetQRCodeGrading
CVC_BC_QUALITY_INFO

◆ CvcBcSetQRCodeGradingEx()

short CvcBcSetQRCodeGradingEx	(	CVC_BC_CONFIG	config,
		BOOL	active,
		BOOL	symbol_contrast,
		BOOL	axial_nonuniformity,
		BOOL	grid_nonuniformity,
		BOOL	unused_error_correction,
		BOOL	angle_of_distortion,
		BOOL	modulation,
		BOOL	reflectance_margin,
		BOOL	fixed_pattern_damage,
		BOOL	format_information,
		BOOL	version_information,
		BOOL	reduced_quiet_zone,
		short	r_min_ref,
		short	r_max_ref
	)

Defines the parameters for calculating grades on QR codes (extended).

By default, grading for QR is disabled. Enable it by calling this function and setting the active parameter to true.

When grading QR codes, it should be the aim to have the code plus the code's entire quiet zone (usually 4 module sizes for standard size codes and 2 module sizes for micro QR codes) contained inside the area of interest used for grading. If this is not the case, CVC Barcode will distinguish two situations:

The quiet zone extends beyond the area of interest, but the code is fully visible inside the area of interest.
Parts of the code are outside the area of interest.

In case 1. the fact that part of the quiet zone is outside the area of interest will not reduce the grading result. The code_quiet_zone_out_of_aoi member of the grading result will be set to true to indicate the situation, and only the part of the quiet zone that lies within the area of interest will be taken into account when calculating grading results. Generally speaking, however, it is preferable to have the whole quiet zone inside the are of interest.

In case 2 the code_out_of_aoi member of the result will be set to true. Only the parts of the code that lie within the area of interest will be used for grading, but code words that lie outside the area of interest will usually reduce the unused_error_correction grade.

Parameters

[in]	config	Handle to the configuration or `NULL` to use the default configuration.
[in]	active	Activates (`true`) or deactivates (`false`) code grading. By default, code grading is deactivated.
[in]	symbol_contrast	Activates (`true`) or deactivates (`false`) the calculation of the `symbol_contrast` grade.
[in]	axial_nonuniformity	Activates (`true`) or deactivates (`false`) the calculation of the `axial_nonuniformity` grade.
[in]	grid_nonuniformity	Activates (`true`) or deactivates (`false`) the calculation of the `grid_nonuniformity` grade.
[in]	unused_error_correction	Activates (`true`) or deactivates (`false`) the calculation of the `unused_error_correction` grade.
[in]	angle_of_distortion	Activates (`true`) or deactivates (`false`) the calculation of the angle of distortion. This value does not enter the calculation of the `scan_grade` value.
[in]	modulation	Activates (`true`) or deactivates (`false`) the calculation of the `modulation` grade.
[in]	reflectance_margin	Activates (`true`) or deactivates (`false`) the calculation of the `reflectance` margin.
[in]	fixed_pattern_damage	Activates (`true`) or deactivates (`false`) the calculation of the `fixed_pattern_damage` grade.
[in]	format_information	Activates (`true`) or deactivates (`false`) the calculation of the `format_information` grade.
[in]	version_information	Activates (`true`) or deactivates (`false`) the calculation of the `version_information` grade.
[in]	reduced_quiet_zone	With this flag the quiet zone expected by CVC Barcode may be reduced to one module size (standard are 4 module sizes for QR codes and 2 module sizes for micro QR codes).
[in]	r_min_ref	Minimum reference value for the calculation of the symbol contrast (value range: 0...254; default value: 0).
[in]	r_max_ref	Minimum reference value for the calculation of the symbol contrast (value range: 1...255; default value: 255).

Returns: CVC_BC_NO_ERROR on success, otherwise CVC_BC_PARAMETER_WARNING.

Supported platforms:: Win32
Win64

Related Topics:: CvcBcGetQRCodeGradingEx
CVC_BC_QUALITY_INFO


Contact Legal Privacy Statement	Copyright © 2024.
	All rights reserved.

Functions

Detailed Description

Function Documentation

◆ CvcBcGetCodeGrading()

◆ CvcBcGetCodeGradingEx()

◆ CvcBcGetQRCodeGrading()

◆ CvcBcGetQRCodeGradingEx()

◆ CvcBcSetCodeGrading()

◆ CvcBcSetCodeGradingEx()

◆ CvcBcSetQRCodeGrading()

◆ CvcBcSetQRCodeGradingEx()