set_reference_templateT_set_reference_templateSetReferenceTemplateSetReferenceTemplate (Operator)
Name
set_reference_templateT_set_reference_templateSetReferenceTemplateSetReferenceTemplate — Define reference position for a matching template.
Warning
set_reference_templateset_reference_templateSetReferenceTemplateSetReferenceTemplateSetReferenceTemplate is obsolete and is only provided for
reasons of backward compatibility. New applications should use the
shape-based or NCC-based operators instead.
Signature
Herror T_set_reference_template(const Htuple TemplateID, const Htuple Row, const Htuple Column)
Description
set_reference_templateset_reference_templateSetReferenceTemplateSetReferenceTemplateSetReferenceTemplate allows to define
a new reference position for a template.
As default after calling create_templatecreate_templateCreateTemplateCreateTemplateCreateTemplate or
create_template_rotcreate_template_rotCreateTemplateRotCreateTemplateRotCreateTemplateRot
the center of gravity of the template is used.
Using set_reference_templateset_reference_templateSetReferenceTemplateSetReferenceTemplateSetReferenceTemplate the reference position can
be redefined. In the case of the center of gravity as
reference the vector (0,0) is returned after matching
for a null translation of the pattern relative to the image.
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:
During execution of this operator, access to the value of this parameter must be synchronized if it is used across multiple threads.
Parameters
TemplateIDTemplateIDTemplateIDTemplateIDtemplateID (input_control, state is modified) template → HTemplate, HTupleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)
Template number.
RowRowRowRowrow (input_control) point.y → HTupleHTupleHtuple (real) (double) (double) (double)
Reference position of template (row).
ColumnColumnColumnColumncolumn (input_control) point.x → HTupleHTupleHtuple (real) (double) (double) (double)
Reference position of template (column).
Result
If the parameter values are correct, the operator
set_reference_templateset_reference_templateSetReferenceTemplateSetReferenceTemplateSetReferenceTemplate
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,
adapt_templateadapt_templateAdaptTemplateAdaptTemplateAdaptTemplate
Possible Successors
best_matchbest_matchBestMatchBestMatchBestMatch,
best_match_mgbest_match_mgBestMatchMgBestMatchMgBestMatchMg,
best_match_rotbest_match_rotBestMatchRotBestMatchRotBestMatchRot,
fast_matchfast_matchFastMatchFastMatchFastMatch,
fast_match_mgfast_match_mgFastMatchMgFastMatchMgFastMatchMg
Module
Matching