set_reference_template ( : : TemplateID, Row, Column : )

Define reference position for a matching template.

set_reference_template allows to define a new reference position for a template. As default after calling create_template or create_template_rot the center of gravity of the template is used. Using set_reference_template 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.


Parameters

TemplateID (input_control)
template -> integer
Template number.

Row (input_control)
point.y -> real
Reference position of template (row).

Column (input_control)
point.x -> real
Reference position of template (column).


Result

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


Parallelization Information

set_reference_template is processed under mutual exclusion against itself and without parallelization.


Possible Predecessors

create_template, create_template_rot, read_template, adapt_template


Possible Successors

best_match, best_match_mg, best_match_rot, fast_match, fast_match_mg


Module

Template matching



Copyright © 1996-2005 MVTec Software GmbH