ClassesClassesClassesClasses | | | | Operators

create_bar_code_modelcreate_bar_code_modelCreateBarCodeModelcreate_bar_code_modelCreateBarCodeModelCreateBarCodeModel (Operator)

Name

create_bar_code_modelcreate_bar_code_modelCreateBarCodeModelcreate_bar_code_modelCreateBarCodeModelCreateBarCodeModel — Create a model of a bar code reader.

Signature

create_bar_code_model( : : GenParamName, GenParamValue : BarCodeHandle)

Herror create_bar_code_model(const char* GenParamName, double GenParamValue, Hlong* BarCodeHandle)

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

Herror create_bar_code_model(const HTuple& GenParamName, const HTuple& GenParamValue, Hlong* BarCodeHandle)

void HBarCode::CreateBarCodeModel(const HTuple& GenParamName, const HTuple& GenParamValue)

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

void HBarCode::HBarCode(const HTuple& GenParamName, const HTuple& GenParamValue)

void HBarCode::HBarCode(const HString& GenParamName, double GenParamValue)

void HBarCode::HBarCode(const char* GenParamName, double GenParamValue)

void HBarCode::CreateBarCodeModel(const HTuple& GenParamName, const HTuple& GenParamValue)

void HBarCode::CreateBarCodeModel(const HString& GenParamName, double GenParamValue)

void HBarCode::CreateBarCodeModel(const char* GenParamName, double GenParamValue)

void HOperatorSetX.CreateBarCodeModel(
[in] VARIANT GenParamName, [in] VARIANT GenParamValue, [out] VARIANT* BarCodeHandle)

void HBarCodeX.CreateBarCodeModel(
[in] VARIANT GenParamName, [in] VARIANT GenParamValue)

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

public HBarCode(HTuple genParamName, HTuple genParamValue)

public HBarCode(string genParamName, double genParamValue)

void HBarCode.CreateBarCodeModel(HTuple genParamName, HTuple genParamValue)

void HBarCode.CreateBarCodeModel(string genParamName, double genParamValue)

Description

The operator create_bar_code_modelcreate_bar_code_modelCreateBarCodeModelcreate_bar_code_modelCreateBarCodeModelCreateBarCodeModel creates a generic model for reading all types of supported bar code symbols. The result of this operator is a handle to the bar code model (BarCodeHandleBarCodeHandleBarCodeHandleBarCodeHandleBarCodeHandlebarCodeHandle), which is used for all further operations on the bar code, like modifying the model, reading a symbol, or accessing the results of the symbol search.

In general, bar codes will be found and decoded without any additional adjustment of the parameters. Therefore, GenParamNameGenParamNameGenParamNameGenParamNameGenParamNamegenParamName and GenParamValueGenParamValueGenParamValueGenParamValueGenParamValuegenParamValue are empty tuples by default. In the case of poor image quality or abnormal geometric characteristics of the bar code, which requires special parameter settings for a successful decoding of the bar code symbols, parameters can be adjusted already while creating the bar code model. Alternatively, parameters can be changed later on as well by applying the operator set_bar_code_paramset_bar_code_paramSetBarCodeParamset_bar_code_paramSetBarCodeParamSetBarCodeParam or set_bar_code_param_specificset_bar_code_param_specificSetBarCodeParamSpecificset_bar_code_param_specificSetBarCodeParamSpecificSetBarCodeParamSpecific. For a detailed description of the available model parameters see set_bar_code_paramset_bar_code_paramSetBarCodeParamset_bar_code_paramSetBarCodeParamSetBarCodeParam.

Parallelization

This operator returns a handle. Note that the state of an instance of this handle type may be changed by specific operators even though the handle is used as an input parameter by those operators.

Parameters

GenParamNameGenParamNameGenParamNameGenParamNameGenParamNamegenParamName (input_control)  attribute.name(-array) HTupleHTupleHTupleVARIANTHtuple (string) (string) (HString) (char*) (BSTR) (char*)

Names of the generic parameters that can be adjusted for the bar code model.

Default value: []

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", '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", '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", '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", '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"

GenParamValueGenParamValueGenParamValueGenParamValueGenParamValuegenParamValue (input_control)  attribute.value(-array) HTupleHTupleHTupleVARIANTHtuple (real / integer / string) (double / int / long / string) (double / Hlong / HString) (double / Hlong / char*) (double / Hlong / BSTR) (double / Hlong / char*)

Values of the generic parameters that can be adjusted for the bar code model.

Default value: []

Suggested values: 0, 0.1, 1, 1.5, 2, 8, 32, 45, 'present'"present""present""present""present""present", 'absent'"absent""absent""absent""absent""absent", 'none'"none""none""none""none""none", 'CC-A/B'"CC-A/B""CC-A/B""CC-A/B""CC-A/B""CC-A/B", 'auto'"auto""auto""auto""auto""auto", 'high'"high""high""high""high""high", 'low'"low""low""low""low""low", 'true'"true""true""true""true""true", 'false'"false""false""false""false""false"

BarCodeHandleBarCodeHandleBarCodeHandleBarCodeHandleBarCodeHandlebarCodeHandle (output_control)  barcode HBarCode, HTupleHTupleHBarCode, HTupleHBarCodeX, VARIANTHtuple (integer) (IntPtr) (Hlong) (Hlong) (Hlong) (Hlong)

Handle for using and accessing the bar code model.

Result

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

Possible Successors

find_bar_codefind_bar_codeFindBarCodefind_bar_codeFindBarCodeFindBarCode

See also

clear_bar_code_modelclear_bar_code_modelClearBarCodeModelclear_bar_code_modelClearBarCodeModelClearBarCodeModel

References

International Standard ISO/IEC 15420: “Information technology - Automatic identification and data capture techniques - Bar code symbology specification - EAN/UPC”; Reference number ISO/IEC 15420:2000 (E); ISO/IEC 2000.
International Standard ISO/IEC 16390: “Information technology - Automatic identification and data capture techniques - Bar code symbology specification - Interleaved 2 of 5”; Reference number ISO/IEC 16390:1999 (E); ISO/IEC 1999.
International Standard ISO/IEC 16388: “Information technology - Automatic identification and data capture techniques - Bar code symbology specification - Code 39”; Reference number ISO/IEC 16388:1999 (E); ISO/IEC 1999.
American National Standards Institute, Inc.(ANSI): “Uniform Symbology Specification Code 93”; ANSI/AIM-BC5-2000; AIM 2000.
International Standard ISO/IEC 15417: “Information technology - Automatic identification and data capture techniques - Bar code symbology specification - Code 128”; Reference number ISO/IEC 15417:2000 (E); ISO/IEC 2000.
American National Standards Institute, Inc.(ANSI): “Uniform Symbology Specification Codabar”; ANSI/AIM-BC3-2000; AIM 2000.
International Standard ISO/IEC 24724: “Information technology - Automatic identification and data capture techniques - Reduced Space Symbology (RSS) bar code symbology specification”; Reference number ISO/IEC 24724:2006 (E); ISO/IEC 2006.
International Standard ISO/IEC 24723: “Information technology - Automatic identification and data capture techniques - EAN.UCC Composite bar code symbology specification”; Reference number ISO/IEC 24723:2006 (E); ISO/IEC 2006.

Module

Bar Code


ClassesClassesClassesClasses | | | | Operators