Operator Reference

HALCON Operator Reference / Matrix / File
ClassesClasses | | Operators

deserialize_matrixT_deserialize_matrixDeserializeMatrixDeserializeMatrixdeserialize_matrix (Operator)

deserialize_matrixT_deserialize_matrixDeserializeMatrixDeserializeMatrixdeserialize_matrix — Deserialize a serialized matrix.

Signature

deserialize_matrix( : : SerializedItemHandle : MatrixID)

Herror T_deserialize_matrix(const Htuple SerializedItemHandle, Htuple* MatrixID)

void DeserializeMatrix(const HTuple& SerializedItemHandle, HTuple* MatrixID)

void HMatrix::DeserializeMatrix(const HSerializedItem& SerializedItemHandle)

static void HOperatorSet.DeserializeMatrix(HTuple serializedItemHandle, out HTuple matrixID)

void HMatrix.DeserializeMatrix(HSerializedItem serializedItemHandle)

def deserialize_matrix(serialized_item_handle: HHandle) -> HHandle

Description

deserialize_matrixdeserialize_matrixDeserializeMatrixDeserializeMatrixdeserialize_matrix deserializes a matrix, that was serialized by serialize_matrixserialize_matrixSerializeMatrixSerializeMatrixserialize_matrix (see fwrite_serialized_itemfwrite_serialized_itemFwriteSerializedItemFwriteSerializedItemfwrite_serialized_item for an introduction of the basic principle of serialization). The serialized matrix is defined by the handle SerializedItemHandleSerializedItemHandleSerializedItemHandleserializedItemHandleserialized_item_handle. The deserialized values are stored in an automatically created matrix with the handle MatrixIDMatrixIDMatrixIDmatrixIDmatrix_id. Access to the elements of the matrix is possible e.g., with the operator get_full_matrixget_full_matrixGetFullMatrixGetFullMatrixget_full_matrix.

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

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

Handle of the serialized item.

MatrixIDMatrixIDMatrixIDmatrixIDmatrix_id (output_control)  matrix → HMatrix, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)

Matrix handle.

Result

If the parameters are valid, the operator deserialize_matrixdeserialize_matrixDeserializeMatrixDeserializeMatrixdeserialize_matrix 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_matrixserialize_matrixSerializeMatrixSerializeMatrixserialize_matrix

Possible Successors

get_full_matrixget_full_matrixGetFullMatrixGetFullMatrixget_full_matrix

Module

Foundation

ClassesClasses | | Operators