Operator Reference
deserialize_hom_mat2d (Operator)
deserialize_hom_mat2d — Deserialize a serialized homogeneous 2D transformation matrix.
Signature
deserialize_hom_mat2d( : : SerializedItemHandle : HomMat2D)
Description
deserialize_hom_mat2d deserializes a homogeneous 2D transformation
matrix, that was serialized by serialize_hom_mat2d
(see fwrite_serialized_item for an introduction of the basic
principle of serialization). The serialized transformation matrix
is defined by the handle SerializedItemHandle.
The deserialized values are stored in an automatically created
transformation matrix with the handle HomMat2D.
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
SerializedItemHandle (input_control) serialized_item → (handle)
Handle of the serialized item.
HomMat2D (output_control) hom_mat2d → (real)
Transformation matrix.
Result
If the parameters are valid, the operator
deserialize_hom_mat2d returns the value 2 (
H_MSG_TRUE)
. If
necessary, an exception is raised.
Possible Predecessors
fread_serialized_item,
receive_serialized_item,
serialize_hom_mat2d
Module
Foundation