get_bar_code_param_specificget_bar_code_param_specificget_bar_code_param_specificGetBarCodeParamSpecificGetBarCodeParamSpecific (Operator)

Name

get_bar_code_param_specificget_bar_code_param_specificget_bar_code_param_specificGetBarCodeParamSpecificGetBarCodeParamSpecific — Get parameters that are used by the bar code reader when processing a specific bar code type.

Signature

Description

The operator get_bar_code_param_specificget_bar_code_param_specificget_bar_code_param_specificGetBarCodeParamSpecificGetBarCodeParamSpecific allows to query parameters of a bar code model, which are of relevance for a successful search and decoding of a respective class of bar codes. Contrary to get_bar_code_paramget_bar_code_paramget_bar_code_paramGetBarCodeParamGetBarCodeParam, get_bar_code_param_specificget_bar_code_param_specificget_bar_code_param_specificGetBarCodeParamSpecificGetBarCodeParamSpecific allows a bar code type specific query for the following parameters. This is useful when searching different code types in one image. The bar code types are specified in CodeTypesCodeTypesCodeTypesCodeTypescodeTypes. The names of the desired parameters are passed in the generic parameter GenParamNamesGenParamNamesGenParamNamesGenParamNamesgenParamNames and the corresponding values are returned in GenParamValuesGenParamValuesGenParamValuesGenParamValuesgenParamValues. All of these parameters can be set and changed selectively with the operator set_bar_code_param_specificset_bar_code_param_specificset_bar_code_param_specificSetBarCodeParamSpecificSetBarCodeParamSpecific or for all bar code types with the operator set_bar_code_paramset_bar_code_paramset_bar_code_paramSetBarCodeParamSetBarCodeParam. Which parameters are set specifically can be determined at runtime with the operator query_bar_code_paramsquery_bar_code_paramsquery_bar_code_paramsQueryBarCodeParamsQueryBarCodeParams. These parameters cannot be read with get_bar_code_paramget_bar_code_paramget_bar_code_paramGetBarCodeParamGetBarCodeParam, but must be read with get_bar_code_param_specificget_bar_code_param_specificget_bar_code_param_specificGetBarCodeParamSpecificGetBarCodeParamSpecific.

The following parameters can be queried:

'num_scanlines'"num_scanlines""num_scanlines""num_scanlines""num_scanlines":

Maximal number of scanlines used during the scanning of a (candidate) bar code.

'min_identical_scanlines'"min_identical_scanlines""min_identical_scanlines""min_identical_scanlines""min_identical_scanlines":

Minimal number of successfully decoded scanlines, which return identical data for a bar code to be considered as successfully decoded.

'stop_after_result_num'"stop_after_result_num""stop_after_result_num""stop_after_result_num""stop_after_result_num":

Number of successfully decoded bar codes of the given code type after which the decoding will stop. 0 is the default where the reader tries to decode all candidates.

'orientation'"orientation""orientation""orientation""orientation":

Accepted orientation of the decoded bar codes.

'orientation_tol'"orientation_tol""orientation_tol""orientation_tol""orientation_tol":

Tolerance of the accepted orientation.

'start_stop_tolerance'"start_stop_tolerance""start_stop_tolerance""start_stop_tolerance""start_stop_tolerance":

Start/stop search criteria tolerance. Currently it is implemented only for Code 128.

'check_char'"check_char""check_char""check_char""check_char":

Presence of a check character.

'composite_code'"composite_code""composite_code""composite_code""composite_code":

Presence and type of a 2D composite code appended to the bar code.

Further details on the above parameters can be found with the description of set_bar_code_paramset_bar_code_paramset_bar_code_paramSetBarCodeParamSetBarCodeParam operator.

Attention

A bar code model 'BarCodeHandle'"BarCodeHandle""BarCodeHandle""BarCodeHandle""BarCodeHandle" cannot be shared between two or more user's threads. Different bar code models can be used independently and safely in different threads.

Parallelization

• Multithreading type: reentrant (runs in parallel with non-exclusive operators).
• Multithreading scope: global (may be called from any thread).
• Processed without parallelization.

Parameters

Result

The operator get_bar_code_param_specificget_bar_code_param_specificget_bar_code_param_specificGetBarCodeParamSpecificGetBarCodeParamSpecific returns the value 2 (H_MSG_TRUE) if the given parameters are correct. Otherwise, an exception will be raised.

Possible Predecessors

create_bar_code_modelcreate_bar_code_modelcreate_bar_code_modelCreateBarCodeModelCreateBarCodeModel, set_bar_code_paramset_bar_code_paramset_bar_code_paramSetBarCodeParamSetBarCodeParam, set_bar_code_param_specificset_bar_code_param_specificset_bar_code_param_specificSetBarCodeParamSpecificSetBarCodeParamSpecific

Alternatives

get_bar_code_paramget_bar_code_paramget_bar_code_paramGetBarCodeParamGetBarCodeParam

Module

Bar Code