adapt_templateT_adapt_templateAdaptTemplateAdaptTemplate (Operator)

Name

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

Warning

adapt_templateadapt_templateAdaptTemplateAdaptTemplateAdaptTemplate is obsolete and is only provided for reasons of backward compatibility. 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)

Description

The operator adapt_templateadapt_templateAdaptTemplateAdaptTemplateAdaptTemplate serves to adapt a template which has been created by create_templatecreate_templateCreateTemplateCreateTemplateCreateTemplate to the size of an image. The operator adapt_templateadapt_templateAdaptTemplateAdaptTemplateAdaptTemplate 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

This operator modifies the state of the following input parameter:

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) objectHImageHImageHobject (byte)

Image which determines the size of the later matching.

TemplateIDTemplateIDTemplateIDTemplateIDtemplateID (input_control, state is modified)  template HTemplate, HTupleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)

Template number.

Result

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

Possible Predecessors

create_templatecreate_templateCreateTemplateCreateTemplateCreateTemplate, create_template_rotcreate_template_rotCreateTemplateRotCreateTemplateRotCreateTemplateRot, read_templateread_templateReadTemplateReadTemplateReadTemplate

Possible Successors

set_reference_templateset_reference_templateSetReferenceTemplateSetReferenceTemplateSetReferenceTemplate, best_matchbest_matchBestMatchBestMatchBestMatch, fast_matchfast_matchFastMatchFastMatchFastMatch, fast_match_mgfast_match_mgFastMatchMgFastMatchMgFastMatchMg, set_offset_templateset_offset_templateSetOffsetTemplateSetOffsetTemplateSetOffsetTemplate, best_match_mgbest_match_mgBestMatchMgBestMatchMgBestMatchMg, best_match_pre_mgbest_match_pre_mgBestMatchPreMgBestMatchPreMgBestMatchPreMg, best_match_rotbest_match_rotBestMatchRotBestMatchRotBestMatchRot, best_match_rot_mgbest_match_rot_mgBestMatchRotMgBestMatchRotMgBestMatchRotMg

Module

Matching