Herror ::set_offset_template (
    const HTuple &TemplateID,
    const HTuple &GrayOffset
)

Gray value offset for template.

::set_offset_template adds a gray value offset to the template to eliminate gray value changes in the image. The parameter GrayOffset specifies a difference relative to the gray values of the pattern when it was created with ::create_template (not relative to the last call of ::set_offset_template). The values of GrayOffset has to be chosen according to the gray values of the image: A brighter image results in a positive value, a darker image results in a negative value. ::set_offset_template has to be called each time the gray values of the image changes. The gray values can be meassured in a reference area using ::intensity or ::min_max_gray


Parameters

TemplateID (input_control)
template -> HTuple.long
Template number.

GrayOffset (input_control)
number -> HTuple.long
Offset of gray values.
Default value: 0
Suggested values: -10, -5, -2, -1, 0, 1, 2, 5, 10
Typical range of values: -255 <= GrayOffset <= 255
Minimum increment: 1
Recommended increment: 1


Result

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


Possible Predecessors

::create_template, ::adapt_template, ::read_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