Operator Reference

HALCON Operator Reference / 2D Metrology
ClassesClasses | | Operators

deserialize_metrology_modelT_deserialize_metrology_modelDeserializeMetrologyModelDeserializeMetrologyModeldeserialize_metrology_model (Operator)

deserialize_metrology_modelT_deserialize_metrology_modelDeserializeMetrologyModelDeserializeMetrologyModeldeserialize_metrology_model — Deserialize a serialized metrology model.

Signature

deserialize_metrology_model( : : SerializedItemHandle : MetrologyHandle)

Herror T_deserialize_metrology_model(const Htuple SerializedItemHandle, Htuple* MetrologyHandle)

void DeserializeMetrologyModel(const HTuple& SerializedItemHandle, HTuple* MetrologyHandle)

void HMetrologyModel::DeserializeMetrologyModel(const HSerializedItem& SerializedItemHandle)

static void HOperatorSet.DeserializeMetrologyModel(HTuple serializedItemHandle, out HTuple metrologyHandle)

void HMetrologyModel.DeserializeMetrologyModel(HSerializedItem serializedItemHandle)

def deserialize_metrology_model(serialized_item_handle: HHandle) -> HHandle

Description

deserialize_metrology_modeldeserialize_metrology_modelDeserializeMetrologyModelDeserializeMetrologyModeldeserialize_metrology_model deserializes a metrology model, that was serialized by serialize_metrology_modelserialize_metrology_modelSerializeMetrologyModelSerializeMetrologyModelserialize_metrology_model (see fwrite_serialized_itemfwrite_serialized_itemFwriteSerializedItemFwriteSerializedItemfwrite_serialized_item for an introduction of the basic principle of serialization). The serialized metrology model is defined by the handle SerializedItemHandleSerializedItemHandleSerializedItemHandleserializedItemHandleserialized_item_handle. The deserialized values are stored in an automatically created metrology model with the handle MetrologyHandleMetrologyHandleMetrologyHandlemetrologyHandlemetrology_handle. Access to the parameters of the metrology model is possible, e.g., with the operators get_metrology_object_paramget_metrology_object_paramGetMetrologyObjectParamGetMetrologyObjectParamget_metrology_object_param or get_metrology_object_fuzzy_paramget_metrology_object_fuzzy_paramGetMetrologyObjectFuzzyParamGetMetrologyObjectFuzzyParamget_metrology_object_fuzzy_param.

For an explanation of the concept of 2D metrology see the introduction of chapter 2D Metrology.

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.

MetrologyHandleMetrologyHandleMetrologyHandlemetrologyHandlemetrology_handle (output_control)  metrology_model → HMetrologyModel, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)

Handle of the metrology model.

Result

If the parameters are valid, the operator deserialize_metrology_modeldeserialize_metrology_modelDeserializeMetrologyModelDeserializeMetrologyModeldeserialize_metrology_model 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_metrology_modelserialize_metrology_modelSerializeMetrologyModelSerializeMetrologyModelserialize_metrology_model

Possible Successors

get_metrology_object_paramget_metrology_object_paramGetMetrologyObjectParamGetMetrologyObjectParamget_metrology_object_param, get_metrology_object_fuzzy_paramget_metrology_object_fuzzy_paramGetMetrologyObjectFuzzyParamGetMetrologyObjectFuzzyParamget_metrology_object_fuzzy_param, apply_metrology_modelapply_metrology_modelApplyMetrologyModelApplyMetrologyModelapply_metrology_model

Module

2D Metrology

ClassesClasses | | Operators