deserialize_surface_modelDeserializeSurfaceModelDeserializeSurfaceModeldeserialize_surface_modelT_deserialize_surface_model

HALCON ScriptCpp++.NETPythonC

Short description

deserialize_surface_modelDeserializeSurfaceModelDeserializeSurfaceModeldeserialize_surface_modelT_deserialize_surface_model — Deserialize a surface model.

Signature

deserialize_surface_model( serialized_item SerializedItemHandle, out surface_model SurfaceModelID )void DeserializeSurfaceModel( const HTuple& SerializedItemHandle, HTuple* SurfaceModelID )static void HOperatorSet.DeserializeSurfaceModel( HTuple serializedItemHandle, out HTuple surfaceModelID )def deserialize_surface_model( serialized_item_handle: HHandle ) -> HHandle

Herror T_deserialize_surface_model( const Htuple SerializedItemHandle, Htuple* SurfaceModelID )

void HSurfaceModel::DeserializeSurfaceModel( const HSerializedItem& SerializedItemHandle )

void HSurfaceModel.DeserializeSurfaceModel( HSerializedItem serializedItemHandle )

Description

deserialize_surface_modelDeserializeSurfaceModel deserializes a surface model, that was serialized by serialize_surface_modelSerializeSurfaceModel (see fwrite_serialized_itemFwriteSerializedItem for an introduction of the basic principle of serialization). The serialized surface model is defined by the handle SerializedItemHandleserializedItemHandleserialized_item_handle. The deserialized values are stored in an automatically created surface model with the handle SurfaceModelIDsurfaceModelIDsurface_model_id.

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

SerializedItemHandleserializedItemHandleserialized_item_handle (input_control) serialized_item → (handle)HTuple (HHandle)HSerializedItem, HTuple (IntPtr)HHandleHtuple (handle)

Handle of the serialized item.

SurfaceModelIDsurfaceModelIDsurface_model_id (output_control) surface_model → (handle)HTuple (HHandle)HSurfaceModel, HTuple (IntPtr)HHandleHtuple (handle)

Handle of the surface model.

Result

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

Combinations with other operators

Combinations

Possible predecessors

read_object_model_3dReadObjectModel3d, xyz_to_object_model_3dXyzToObjectModel3d, fread_serialized_itemFreadSerializedItem, receive_serialized_itemReceiveSerializedItem, serialize_surface_modelSerializeSurfaceModel

Possible successors

find_surface_modelFindSurfaceModel, refine_surface_model_poseRefineSurfaceModelPose, get_surface_model_paramGetSurfaceModelParam, clear_surface_modelClearSurfaceModel, find_surface_model_imageFindSurfaceModelImage, refine_surface_model_pose_imageRefineSurfaceModelPoseImage

Alternatives

create_surface_modelCreateSurfaceModel

See also

create_surface_modelCreateSurfaceModel, read_surface_modelReadSurfaceModel, write_surface_modelWriteSurfaceModel

Module

3D Metrology