read_deformable_surface_modelread_deformable_surface_modelReadDeformableSurfaceModelReadDeformableSurfaceModel (Operator)

Name

read_deformable_surface_modelread_deformable_surface_modelReadDeformableSurfaceModelReadDeformableSurfaceModel — Read a deformable surface model from a file.

Signature

read_deformable_surface_model( : : FileName : DeformableSurfaceModel)

Description

The operator read_deformable_surface_modelread_deformable_surface_modelReadDeformableSurfaceModelReadDeformableSurfaceModelReadDeformableSurfaceModel reads the deformable surface model, which has been written with write_deformable_surface_modelwrite_deformable_surface_modelWriteDeformableSurfaceModelWriteDeformableSurfaceModelWriteDeformableSurfaceModel, from the file FileNameFileNameFileNameFileNamefileName. The handle of the deformable surface model is returned in DeformableSurfaceModelDeformableSurfaceModelDeformableSurfaceModelDeformableSurfaceModeldeformableSurfaceModel. If no absolute path is given in FileNameFileNameFileNameFileNamefileName, 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 FileNameFileNameFileNameFileNamefileName exists, the default file extension is appended to FileNameFileNameFileNameFileNamefileName.

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

FileNameFileNameFileNameFileNamefileName (input_control) filename.read → (string)

Name of the file to read.

File extension: .dsfm

DeformableSurfaceModelDeformableSurfaceModelDeformableSurfaceModelDeformableSurfaceModeldeformableSurfaceModel (output_control) deformable_surface_model → (integer)

Handle of the read deformable surface model.

read_deformable_surface_modelread_deformable_surface_modelReadDeformableSurfaceModelReadDeformableSurfaceModelReadDeformableSurfaceModel 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.