set_offset_templateset_offset_templateset_offset_templateSetOffsetTemplateSetOffsetTemplate (Operator)

Name

set_offset_templateset_offset_templateset_offset_templateSetOffsetTemplateSetOffsetTemplate — Gray value offset for template.

Signature

Description

set_offset_templateset_offset_templateset_offset_templateSetOffsetTemplateSetOffsetTemplate adds a gray value offset to the template to eliminate gray value changes in the image. The parameter GrayOffsetGrayOffsetGrayOffsetGrayOffsetgrayOffset specifies a difference relative to the gray values of the pattern when it was created with create_templatecreate_templatecreate_templateCreateTemplateCreateTemplate (not relative to the last call of set_offset_templateset_offset_templateset_offset_templateSetOffsetTemplateSetOffsetTemplate). The values of GrayOffsetGrayOffsetGrayOffsetGrayOffsetgrayOffset 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_templateset_offset_templateset_offset_templateSetOffsetTemplateSetOffsetTemplate has to be called each time the gray values of the image changes. The gray values can be meassured in a reference area using intensityintensityintensityIntensityIntensity or min_max_graymin_max_graymin_max_grayMinMaxGrayMinMaxGray

Parallelization

• Multithreading type: reentrant (runs in parallel with non-exclusive operators).
• Multithreading scope: global (may be called from any thread).
• Processed without parallelization.

Parameters

Result

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

Possible Predecessors

create_templatecreate_templatecreate_templateCreateTemplateCreateTemplate, adapt_templateadapt_templateadapt_templateAdaptTemplateAdaptTemplate, read_templateread_templateread_templateReadTemplateReadTemplate

Possible Successors

best_matchbest_matchbest_matchBestMatchBestMatch, best_match_mgbest_match_mgbest_match_mgBestMatchMgBestMatchMg, best_match_rotbest_match_rotbest_match_rotBestMatchRotBestMatchRot, fast_matchfast_matchfast_matchFastMatchFastMatch, fast_match_mgfast_match_mgfast_match_mgFastMatchMgFastMatchMg

Module

Matching