Operator Reference

HALCON Operator Reference / File / Region
ClassesClasses | | Operators

deserialize_regionT_deserialize_regionDeserializeRegionDeserializeRegiondeserialize_region (Operator)

deserialize_regionT_deserialize_regionDeserializeRegionDeserializeRegiondeserialize_region — Deserialize a serialized region.

Signature

deserialize_region( : Region : SerializedItemHandle : )

Herror T_deserialize_region(Hobject* Region, const Htuple SerializedItemHandle)

void DeserializeRegion(HObject* Region, const HTuple& SerializedItemHandle)

void HRegion::DeserializeRegion(const HSerializedItem& SerializedItemHandle)

static void HOperatorSet.DeserializeRegion(out HObject region, HTuple serializedItemHandle)

void HRegion.DeserializeRegion(HSerializedItem serializedItemHandle)

def deserialize_region(serialized_item_handle: HHandle) -> HObject

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

ClassesClasses | | Operators