deserialize_hom_mat2dT_deserialize_hom_mat2dDeserializeHomMat2dDeserializeHomMat2ddeserialize_hom_mat2d (Operator)
Name
deserialize_hom_mat2dT_deserialize_hom_mat2dDeserializeHomMat2dDeserializeHomMat2ddeserialize_hom_mat2d — Deserialize a serialized homogeneous 2D transformation matrix.
Signature
Description
deserialize_hom_mat2ddeserialize_hom_mat2dDeserializeHomMat2dDeserializeHomMat2dDeserializeHomMat2ddeserialize_hom_mat2d deserializes a homogeneous 2D transformation
matrix, that was serialized by serialize_hom_mat2dserialize_hom_mat2dSerializeHomMat2dSerializeHomMat2dSerializeHomMat2dserialize_hom_mat2d
(see fwrite_serialized_itemfwrite_serialized_itemFwriteSerializedItemFwriteSerializedItemFwriteSerializedItemfwrite_serialized_item for an introduction of the basic
principle of serialization). The serialized transformation matrix
is defined by the handle SerializedItemHandleSerializedItemHandleSerializedItemHandleSerializedItemHandleserializedItemHandleserialized_item_handle.
The deserialized values are stored in an automatically created
transformation matrix with the handle HomMat2DHomMat2DHomMat2DHomMat2DhomMat2Dhom_mat_2d.
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
SerializedItemHandleSerializedItemHandleSerializedItemHandleSerializedItemHandleserializedItemHandleserialized_item_handle (input_control) serialized_item → HSerializedItem, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)
Handle of the serialized item.
HomMat2DHomMat2DHomMat2DHomMat2DhomMat2Dhom_mat_2d (output_control) hom_mat2d → HHomMat2D, HTupleSequence[float]HTupleHtuple (real) (double) (double) (double)
Transformation matrix.
Result
If the parameters are valid, the operator
deserialize_hom_mat2ddeserialize_hom_mat2dDeserializeHomMat2dDeserializeHomMat2dDeserializeHomMat2ddeserialize_hom_mat2d returns the value 2 (H_MSG_TRUE). If
necessary, an exception is raised.
Possible Predecessors
fread_serialized_itemfread_serialized_itemFreadSerializedItemFreadSerializedItemFreadSerializedItemfread_serialized_item,
receive_serialized_itemreceive_serialized_itemReceiveSerializedItemReceiveSerializedItemReceiveSerializedItemreceive_serialized_item,
serialize_hom_mat2dserialize_hom_mat2dSerializeHomMat2dSerializeHomMat2dSerializeHomMat2dserialize_hom_mat2d
Module
Foundation