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