Skip to content

deserialize_hom_mat3dDeserializeHomMat3dDeserializeHomMat3ddeserialize_hom_mat3dT_deserialize_hom_mat3d🔗

Short description🔗

deserialize_hom_mat3dDeserializeHomMat3dDeserializeHomMat3ddeserialize_hom_mat3dT_deserialize_hom_mat3d — Deserialize a serialized homogeneous 3D transformation matrix.

Signature🔗

deserialize_hom_mat3d( serialized_item SerializedItemHandle, out hom_mat3d HomMat3D )void DeserializeHomMat3d( const HTuple& SerializedItemHandle, HTuple* HomMat3D )static void HOperatorSet.DeserializeHomMat3d( HTuple serializedItemHandle, out HTuple homMat3D )def deserialize_hom_mat3d( serialized_item_handle: HHandle ) -> Sequence[float]

Herror T_deserialize_hom_mat3d( const Htuple SerializedItemHandle, Htuple* HomMat3D )

void HHomMat3D::DeserializeHomMat3d( const HSerializedItem& SerializedItemHandle )

void HHomMat3D.DeserializeHomMat3d( HSerializedItem serializedItemHandle )

Description🔗

deserialize_hom_mat3dDeserializeHomMat3d deserializes a homogeneous 3D transformation matrix, that was serialized by serialize_hom_mat3dSerializeHomMat3d (see fwrite_serialized_itemFwriteSerializedItem for an introduction of the basic principle of serialization). The serialized transformation matrix is defined by the handle SerializedItemHandleserializedItemHandleserialized_item_handle. The deserialized values are stored in an automatically created transformation matrix with the handle HomMat3DhomMat3Dhom_mat_3d.

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.

HomMat3DhomMat3Dhom_mat_3d (output_control) hom_mat3d → (real)HTuple (double)HHomMat3D, HTuple (double)Sequence[float]Htuple (double)

Transformation matrix.

Result🔗

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

Combinations with other operators🔗

Combinations

Possible predecessors

fread_serialized_itemFreadSerializedItem, receive_serialized_itemReceiveSerializedItem, serialize_hom_mat3dSerializeHomMat3d

Module🔗

Foundation