adapt_templateT_adapt_templateAdaptTemplateAdaptTemplateadapt_template (Operator)

Name

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

Warning

adapt_templateadapt_templateAdaptTemplateAdaptTemplateAdaptTemplateadapt_template 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_templateAdaptTemplateAdaptTemplateAdaptTemplateadapt_template serves to adapt a template which has been created by create_templatecreate_templateCreateTemplateCreateTemplateCreateTemplatecreate_template to the size of an image. The operator adapt_templateadapt_templateAdaptTemplateAdaptTemplateAdaptTemplateadapt_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 ImageImageImageImageimageimage 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:

TemplateIDTemplateIDTemplateIDTemplateIDtemplateIDtemplate_id

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

Parameters

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

Image which determines the size of the later matching.

TemplateIDTemplateIDTemplateIDTemplateIDtemplateIDtemplate_id (input_control, state is modified) template → (handle)

Template number.

Result

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

Possible Predecessors

create_templatecreate_templateCreateTemplateCreateTemplateCreateTemplatecreate_template, create_template_rotcreate_template_rotCreateTemplateRotCreateTemplateRotCreateTemplateRotcreate_template_rot, read_templateread_templateReadTemplateReadTemplateReadTemplateread_template

Possible Successors

set_reference_templateset_reference_templateSetReferenceTemplateSetReferenceTemplateSetReferenceTemplateset_reference_template, best_matchbest_matchBestMatchBestMatchBestMatchbest_match, fast_matchfast_matchFastMatchFastMatchFastMatchfast_match, fast_match_mgfast_match_mgFastMatchMgFastMatchMgFastMatchMgfast_match_mg, set_offset_templateset_offset_templateSetOffsetTemplateSetOffsetTemplateSetOffsetTemplateset_offset_template, best_match_mgbest_match_mgBestMatchMgBestMatchMgBestMatchMgbest_match_mg, best_match_pre_mgbest_match_pre_mgBestMatchPreMgBestMatchPreMgBestMatchPreMgbest_match_pre_mg, best_match_rotbest_match_rotBestMatchRotBestMatchRotBestMatchRotbest_match_rot, best_match_rot_mgbest_match_rot_mgBestMatchRotMgBestMatchRotMgBestMatchRotMgbest_match_rot_mg

Module

Matching

Operators