Operator Reference

HALCON Operator Reference / File / Tuple

• HDevelop
• .NET
• Python
• C++
• C

ClassesClasses | | Operators

deserialize_handleT_deserialize_handleDeserializeHandleDeserializeHandledeserialize_handle (Operator)

deserialize_handleT_deserialize_handleDeserializeHandleDeserializeHandledeserialize_handle — Deserialize a serialized item.

Signature

deserialize_handle( : : SerializedItem : Handle)

Herror T_deserialize_handle(const Htuple SerializedItem, Htuple* Handle)

void DeserializeHandle(const HTuple& SerializedItem, HTuple* Handle)

void HHandle::DeserializeHandle(const HSerializedItem& SerializedItem)

static void HOperatorSet.DeserializeHandle(HTuple serializedItem, out HTuple handle)

void HHandle.DeserializeHandle(HSerializedItem serializedItem)

def deserialize_handle(serialized_item: HHandle) -> HHandle

Description

deserialize_handledeserialize_handleDeserializeHandleDeserializeHandledeserialize_handle deserializes the content of SerializedItemSerializedItemSerializedItemserializedItemserialized_item and returns the deserialized item in HandleHandleHandlehandlehandle (see fwrite_serialized_itemfwrite_serialized_itemFwriteSerializedItemFwriteSerializedItemfwrite_serialized_item for an introduction of the basic principle of serialization).

The serialized item must have been created by serialize_handleserialize_handleSerializeHandleSerializeHandleserialize_handle, or by the type specific serialization operators, such as serialize_matrixserialize_matrixSerializeMatrixSerializeMatrixserialize_matrix or serialize_shape_modelserialize_shape_modelSerializeShapeModelSerializeShapeModelserialize_shape_model.

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

SerializedItemSerializedItemSerializedItemserializedItemserialized_item (input_control)  serialized_item → HSerializedItem, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)

Handle containing the serialized item to be deserialized.

HandleHandleHandlehandlehandle (output_control)  handle → HHandle, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)

Handle containing the deserialized item.

Example (HDevelop)

create_matrix (3, 3, 0, MatrixID)
serialize_handle (MatrixID, SerializedMatrix)
deserialize_handle (SerializedMatrix, MatrixID2)

Result

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

Possible Predecessors

serialize_handleserialize_handleSerializeHandleSerializeHandleserialize_handle, fread_serialized_itemfread_serialized_itemFreadSerializedItemFreadSerializedItemfread_serialized_item, receive_serialized_itemreceive_serialized_itemReceiveSerializedItemReceiveSerializedItemreceive_serialized_item

Module

Foundation

---

ClassesClasses | | Operators