Skip to content

write_data_code_2d_modelWriteDataCode2dModelWriteDataCode2dModelwrite_data_code_2d_modelT_write_data_code_2d_model🔗

Short description🔗

write_data_code_2d_modelWriteDataCode2dModelWriteDataCode2dModelwrite_data_code_2d_modelT_write_data_code_2d_model — Writes a 2D code model into a file.

Signature🔗

write_data_code_2d_model( datacode_2d DataCodeHandle, filename.write FileName )void WriteDataCode2dModel( const HTuple& DataCodeHandle, const HTuple& FileName )static void HOperatorSet.WriteDataCode2dModel( HTuple dataCodeHandle, HTuple fileName )def write_data_code_2d_model( data_code_handle: HHandle, file_name: str ) -> None

Herror T_write_data_code_2d_model( 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)

void HDataCode2D.WriteDataCode2dModel( string fileName )

Description🔗

The operator write_data_code_2d_modelWriteDataCode2dModel writes a 2D code model, which was created by create_data_code_2d_modelCreateDataCode2dModel, into a file with the name FileNamefileNamefile_name. This facilitates creating an identical copy of the saved model in a later session with the operator read_data_code_2d_modelReadDataCode2dModel. The default HALCON file extension for the 2D code model is 'dcm'. The handle of the model to write is passed in DataCodeHandledataCodeHandledata_code_handle.

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

Execution information🔗

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🔗

DataCodeHandledataCodeHandledata_code_handle (input_control) datacode_2d → (handle)HTuple (HHandle)HDataCode2D, HTuple (IntPtr)HHandleHtuple (handle)

Handle of the 2D code model.

FileNamefileNamefile_name (input_control) filename.write → (string)HTuple (HString)HTuple (string)strHtuple (char*)

Name of the 2D code model file.

Default: '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_modelWriteDataCode2dModel 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.

Combinations with other operators🔗

Combinations

Possible predecessors

set_data_code_2d_paramSetDataCode2dParam, find_data_code_2dFindDataCode2d

Alternatives

get_data_code_2d_paramGetDataCode2dParam

See also

create_data_code_2d_modelCreateDataCode2dModel, set_data_code_2d_paramSetDataCode2dParam, find_data_code_2dFindDataCode2d

Module🔗

Data Code