Functions | |
CVC_BC_CONFIG | CvcBcCreateConfiguration (BOOL all_barcodes) |
This function creates a new configuration and returns its handle. More... | |
void | CvcBcDeleteConfiguration (CVC_BC_CONFIG config) |
This function deletes an existing configuration generated using CvcBcCreateConfiguration, thus freeing the occupied memory space. More... | |
void | CvcBcGetCodePositionCheck (CVC_BC_CONFIG config, BOOL *active) |
This function sets all parameters for the Code Position Check. More... | |
void | CvcBcGetTimeLimit (CVC_BC_CONFIG config, short *time_limit) |
This function reads the maximum time in milliseconds available for an evaluation when using the configuration config. More... | |
short | CvcBcLoadConfiguration (CVC_BC_CONFIG config, LPSTR filename) |
This function reads the configuration data from the file filename into the configuration config. More... | |
short | CvcBcSaveConfiguration (CVC_BC_CONFIG config, LPSTR filename) |
This function writes the data from the configuration config to the file filename. More... | |
short | CvcBcSetCodePositionCheck (CVC_BC_CONFIG config, BOOL active) |
This function sets all parameters for the Code Position Check. More... | |
void | CvcBcSetTimeLimit (CVC_BC_CONFIG config, short time_limit) |
This function sets the maximum evaluation time for the decoding of a barcode. More... | |
CVC_BC_CONFIG CvcBcCreateConfiguration | ( | BOOL | all_barcodes | ) |
This function creates a new configuration and returns its handle.
[in] | all_barcodes | Specifies whether all or no barcodes are to be initially permitted in this configuration (CVC_BC_ALLOW_ALL or CVC_BC_DENY_ALL). |
void CvcBcDeleteConfiguration | ( | CVC_BC_CONFIG | config | ) |
This function deletes an existing configuration generated using CvcBcCreateConfiguration, thus freeing the occupied memory space.
[in] | config | Handle to the configuration to be deleted. |
void CvcBcGetCodePositionCheck | ( | CVC_BC_CONFIG | config, |
BOOL * | active | ||
) |
This function sets all parameters for the Code Position Check.
[in] | config | Handle to the configuration or NULL to use the default configuration. |
[out] | active | Evaluate / don't evaluate evaluate code position check. The parameter active enables and disables the code position check configuration config. Specifying TRUE enables and FALSE disables the code position check. |
void CvcBcGetTimeLimit | ( | CVC_BC_CONFIG | config, |
short * | time_limit | ||
) |
short CvcBcLoadConfiguration | ( | CVC_BC_CONFIG | config, |
LPSTR | filename | ||
) |
This function reads the configuration data from the file filename into the configuration config.
[out] | config | Handle to the configuration which is to be read from the file. Note that the handle passed here needs to have been allocated first with a call to CvcBcCreateConfiguration. |
[in] | filename | Name of the file, possibly with path specification. |
short CvcBcSaveConfiguration | ( | CVC_BC_CONFIG | config, |
LPSTR | filename | ||
) |
This function writes the data from the configuration config to the file filename.
The data is stored in an ASCII format which is based on the format of the Windows INI files. If necessary, it can be edited using a simple ASCII editor such as NOTEPAD.EXE.
[in] | config | Handle to the configuration which is to be written from the file or NULL to use the default configuration. |
[in] | filename | Name of the file, possibly with path specification. |
short CvcBcSetCodePositionCheck | ( | CVC_BC_CONFIG | config, |
BOOL | active | ||
) |
This function sets all parameters for the Code Position Check.
[in] | config | Handle to the configuration or NULL to use the default configuration. |
[in] | active | Evaluate / don't evaluate evaluate code position check. The parameter active enables and disables the code position check configuration config. Specifying TRUE enables and FALSE disables the code position check. |
void CvcBcSetTimeLimit | ( | CVC_BC_CONFIG | config, |
short | time_limit | ||
) |
This function sets the maximum evaluation time for the decoding of a barcode.
It sets the maximum time which may be required for evaluation when using the configuration config. When the configuration cannot be concluded in this time, the function CvcBcDecodeBarcode returns the value 0
(no code decoded), even if the code is present in the image.
For time measurement, Barcode uses the function clock() from the standard C library. On PC systems this generally has temporary resolution of approximately 55 ms. There is therefore no point specifying values less than 55 ms. On high performance PC systems, the evaluation time is generally below 50
ms. Thus this function is only of use in connection with slow systems.
The actual decoding time may deviate from the specified time by plus/minus 55
ms.
When configuration is generated, the value of 1000
milliseconds is entered as the default decoding time. This value should always be achieved on modern PC systems.
[in] | config | Handle to the configuration, or NULL to use the default configuration. |
[in] | time_limit | Maximum decoding time in milliseconds. |