Operator Reference

HALCON Operator Reference / File / Region
ClassesClasses | | Operators

serialize_regionT_serialize_regionSerializeRegionSerializeRegionserialize_region (Operator)

serialize_regionT_serialize_regionSerializeRegionSerializeRegionserialize_region — Serialize a region.

Signature

serialize_region(Region : : : SerializedItemHandle)

Herror T_serialize_region(const Hobject Region, Htuple* SerializedItemHandle)

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

HSerializedItem HRegion::SerializeRegion() const

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

HSerializedItem HRegion.SerializeRegion()

def serialize_region(region: HObject) -> HHandle

Description

serialize_regionserialize_regionSerializeRegionSerializeRegionserialize_region serializes a region (see fwrite_serialized_itemfwrite_serialized_itemFwriteSerializedItemFwriteSerializedItemfwrite_serialized_item for an introduction of the basic principle of serialization). The region is defined by the parameter RegionRegionRegionregionregion. The serialized region is returned by the handle SerializedItemHandleSerializedItemHandleSerializedItemHandleserializedItemHandleserialized_item_handle and can be deserialized by deserialize_regiondeserialize_regionDeserializeRegionDeserializeRegiondeserialize_region.

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 (input_object)  region(-array) → objectHRegionHObjectHObjectHobject

Region.

SerializedItemHandleSerializedItemHandleSerializedItemHandleserializedItemHandleserialized_item_handle (output_control)  serialized_item → HSerializedItem, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)

Handle of the serialized item.

Result

If the parameters are valid, the operator serialize_regionserialize_regionSerializeRegionSerializeRegionserialize_region returns the value 2 ( H_MSG_TRUE) . If necessary, an exception is raised.

Possible Predecessors

read_imageread_imageReadImageReadImageread_image, read_regionread_regionReadRegionReadRegionread_region, thresholdthresholdThresholdThresholdthreshold, regiongrowingregiongrowingRegiongrowingRegiongrowingregiongrowing

Possible Successors

fwrite_serialized_itemfwrite_serialized_itemFwriteSerializedItemFwriteSerializedItemfwrite_serialized_item, send_serialized_itemsend_serialized_itemSendSerializedItemSendSerializedItemsend_serialized_item, deserialize_regiondeserialize_regionDeserializeRegionDeserializeRegiondeserialize_region

See also

deserialize_regiondeserialize_regionDeserializeRegionDeserializeRegiondeserialize_region

Module

Foundation

ClassesClasses | | Operators