write_data_code_2d_modelT_write_data_code_2d_modelWriteDataCode2dModelWriteDataCode2dModelwrite_data_code_2d_model (Operator)

Name

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 : )

Description

The operator write_data_code_2d_modelwrite_data_code_2d_modelWriteDataCode2dModelWriteDataCode2dModelWriteDataCode2dModelwrite_data_code_2d_model writes a 2D data code model, which was created by create_data_code_2d_modelcreate_data_code_2d_modelCreateDataCode2dModelCreateDataCode2dModelCreateDataCode2dModelcreate_data_code_2d_model, into a file with the name FileNameFileNameFileNameFileNamefileNamefile_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_modelReadDataCode2dModelReadDataCode2dModelReadDataCode2dModelread_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 DataCodeHandleDataCodeHandleDataCodeHandleDataCodeHandledataCodeHandledata_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

DataCodeHandleDataCodeHandleDataCodeHandleDataCodeHandledataCodeHandledata_code_handle (input_control) datacode_2d → (handle)

Handle of the 2D data code model.

FileNameFileNameFileNameFileNamefileNamefile_name (input_control) filename.write → (string)

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" "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_modelWriteDataCode2dModelWriteDataCode2dModelWriteDataCode2dModelwrite_data_code_2d_model returns the value 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_paramSetDataCode2dParamSetDataCode2dParamSetDataCode2dParamset_data_code_2d_param, find_data_code_2dfind_data_code_2dFindDataCode2dFindDataCode2dFindDataCode2dfind_data_code_2d

Alternatives

get_data_code_2d_paramget_data_code_2d_paramGetDataCode2dParamGetDataCode2dParamGetDataCode2dParamget_data_code_2d_param

Module

Data Code

Operators