Operator Reference

HALCON Operator Reference / Identification / Data Code

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

ClassesClasses | | Operators

write_data_code_2d_modelT_write_data_code_2d_modelWriteDataCode2dModelWriteDataCode2dModelwrite_data_code_2d_model (Operator)

write_data_code_2d_modelT_write_data_code_2d_modelWriteDataCode2dModelWriteDataCode2dModelwrite_data_code_2d_model — Writes a 2D data code model into a file.

Signature

write_data_code_2d_model( : : DataCodeHandle, FileName : )

Herror T_write_data_code_2d_model(const Htuple DataCodeHandle, const Htuple FileName)

void WriteDataCode2dModel(const HTuple& DataCodeHandle, const HTuple& FileName)

void HDataCode2D::WriteDataCode2dModel(const HString& FileName) const

void HDataCode2D::WriteDataCode2dModel(const char* FileName) const

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

static void HOperatorSet.WriteDataCode2dModel(HTuple dataCodeHandle, HTuple fileName)

void HDataCode2D.WriteDataCode2dModel(string fileName)

def write_data_code_2d_model(data_code_handle: HHandle, file_name: str) -> None

Description

The operator write_data_code_2d_modelwrite_data_code_2d_modelWriteDataCode2dModelWriteDataCode2dModelwrite_data_code_2d_model writes a 2D data code model, which was created by create_data_code_2d_modelcreate_data_code_2d_modelCreateDataCode2dModelCreateDataCode2dModelcreate_data_code_2d_model, into a file with the name FileNameFileNameFileNamefileNamefile_name. This facilitates creating an identical copy of the saved model in a later session with the operator read_data_code_2d_modelread_data_code_2d_modelReadDataCode2dModelReadDataCode2dModelread_data_code_2d_model. The default HALCON file extension for the 2D data code model is 'dcm'. The handle of the model to write is passed in DataCodeHandleDataCodeHandleDataCodeHandledataCodeHandledata_code_handle.

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.

Parameters

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

Handle of the 2D data code model.

FileNameFileNameFileNamefileNamefile_name (input_control)  filename.write → 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

Example (HDevelop)

* This example demonstrates how a trained model can be saved for
* a future session

* Create a model for reading Data matrix ECC 200 codes
create_data_code_2d_model ('Data Matrix ECC 200', [], [], DataCodeHandle)
* Read a training image
read_image (Image, 'datacode/ecc200/ecc200_cpu_007')
* Train the model with the symbol in the image
find_data_code_2d (Image, SymbolXLDs, DataCodeHandle, 'train', 'all', \
                   ResultHandles, DecodedDataStrings)
* Write the model into a file
write_data_code_2d_model (DataCodeHandle, 'ecc200_trained_model.dcm')
* Clear the model
clear_data_code_2d_model (DataCodeHandle)

Result

The operator write_data_code_2d_modelwrite_data_code_2d_modelWriteDataCode2dModelWriteDataCode2dModelwrite_data_code_2d_model returns the value 2 ( H_MSG_TRUE) if the passed handle is valid and if the model can be written into the named file. Otherwise, an exception is raised.

Possible Predecessors

set_data_code_2d_paramset_data_code_2d_paramSetDataCode2dParamSetDataCode2dParamset_data_code_2d_param, find_data_code_2dfind_data_code_2dFindDataCode2dFindDataCode2dfind_data_code_2d

Alternatives

get_data_code_2d_paramget_data_code_2d_paramGetDataCode2dParamGetDataCode2dParamget_data_code_2d_param

See also

create_data_code_2d_modelcreate_data_code_2d_modelCreateDataCode2dModelCreateDataCode2dModelcreate_data_code_2d_model, set_data_code_2d_paramset_data_code_2d_paramSetDataCode2dParamSetDataCode2dParamset_data_code_2d_param, find_data_code_2dfind_data_code_2dFindDataCode2dFindDataCode2dfind_data_code_2d

Module

Data Code

---

ClassesClasses | | Operators