deserialize_regionT_deserialize_regionDeserializeRegionDeserializeRegiondeserialize_region (Operator)
Name
deserialize_regionT_deserialize_regionDeserializeRegionDeserializeRegiondeserialize_region
— Deserialize a serialized region.
Signature
Description
deserialize_regiondeserialize_regionDeserializeRegionDeserializeRegiondeserialize_region
deserializes a region, that was serialized
by serialize_regionserialize_regionSerializeRegionSerializeRegionserialize_region
(see fwrite_serialized_itemfwrite_serialized_itemFwriteSerializedItemFwriteSerializedItemfwrite_serialized_item
for an
introduction of the basic principle of serialization). The
serialized region is defined by the parameter
SerializedItemHandleSerializedItemHandleSerializedItemHandleserializedItemHandleserialized_item_handle
.
The deserialized region is stored in the region defined by the
parameter RegionRegionRegionregionregion
.
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
RegionRegionRegionregionregion
(output_object) region(-array) →
objectHRegionHObjectHObjectHobject *
Region.
SerializedItemHandleSerializedItemHandleSerializedItemHandleserializedItemHandleserialized_item_handle
(input_control) serialized_item →
HSerializedItem, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)
Handle of the serialized item.
Result
If the parameters are valid, the operator
deserialize_regiondeserialize_regionDeserializeRegionDeserializeRegiondeserialize_region
returns the value 2 (
H_MSG_TRUE)
. If
necessary, an exception is raised.
Possible Predecessors
read_imageread_imageReadImageReadImageread_image
,
fread_serialized_itemfread_serialized_itemFreadSerializedItemFreadSerializedItemfread_serialized_item
,
receive_serialized_itemreceive_serialized_itemReceiveSerializedItemReceiveSerializedItemreceive_serialized_item
,
serialize_regionserialize_regionSerializeRegionSerializeRegionserialize_region
Possible Successors
reduce_domainreduce_domainReduceDomainReduceDomainreduce_domain
,
disp_regiondisp_regionDispRegionDispRegiondisp_region
See also
serialize_regionserialize_regionSerializeRegionSerializeRegionserialize_region
Module
Foundation