read_deep_matching_3dReadDeepMatching3dReadDeepMatching3dread_deep_matching_3dT_read_deep_matching_3d

HALCON ScriptCpp++.NETPythonC

Short description

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

Signature

read_deep_matching_3d( filename.read FileName, out deep_matching_3d Deep3DMatchingModel )void ReadDeepMatching3d( const HTuple& FileName, HTuple* Deep3DMatchingModel )static void HOperatorSet.ReadDeepMatching3d( HTuple fileName, out HTuple deep3DMatchingModel )def read_deep_matching_3d( file_name: str ) -> HHandle

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

public HDeepMatching3D( string fileName )

void HDeepMatching3D::ReadDeepMatching3d( const HString& FileName )

void HDeepMatching3D::ReadDeepMatching3d( const char* FileName )

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

void HDeepMatching3D.ReadDeepMatching3d( string fileName )

Description

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

The model is loaded from the file FileNamefileNamefile_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_3dWriteDeepMatching3d. As a consequence when reading a model these parameters are initialized with their default value, see get_deep_matching_3d_paramGetDeepMatching3dParam.

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.

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

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

Filename

File extension: .dm3

Deep3DMatchingModeldeep3DMatchingModeldeep_3dmatching_model (output_control) deep_matching_3d → (handle)HTuple (HHandle)HDeepMatching3D, HTuple (IntPtr)HHandleHtuple (handle)

Handle of the Deep 3D Matching model.

Result

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

Combinations with other operators

Combinations

Possible predecessors

create_deep_matching_3dCreateDeepMatching3d

Possible successors

set_deep_matching_3d_paramSetDeepMatching3dParam, get_deep_matching_3d_paramGetDeepMatching3dParam, apply_deep_matching_3dApplyDeepMatching3d

Alternatives

create_deep_matching_3dCreateDeepMatching3d

Module

3D Metrology