Operator Reference

HALCON Operator Reference / 3D Matching / Deep 3D Matching

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

ClassesClasses | | Operators

read_deep_matching_3dT_read_deep_matching_3dReadDeepMatching3dReadDeepMatching3dread_deep_matching_3d (Operator)

read_deep_matching_3dT_read_deep_matching_3dReadDeepMatching3dReadDeepMatching3dread_deep_matching_3d — Read a Deep 3D Matching model from a file.

Signature

read_deep_matching_3d( : : FileName : Deep3DMatchingModel)

Herror T_read_deep_matching_3d(const Htuple FileName, Htuple* Deep3DMatchingModel)

void ReadDeepMatching3d(const HTuple& FileName, HTuple* Deep3DMatchingModel)

void HDeepMatching3D::HDeepMatching3D(const HString& FileName)

void HDeepMatching3D::HDeepMatching3D(const char* FileName)

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

void HDeepMatching3D::ReadDeepMatching3d(const HString& FileName)

void HDeepMatching3D::ReadDeepMatching3d(const char* FileName)

void HDeepMatching3D::ReadDeepMatching3d(const wchar_t* FileName)   ( Windows only)

static void HOperatorSet.ReadDeepMatching3d(HTuple fileName, out HTuple deep3DMatchingModel)

public HDeepMatching3D(string fileName)

void HDeepMatching3D.ReadDeepMatching3d(string fileName)

def read_deep_matching_3d(file_name: str) -> HHandle

Description

The operator read_deep_matching_3dread_deep_matching_3dReadDeepMatching3dReadDeepMatching3dread_deep_matching_3d reads a Deep 3D Matching model. Such models have to be in the HALCON format. As a result, the handle Deep3DMatchingModelDeep3DMatchingModelDeep3DMatchingModeldeep3DMatchingModeldeep_3dmatching_model is returned.

The model is loaded from the file FileNameFileNameFileNamefileNamefile_name. The default HALCON file extension for Deep 3D Matching models is '.dm3'.

Please note that the values of runtime specific parameters are not written to file, see write_deep_matching_3dwrite_deep_matching_3dWriteDeepMatching3dWriteDeepMatching3dwrite_deep_matching_3d. As a consequence when reading a model these parameters are initialized with their default value, see get_deep_matching_3d_paramget_deep_matching_3d_paramGetDeepMatching3dParamGetDeepMatching3dParamget_deep_matching_3d_param.

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

Filename

File extension: .dm3

Deep3DMatchingModelDeep3DMatchingModelDeep3DMatchingModeldeep3DMatchingModeldeep_3dmatching_model (output_control)  deep_matching_3d → HDeepMatching3D, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)

Handle of the Deep 3D Matching model.

Result

If the parameters are valid, the operator read_deep_matching_3dread_deep_matching_3dReadDeepMatching3dReadDeepMatching3dread_deep_matching_3d returns the value 2 ( H_MSG_TRUE) . If necessary, an exception is raised.

Possible Successors

set_deep_matching_3d_paramset_deep_matching_3d_paramSetDeepMatching3dParamSetDeepMatching3dParamset_deep_matching_3d_param, get_deep_matching_3d_paramget_deep_matching_3d_paramGetDeepMatching3dParamGetDeepMatching3dParamget_deep_matching_3d_param, apply_deep_matching_3dapply_deep_matching_3dApplyDeepMatching3dApplyDeepMatching3dapply_deep_matching_3d

Module

3D Metrology

---

ClassesClasses | | Operators