deserialize_templateT_deserialize_templateDeserializeTemplateDeserializeTemplatedeserialize_template (Operator)

Name

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)

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 → (handle)

Handle of the serialized item.

TemplateIDTemplateIDTemplateIDtemplateIDtemplate_id (output_control) template → (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

Operators