Herror ::set_reference_template (
    const HTuple &TemplateID,
    const HTuple &Row,
    const HTuple &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 -> HTuple.long
Template number.

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

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


Result

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


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

Gray value template matching



Copyright © 1996-2002 MVTec Software GmbH