fast_matchT_fast_matchFastMatchFastMatchfast_match (算子)

名称

fast_matchT_fast_matchFastMatchFastMatchfast_match — 搜索模板和图像的所有匹配项。

警告

fast_matchfast_matchFastMatchFastMatchFastMatchfast_match 已过时，仅出于向后兼容性考虑而保留。新应用程序应改用基于形状或基于 NCC 的算子。

签名

描述

算子 fast_matchfast_matchFastMatchFastMatchFastMatchfast_match performs a matching of the template of TemplateIDTemplateIDTemplateIDTemplateIDtemplateIDtemplate_id and ImageImageImageImageimageimage. Hereby the template will be moved over the points of ImageImageImageImageimageimage so that the template always lies completely inside of ImageImageImageImageimageimage. The matching criterion (“displaced frame difference”) is defined as follows: The difference between fast_matchfast_matchFastMatchFastMatchFastMatchfast_match and exhaustive_matchexhaustive_matchExhaustiveMatchExhaustiveMatchExhaustiveMatchexhaustive_match is that the matching for one position is stopped if the error is too high. This leads to a reduced runtime but one might miss correct matches. The runtime of the operator depends mainly on the size of the domain of ImageImageImageImageimageimage. Therefore it is important to restrict the domain as far as possible, i.e. to apply the operator only in a very confined “region of interest”. The parameter MaxErrorMaxErrorMaxErrorMaxErrormaxErrormax_error determines the maximal error which the searched position is allowed to show. The lower this value is, the faster the operator runs.

All points which show a matching error smaller than MaxErrorMaxErrorMaxErrorMaxErrormaxErrormax_error will be returned in the output region MatchesMatchesMatchesMatchesmatchesmatches. This region can be used for further processing. For example by using a connection and best_matchbest_matchBestMatchBestMatchBestMatchbest_match to find all the matching objects. If no point has a match error below MaxErrorMaxErrorMaxErrorMaxErrormaxErrormax_error the empty region (i.e no points) is returned.

执行信息

• 多线程类型：可重入（与非独占算子并行运行）。
• 多线程作用域：全局（可从任何线程调用）。
• 在元组级别上自动并行化。

参数

结果

如果参数值正确，算子 fast_matchfast_matchFastMatchFastMatchFastMatchfast_match 返回值 2 ( H_MSG_TRUE )。如果输入为空（没有可用输入图像）则可设置行为通过 set_system('no_object_result',<Result>)set_system("no_object_result",<Result>)SetSystem("no_object_result",<Result>)SetSystem("no_object_result",<Result>)SetSystem("no_object_result",<Result>)set_system("no_object_result",<Result>)。如有必要，则抛出异常。

可能的前趋

create_templatecreate_templateCreateTemplateCreateTemplateCreateTemplatecreate_template, read_templateread_templateReadTemplateReadTemplateReadTemplateread_template, adapt_templateadapt_templateAdaptTemplateAdaptTemplateAdaptTemplateadapt_template, draw_regiondraw_regionDrawRegionDrawRegionDrawRegiondraw_region, draw_rectangle1draw_rectangle1DrawRectangle1DrawRectangle1DrawRectangle1draw_rectangle1, reduce_domainreduce_domainReduceDomainReduceDomainReduceDomainreduce_domain

可能的后继

connectionconnectionConnectionConnectionConnectionconnection, best_matchbest_matchBestMatchBestMatchBestMatchbest_match

替代

best_matchbest_matchBestMatchBestMatchBestMatchbest_match, best_match_mgbest_match_mgBestMatchMgBestMatchMgBestMatchMgbest_match_mg, fast_match_mgfast_match_mgFastMatchMgFastMatchMgFastMatchMgfast_match_mg, exhaustive_matchexhaustive_matchExhaustiveMatchExhaustiveMatchExhaustiveMatchexhaustive_match, exhaustive_match_mgexhaustive_match_mgExhaustiveMatchMgExhaustiveMatchMgExhaustiveMatchMgexhaustive_match_mg

模块

匹配