get_bar_code_paramT_get_bar_code_paramGetBarCodeParamGetBarCodeParamget_bar_code_param (Operator)

Name

get_bar_code_paramT_get_bar_code_paramGetBarCodeParamGetBarCodeParamget_bar_code_param — Get one or several parameters that describe the bar code model.

Signature

get_bar_code_param( : : BarCodeHandle, GenParamName : GenParamValue)

Herror T_get_bar_code_param(const Htuple BarCodeHandle, const Htuple GenParamName, Htuple* GenParamValue)

void GetBarCodeParam(const HTuple& BarCodeHandle, const HTuple& GenParamName, HTuple* GenParamValue)

HTuple HBarCode::GetBarCodeParam(const HTuple& GenParamName) const

HTuple HBarCode::GetBarCodeParam(const HString& GenParamName) const

HTuple HBarCode::GetBarCodeParam(const char* GenParamName) const

HTuple HBarCode::GetBarCodeParam(const wchar_t* GenParamName) const   (Windows only)

static void HOperatorSet.GetBarCodeParam(HTuple barCodeHandle, HTuple genParamName, out HTuple genParamValue)

HTuple HBarCode.GetBarCodeParam(HTuple genParamName)

HTuple HBarCode.GetBarCodeParam(string genParamName)

def get_bar_code_param(bar_code_handle: HHandle, gen_param_name: MaybeSequence[str]) -> Sequence[Union[float, int, str]]

def get_bar_code_param_s(bar_code_handle: HHandle, gen_param_name: MaybeSequence[str]) -> Union[float, int, str]

Description

The operator get_bar_code_paramget_bar_code_paramGetBarCodeParamGetBarCodeParamGetBarCodeParamget_bar_code_param 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.

The names of the desired parameters are passed in the generic parameter GenParamNameGenParamNameGenParamNameGenParamNamegenParamNamegen_param_name and the corresponding values are returned in GenParamValueGenParamValueGenParamValueGenParamValuegenParamValuegen_param_value. All of these parameters can be set and changed at any time with the operator set_bar_code_paramset_bar_code_paramSetBarCodeParamSetBarCodeParamSetBarCodeParamset_bar_code_param.

Parameters that have been set bar code type specifically by set_bar_code_param_specificset_bar_code_param_specificSetBarCodeParamSpecificSetBarCodeParamSpecificSetBarCodeParamSpecificset_bar_code_param_specific or by automatic parameter training cannot be read with get_bar_code_paramget_bar_code_paramGetBarCodeParamGetBarCodeParamGetBarCodeParamget_bar_code_param, but must be read with get_bar_code_param_specificget_bar_code_param_specificGetBarCodeParamSpecificGetBarCodeParamSpecificGetBarCodeParamSpecificget_bar_code_param_specific. All parameters listed with the operator get_bar_code_param_specificget_bar_code_param_specificGetBarCodeParamSpecificGetBarCodeParamSpecificGetBarCodeParamSpecificget_bar_code_param_specific can always be set specifically. Which parameters are actually set specifically can be determined at runtime with the operator query_bar_code_paramsquery_bar_code_paramsQueryBarCodeParamsQueryBarCodeParamsQueryBarCodeParamsquery_bar_code_params.

The following parameters can be queried - ordered by different categories:

Size of the bar code elements:

'element_size_min'"element_size_min""element_size_min""element_size_min""element_size_min""element_size_min":

Minimal size of the base bar code elements, i.e., the minimal width of the narrowest bars and spaces for the specific bar code type.

'element_size_max'"element_size_max""element_size_max""element_size_max""element_size_max""element_size_max":

Maximal size of the base bar code elements, i.e., the maximal width of the narrowest bars and spaces for the specific bar code type.

'element_size_variable'"element_size_variable""element_size_variable""element_size_variable""element_size_variable""element_size_variable":

Specifies if the element size varies across a single bar code.

'barcode_height_min'"barcode_height_min""barcode_height_min""barcode_height_min""barcode_height_min""barcode_height_min":

Minimal height of the bar code.

'barcode_width_min'"barcode_width_min""barcode_width_min""barcode_width_min""barcode_width_min""barcode_width_min":

Minimal bar code width.

Scanning settings:

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

Maximal number of scans per (candidate) bar code.

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

Minimal number of decoded scanlines which return identical data to read the bar code successfully.

'majority_voting'"majority_voting""majority_voting""majority_voting""majority_voting""majority_voting":

Decode result selection mode. Specifies whether majority voting is used in the selection of different scanline results.

'stop_after_result_num'"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 after which the decoding will stop. 0 is the default where the reader tries to decode all candidates.

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

Accepted orientation of the decoded bar codes.

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

Tolerance of the accepted orientation.

'quiet_zone'"quiet_zone""quiet_zone""quiet_zone""quiet_zone""quiet_zone":

Quiet zone verification mode.

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

Start/Stop search criteria tolerance.

'min_code_length'"min_code_length""min_code_length""min_code_length""min_code_length""min_code_length":

Minimal number of decoded characters.

'merge_scanlines'"merge_scanlines""merge_scanlines""merge_scanlines""merge_scanlines""merge_scanlines":

Determines whether merged scanlines are computed if not enough scanlines could be decoded individually. Thus, occluded or damaged bar codes can be read.

Appearance of the bar code in the image:

'meas_thresh'"meas_thresh""meas_thresh""meas_thresh""meas_thresh""meas_thresh":

Relative threshold for the detection of edges in the bar code region.

'meas_thresh_abs'"meas_thresh_abs""meas_thresh_abs""meas_thresh_abs""meas_thresh_abs""meas_thresh_abs":

Absolute threshold for the detection of edges in the bar code region.

'contrast_min'"contrast_min""contrast_min""contrast_min""contrast_min""contrast_min":

Minimal contrast between the foreground and the background of the bar code elements.

Bar code specific values:

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

Handling of an optional check character.

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

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

'upce_encodation'"upce_encodation""upce_encodation""upce_encodation""upce_encodation""upce_encodation":

Output format for UPC-E bar codes.

Miscellaneous:

'timeout'"timeout""timeout""timeout""timeout""timeout":

Timeout for find_bar_codefind_bar_codeFindBarCodeFindBarCodeFindBarCodefind_bar_code

'persistence'"persistence""persistence""persistence""persistence""persistence":

Persistence mode of the bar code model.

'train'"train""train""train""train""train":

Returns the names of the trained parameters. The returned tuple can be passed as GenParamNameGenParamNameGenParamNameGenParamNamegenParamNamegen_param_name to a further call to get_bar_code_paramget_bar_code_paramGetBarCodeParamGetBarCodeParamGetBarCodeParamget_bar_code_param to get the values of the trained parameters.

Further details on these parameters can be found with the description of the operator set_bar_code_paramset_bar_code_paramSetBarCodeParamSetBarCodeParamSetBarCodeParamset_bar_code_param.

Execution Information

Parameters

BarCodeHandleBarCodeHandleBarCodeHandleBarCodeHandlebarCodeHandlebar_code_handle (input_control)  barcode HBarCode, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)

Handle of the bar code model.

GenParamNameGenParamNameGenParamNameGenParamNamegenParamNamegen_param_name (input_control)  attribute.name(-array) HTupleMaybeSequence[str]HTupleHtuple (string) (string) (HString) (char*)

Names of the generic parameters that are to be queried for the bar code model.

Default value: 'element_size_min' "element_size_min" "element_size_min" "element_size_min" "element_size_min" "element_size_min"

List of values: 'barcode_height_min'"barcode_height_min""barcode_height_min""barcode_height_min""barcode_height_min""barcode_height_min", 'barcode_width_min'"barcode_width_min""barcode_width_min""barcode_width_min""barcode_width_min""barcode_width_min", 'check_char'"check_char""check_char""check_char""check_char""check_char", 'composite_code'"composite_code""composite_code""composite_code""composite_code""composite_code", 'contrast_min'"contrast_min""contrast_min""contrast_min""contrast_min""contrast_min", 'element_size_max'"element_size_max""element_size_max""element_size_max""element_size_max""element_size_max", 'element_size_min'"element_size_min""element_size_min""element_size_min""element_size_min""element_size_min", 'element_size_variable'"element_size_variable""element_size_variable""element_size_variable""element_size_variable""element_size_variable", 'majority_voting'"majority_voting""majority_voting""majority_voting""majority_voting""majority_voting", 'meas_thresh'"meas_thresh""meas_thresh""meas_thresh""meas_thresh""meas_thresh", 'meas_thresh_abs'"meas_thresh_abs""meas_thresh_abs""meas_thresh_abs""meas_thresh_abs""meas_thresh_abs", 'merge_scanlines'"merge_scanlines""merge_scanlines""merge_scanlines""merge_scanlines""merge_scanlines", 'min_code_length'"min_code_length""min_code_length""min_code_length""min_code_length""min_code_length", 'min_identical_scanlines'"min_identical_scanlines""min_identical_scanlines""min_identical_scanlines""min_identical_scanlines""min_identical_scanlines", 'num_scanlines'"num_scanlines""num_scanlines""num_scanlines""num_scanlines""num_scanlines", 'orientation'"orientation""orientation""orientation""orientation""orientation", 'orientation_tol'"orientation_tol""orientation_tol""orientation_tol""orientation_tol""orientation_tol", 'persistence'"persistence""persistence""persistence""persistence""persistence", 'quiet_zone'"quiet_zone""quiet_zone""quiet_zone""quiet_zone""quiet_zone", 'small_elements_robustness'"small_elements_robustness""small_elements_robustness""small_elements_robustness""small_elements_robustness""small_elements_robustness", 'start_stop_tolerance'"start_stop_tolerance""start_stop_tolerance""start_stop_tolerance""start_stop_tolerance""start_stop_tolerance", 'stop_after_result_num'"stop_after_result_num""stop_after_result_num""stop_after_result_num""stop_after_result_num""stop_after_result_num", 'timeout'"timeout""timeout""timeout""timeout""timeout", 'train'"train""train""train""train""train", 'upce_encodation'"upce_encodation""upce_encodation""upce_encodation""upce_encodation""upce_encodation"

GenParamValueGenParamValueGenParamValueGenParamValuegenParamValuegen_param_value (output_control)  attribute.name(-array) HTupleSequence[Union[float, int, str]]HTupleHtuple (real / integer / string) (double / int / long / string) (double / Hlong / HString) (double / Hlong / char*)

Values of the generic parameters.

Result

The operator get_bar_code_paramget_bar_code_paramGetBarCodeParamGetBarCodeParamGetBarCodeParamget_bar_code_param returns the value TRUE if the given parameters are correct. Otherwise, an exception will be raised.

Possible Predecessors

create_bar_code_modelcreate_bar_code_modelCreateBarCodeModelCreateBarCodeModelCreateBarCodeModelcreate_bar_code_model, set_bar_code_paramset_bar_code_paramSetBarCodeParamSetBarCodeParamSetBarCodeParamset_bar_code_param

Possible Successors

set_bar_code_paramset_bar_code_paramSetBarCodeParamSetBarCodeParamSetBarCodeParamset_bar_code_param

Alternatives

get_bar_code_param_specificget_bar_code_param_specificGetBarCodeParamSpecificGetBarCodeParamSpecificGetBarCodeParamSpecificget_bar_code_param_specific

Module

Bar Code