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 : )

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

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:

TemplateIDTemplateIDTemplateIDTemplateIDtemplateID

The value of this parameter may not be shared across multiple threads without external synchronization.

Parameters

ImageImageImageImageimage (input_object) singlechannelimage(-array) → object (byte)

Image which determines the size of the later matching.

TemplateIDTemplateIDTemplateIDTemplateIDtemplateID (input_control, state is modified) template → (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