Operator Reference

HALCON Operator Reference / Legacy / Matching
ClassesClasses | | Operators

deserialize_templateT_deserialize_templateDeserializeTemplateDeserializeTemplatedeserialize_template (Operator)

deserialize_templateT_deserialize_templateDeserializeTemplateDeserializeTemplatedeserialize_template — Deserialize a serialized template.

Warning

deserialize_templatedeserialize_templateDeserializeTemplateDeserializeTemplatedeserialize_template is obsolete and is only provided for reasons of backward compatibility. The operator will be removed with HALCON 25.11. New applications should use the shape-based or NCC-based operators instead.

Signature

deserialize_template( : : SerializedItemHandle : TemplateID)

Herror T_deserialize_template(const Htuple SerializedItemHandle, Htuple* TemplateID)

void DeserializeTemplate(const HTuple& SerializedItemHandle, HTuple* TemplateID)

void HTemplate::DeserializeTemplate(const HSerializedItem& SerializedItemHandle)

static void HOperatorSet.DeserializeTemplate(HTuple serializedItemHandle, out HTuple templateID)

void HTemplate.DeserializeTemplate(HSerializedItem serializedItemHandle)

def deserialize_template(serialized_item_handle: HHandle) -> HHandle

Description

deserialize_templatedeserialize_templateDeserializeTemplateDeserializeTemplatedeserialize_template deserializes a template, that was serialized by serialize_templateserialize_templateSerializeTemplateSerializeTemplateserialize_template (see fwrite_serialized_itemfwrite_serialized_itemFwriteSerializedItemFwriteSerializedItemfwrite_serialized_item for an introduction of the basic principle of serialization). The serialized template is defined by the handle SerializedItemHandleSerializedItemHandleSerializedItemHandleserializedItemHandleserialized_item_handle. The deserialized values are stored in an automatically created template with the handle TemplateIDTemplateIDTemplateIDtemplateIDtemplate_id.

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.

TemplateIDTemplateIDTemplateIDtemplateIDtemplate_id (output_control)  template → HTemplate, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)

Template number.

Result

If the parameters are valid, the operator deserialize_templatedeserialize_templateDeserializeTemplateDeserializeTemplatedeserialize_template 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_templateserialize_templateSerializeTemplateSerializeTemplateserialize_template

Possible Successors

adapt_templateadapt_templateAdaptTemplateAdaptTemplateadapt_template, set_reference_templateset_reference_templateSetReferenceTemplateSetReferenceTemplateset_reference_template, set_offset_templateset_offset_templateSetOffsetTemplateSetOffsetTemplateset_offset_template, best_matchbest_matchBestMatchBestMatchbest_match, fast_matchfast_matchFastMatchFastMatchfast_match, best_match_rotbest_match_rotBestMatchRotBestMatchRotbest_match_rot

Module

Matching

ClassesClasses | | Operators