Operator Reference
deserialize_hom_mat3d (Operator)
deserialize_hom_mat3d — Deserialize a serialized homogeneous 3D transformation matrix.
Signature
deserialize_hom_mat3d( : : SerializedItemHandle : HomMat3D)
Description
deserialize_hom_mat3d deserializes a homogeneous 3D transformation
matrix, that was serialized by serialize_hom_mat3d
(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 HomMat3D.
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.
HomMat3D (output_control) hom_mat3d → (real)
Transformation matrix.
Result
If the parameters are valid, the operator
deserialize_hom_mat3d returns the value 2 (
H_MSG_TRUE)
. If
necessary, an exception is raised.
Possible Predecessors
fread_serialized_item,
receive_serialized_item,
serialize_hom_mat3d
Module
Foundation