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]	config	Handle to the configuration or NULL to use the default configuration.
[in]	active	Evaluate / don't evaluate evaluate 1D Code Grading.
[in]	r_min_ref	Minimum r ref value for the symbol contrast calculation (range 0 - 254, default 0).
[in]	r_max_ref	Maximum 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]	config	Handle to the configuration or NULL to use the default configuration.
[out]	active	Evaluate / don't evaluate evaluate 1D Code Grading.
[out]	r_min_ref	Minimum r ref value for the symbol contrast calculation (range 0 - 254, default 0).
[out]	r_max_ref	Maximum r ref value for the symbol contrast calculation (range 1 - 255, default 255).
[out]	grade_decodes	Flag specifying whether or not the grade decodes will enter the calculation of grade_overall.
[out]	grade_reflectance_min	Flag specifying whether or not the grade reflectance_min will enter the calculation of grade_overall.
[out]	grade_symbol_contrast	Flag specifying whether or not the grade symbol_contrast will enter the calculation of grade_overall.
[out]	grade_edge_contrast_min	Flag specifying whether or not the grade edge_contrast_min will enter the calculation of grade_overall.
[out]	grade_modulation	Flag specifying whether or not the grade modulation will enter the calculation of grade_overall.
[out]	grade_defects	Flag specifying whether or not the grade defects will enter the calculation of grade_overall.
[out]	grade_decodability	Flag 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]	config	Handle to the configuration or NULL to use the default configuration.
[in]	active	Evaluate / 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_ref	Minimum r ref value for the symbol contrast calculation (range 0 - 254, default 0).
[in]	r_max_ref	Maximum 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]	config	Handle to the configuration or NULL to use the default configuration.
[in]	active	Evaluate / 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_ref	Minimum r ref value for the symbol contrast calculation (range 0 - 254, default 0).
[in]	r_max_ref	Maximum r ref value for the symbol contrast calculation (range 1 - 255, default 255).
[in]	grade_decodes	Flag specifying whether or not the grade decodes will enter the calculation of grade_overall.
[in]	grade_reflectance_min	Flag specifying whether or not the grade reflectance_min will enter the calculation of grade_overall.
[in]	grade_symbol_contrast	Flag specifying whether or not the grade symbol_contrast will enter the calculation of grade_overall.
[in]	grade_edge_contrast_min	Flag specifying whether or not the grade edge_contrast_min will enter the calculation of grade_overall.
[in]	grade_modulation	Flag specifying whether or not the grade modulation will enter the calculation of grade_overall.
[in]	grade_defects	Flag specifying whether or not the grade defects will enter the calculation of grade_overall.
[in]	grade_decodability	Flag 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