Operator Reference

HALCON Operator Reference / Legacy / Matching

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

ClassesClasses | | Operators

adapt_templateT_adapt_templateAdaptTemplateAdaptTemplateadapt_template (Operator)

adapt_templateT_adapt_templateAdaptTemplateAdaptTemplateadapt_template — Adapting a template to the size of an image.

Warning

adapt_templateadapt_templateAdaptTemplateAdaptTemplateadapt_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

adapt_template(Image : : TemplateID : )

Herror T_adapt_template(const Hobject Image, const Htuple TemplateID)

void AdaptTemplate(const HObject& Image, const HTuple& TemplateID)

void HTemplate::AdaptTemplate(const HImage& Image) const

void HImage::AdaptTemplate(const HTemplate& TemplateID) const

static void HOperatorSet.AdaptTemplate(HObject image, HTuple templateID)

void HTemplate.AdaptTemplate(HImage image)

void HImage.AdaptTemplate(HTemplate templateID)

def adapt_template(image: HObject, template_id: HHandle) -> None

Description

The operator adapt_templateadapt_templateAdaptTemplateAdaptTemplateadapt_template serves to adapt a template which has been created by create_templatecreate_templateCreateTemplateCreateTemplatecreate_template to the size of an image. The operator adapt_templateadapt_templateAdaptTemplateAdaptTemplateadapt_template can be called before the template is used with images of another size, or if the image used to create the template had another size. If it is not called explicitly it will be called internally each time another image size is used. The contents of the image is hereby irrelevant; only the width of ImageImageImageimageimage will be considered.

Execution Information

• Multithreading type: reentrant (runs in parallel with non-exclusive operators).
• Multithreading scope: global (may be called from any thread).
• Processed without parallelization.

This operator modifies the state of the following input parameter:

• TemplateIDTemplateIDTemplateIDtemplateIDtemplate_id

During execution of this operator, access to the value of this parameter must be synchronized if it is used across multiple threads.

Parameters

ImageImageImageimageimage (input_object)  singlechannelimage(-array) → objectHImageHObjectHObjectHobject (byte)

Image which determines the size of the later matching.

TemplateIDTemplateIDTemplateIDtemplateIDtemplate_id (input_control, state is modified)  template → HTemplate, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)

Template number.

Result

If the parameter values are correct, the operator adapt_templateadapt_templateAdaptTemplateAdaptTemplateadapt_template returns the value 2 ( H_MSG_TRUE) . If necessary, an exception is raised.

Possible Predecessors

create_templatecreate_templateCreateTemplateCreateTemplatecreate_template, create_template_rotcreate_template_rotCreateTemplateRotCreateTemplateRotcreate_template_rot, read_templateread_templateReadTemplateReadTemplateread_template

Possible Successors

set_reference_templateset_reference_templateSetReferenceTemplateSetReferenceTemplateset_reference_template, best_matchbest_matchBestMatchBestMatchbest_match, fast_matchfast_matchFastMatchFastMatchfast_match, fast_match_mgfast_match_mgFastMatchMgFastMatchMgfast_match_mg, set_offset_templateset_offset_templateSetOffsetTemplateSetOffsetTemplateset_offset_template, best_match_mgbest_match_mgBestMatchMgBestMatchMgbest_match_mg, best_match_pre_mgbest_match_pre_mgBestMatchPreMgBestMatchPreMgbest_match_pre_mg, best_match_rotbest_match_rotBestMatchRotBestMatchRotbest_match_rot, best_match_rot_mgbest_match_rot_mgBestMatchRotMgBestMatchRotMgbest_match_rot_mg

Module

Matching

---

ClassesClasses | | Operators