Operator Reference

HALCON Operator Reference / Identification / Data Code

• HDevelop
• .NET
• Python
• C++
• C

ClassesClasses | | Operators

read_data_code_2d_modelT_read_data_code_2d_modelReadDataCode2dModelReadDataCode2dModelread_data_code_2d_model (Operator)

read_data_code_2d_modelT_read_data_code_2d_modelReadDataCode2dModelReadDataCode2dModelread_data_code_2d_model — Read a 2D data code model from a file and create a new model.

Signature

read_data_code_2d_model( : : FileName : DataCodeHandle)

Herror T_read_data_code_2d_model(const Htuple FileName, Htuple* DataCodeHandle)

void ReadDataCode2dModel(const HTuple& FileName, HTuple* DataCodeHandle)

void HDataCode2D::HDataCode2D(const HString& FileName)

void HDataCode2D::HDataCode2D(const char* FileName)

void HDataCode2D::HDataCode2D(const wchar_t* FileName)   ( Windows only)

void HDataCode2D::ReadDataCode2dModel(const HString& FileName)

void HDataCode2D::ReadDataCode2dModel(const char* FileName)

void HDataCode2D::ReadDataCode2dModel(const wchar_t* FileName)   ( Windows only)

static void HOperatorSet.ReadDataCode2dModel(HTuple fileName, out HTuple dataCodeHandle)

public HDataCode2D(string fileName)

void HDataCode2D.ReadDataCode2dModel(string fileName)

def read_data_code_2d_model(file_name: str) -> HHandle

Description

The operator read_data_code_2d_modelread_data_code_2d_modelReadDataCode2dModelReadDataCode2dModelread_data_code_2d_model reads the 2D data code model file FileNameFileNameFileNamefileNamefile_name and creates a new model that is an identical copy of the saved model. The parameter DataCodeHandleDataCodeHandleDataCodeHandledataCodeHandledata_code_handle returns the handle of the new model. The model file FileNameFileNameFileNamefileNamefile_name must be created by the operator write_data_code_2d_modelwrite_data_code_2d_modelWriteDataCode2dModelWriteDataCode2dModelwrite_data_code_2d_model. The default HALCON file extension for the 2D data code model is 'dcm'.

For an explanation of the concept of the 2D data code reader see the introduction of chapter Identification / Data Code.

Execution Information

• Multithreading type: reentrant (runs in parallel with non-exclusive operators).
• Multithreading scope: global (may be called from any thread).
• Processed without 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

FileNameFileNameFileNamefileNamefile_name (input_control)  filename.read → HTuplestrHTupleHtuple (string) (string) (HString) (char*)

Name of the 2D data code model file.

Default: 'data_code_model.dcm' "data_code_model.dcm" "data_code_model.dcm" "data_code_model.dcm" "data_code_model.dcm"

File extension: .dcm

DataCodeHandleDataCodeHandleDataCodeHandledataCodeHandledata_code_handle (output_control)  datacode_2d → HDataCode2D, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)

Handle of the created 2D data code model.

Example (HDevelop)

* This example demonstrates how a model that was saved in an earlier
* session can be used again by reading the model file

* Create a model by reading by reading a data code model file
read_data_code_2d_model ('ecc200_trained_model.dcm', DataCodeHandle)
* Read a symbol image
read_image (Image, 'datacode/ecc200/ecc200_cpu_010')
* Read the symbol in the image
find_data_code_2d (Image, SymbolXLDs, DataCodeHandle, [], [], \
                   ResultHandles, DecodedDataStrings)
* Clear the model
clear_data_code_2d_model (DataCodeHandle)

Result

The operator read_data_code_2d_modelread_data_code_2d_modelReadDataCode2dModelReadDataCode2dModelread_data_code_2d_model returns the value 2 ( H_MSG_TRUE) if the named 2D data code file was found and correctly read. Otherwise, an exception is raised.

Possible Successors

find_data_code_2dfind_data_code_2dFindDataCode2dFindDataCode2dfind_data_code_2d

Alternatives

create_data_code_2d_modelcreate_data_code_2d_modelCreateDataCode2dModelCreateDataCode2dModelcreate_data_code_2d_model

See also

write_data_code_2d_modelwrite_data_code_2d_modelWriteDataCode2dModelWriteDataCode2dModelwrite_data_code_2d_model, clear_data_code_2d_modelclear_data_code_2d_modelClearDataCode2dModelClearDataCode2dModelclear_data_code_2d_model

Module

Data Code

---

ClassesClasses | | Operators