read_deformable_surface_modelReadDeformableSurfaceModelReadDeformableSurfaceModelread_deformable_surface_modelT_read_deformable_surface_model

HALCON ScriptCpp++.NETPythonC

Short description

read_deformable_surface_modelReadDeformableSurfaceModelReadDeformableSurfaceModelread_deformable_surface_modelT_read_deformable_surface_model — Read a deformable surface model from a file.

Signature

read_deformable_surface_model( filename.read FileName, out deformable_surface_model DeformableSurfaceModel )void ReadDeformableSurfaceModel( const HTuple& FileName, HTuple* DeformableSurfaceModel )static void HOperatorSet.ReadDeformableSurfaceModel( HTuple fileName, out HTuple deformableSurfaceModel )def read_deformable_surface_model( file_name: str ) -> HHandle

Herror T_read_deformable_surface_model( const Htuple FileName, Htuple* DeformableSurfaceModel )

void HDeformableSurfaceModel::HDeformableSurfaceModel( const HString& FileName )

void HDeformableSurfaceModel::HDeformableSurfaceModel( const char* FileName )

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

public HDeformableSurfaceModel( string fileName )

void HDeformableSurfaceModel::ReadDeformableSurfaceModel( const HString& FileName )

void HDeformableSurfaceModel::ReadDeformableSurfaceModel( const char* FileName )

void HDeformableSurfaceModel::ReadDeformableSurfaceModel( const wchar_t* FileName ) (Windows only)

void HDeformableSurfaceModel.ReadDeformableSurfaceModel( string fileName )

Description

The operator read_deformable_surface_modelReadDeformableSurfaceModel reads the deformable surface model, which has been written with write_deformable_surface_modelWriteDeformableSurfaceModel, from the file FileNamefileNamefile_name. The handle of the deformable surface model is returned in DeformableSurfaceModeldeformableSurfaceModeldeformable_surface_model. If no absolute path is given in FileNamefileNamefile_name, the file is searched in the current directory of the HALCON process. The default HALCON file extension for the deformable surface model file is 'dsfm'. If no file named FileNamefileNamefile_name exists, the default file extension is appended to FileNamefileNamefile_name.

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

Name of the file to read.

File extension: .dsfm

DeformableSurfaceModeldeformableSurfaceModeldeformable_surface_model (output_control) deformable_surface_model → (handle)HTuple (HHandle)HDeformableSurfaceModel, HTuple (IntPtr)HHandleHtuple (handle)

Handle of the read deformable surface model.

Result

read_deformable_surface_modelReadDeformableSurfaceModel returns 2 (H_MSG_TRUE) if all parameters are correct and the file can be read. If the file is not a deformable surface model file, the error 9506 is raised. If the file has a version that can not be read by this version of HALCON, the error 9507 is raised. If necessary, an exception is raised.

Combinations with other operators

Combinations

Possible predecessors

write_deformable_surface_modelWriteDeformableSurfaceModel

Possible successors

find_deformable_surface_modelFindDeformableSurfaceModel, refine_deformable_surface_modelRefineDeformableSurfaceModel, get_deformable_surface_model_paramGetDeformableSurfaceModelParam, clear_deformable_surface_modelClearDeformableSurfaceModel

Alternatives

create_deformable_surface_modelCreateDeformableSurfaceModel

See also

create_deformable_surface_modelCreateDeformableSurfaceModel, write_deformable_surface_modelWriteDeformableSurfaceModel

Module

3D Metrology