read_data_code_2d_modelT_read_data_code_2d_modelReadDataCode2dModelReadDataCode2dModel (Operator)


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


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)


The operator read_data_code_2d_modelread_data_code_2d_modelReadDataCode2dModelReadDataCode2dModelReadDataCode2dModel reads the 2D data code model file FileNameFileNameFileNameFileNamefileName and creates a new model that is an identical copy of the saved model. The parameter DataCodeHandleDataCodeHandleDataCodeHandleDataCodeHandledataCodeHandle returns the handle of the new model. The model file FileNameFileNameFileNameFileNamefileName must be created by the operator write_data_code_2d_modelwrite_data_code_2d_modelWriteDataCode2dModelWriteDataCode2dModelWriteDataCode2dModel. 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

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.


FileNameFileNameFileNameFileNamefileName (input_control) HTupleHTupleHtuple (string) (string) (HString) (char*)

Name of the 2D data code model file.

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

File extension: .dcm

DataCodeHandleDataCodeHandleDataCodeHandleDataCodeHandledataCodeHandle (output_control)  datacode_2d HDataCode2D, HTupleHTupleHtuple (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)


The operator read_data_code_2d_modelread_data_code_2d_modelReadDataCode2dModelReadDataCode2dModelReadDataCode2dModel 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




See also

write_data_code_2d_modelwrite_data_code_2d_modelWriteDataCode2dModelWriteDataCode2dModelWriteDataCode2dModel, clear_data_code_2d_modelclear_data_code_2d_modelClearDataCode2dModelClearDataCode2dModelClearDataCode2dModel


Data Code