Operator Reference

HALCON Operator Reference / File / Object
ClassesClasses | | Operators

deserialize_objectT_deserialize_objectDeserializeObjectDeserializeObjectdeserialize_object (Operator)

deserialize_objectT_deserialize_objectDeserializeObjectDeserializeObjectdeserialize_object — Deserialize a serialized iconic object.

Signature

deserialize_object( : Object : SerializedItemHandle : )

Herror T_deserialize_object(Hobject* Object, const Htuple SerializedItemHandle)

void DeserializeObject(HObject* Object, const HTuple& SerializedItemHandle)

void HObject::DeserializeObject(const HSerializedItem& SerializedItemHandle)

static void HOperatorSet.DeserializeObject(out HObject objectVal, HTuple serializedItemHandle)

void HObject.DeserializeObject(HSerializedItem serializedItemHandle)

def deserialize_object(serialized_item_handle: HHandle) -> HObject

Description

deserialize_objectdeserialize_objectDeserializeObjectDeserializeObjectdeserialize_object deserializes an iconic object, that was serialized by serialize_objectserialize_objectSerializeObjectSerializeObjectserialize_object (see fwrite_serialized_itemfwrite_serialized_itemFwriteSerializedItemFwriteSerializedItemfwrite_serialized_item for an introduction of the basic principle of serialization). The serialized iconic object is defined by the parameter SerializedItemHandleSerializedItemHandleSerializedItemHandleserializedItemHandleserialized_item_handle. The deserialized iconic object is stored in the iconic object defined by the parameter ObjectObjectObjectobjectValobject.

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

ObjectObjectObjectobjectValobject (output_object)  object(-array) → objectHObjectHObjectHObjectHobject *

Iconic object.

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_objectdeserialize_objectDeserializeObjectDeserializeObjectdeserialize_object returns the value 2 ( H_MSG_TRUE) . If necessary, an exception is raised.

Possible Predecessors

fread_serialized_itemfread_serialized_itemFreadSerializedItemFreadSerializedItemfread_serialized_item, receive_serialized_itemreceive_serialized_itemReceiveSerializedItemReceiveSerializedItemreceive_serialized_item, serialize_objectserialize_objectSerializeObjectSerializeObjectserialize_object

See also

serialize_objectserialize_objectSerializeObjectSerializeObjectserialize_object

Module

Foundation

ClassesClasses | | Operators