best_match_pre_mg — Searching the best grayvalue matches in a pre generated pyramid.
best_match_pre_mg is obsolete and is only provided for reasons of backward compatibility. New applications should use the shape-based or NCC-based operators instead.
best_match_pre_mg applies gray value matching using an image pyramid. best_match_pre_mg works analogously to best_match_mg, but it makes use of pre calculated pyramid which has to be generated beforehand using gen_gauss_pyramid. This reduces runtime if more than one match has to be done or the pyramid has be used otherwise. The pyramid has to be generated using the zooming factor 0.5 and the mode 'constant'.
Image pyramid inside of which the pattern has to be found.
Maximal average difference of the grayvalues.
Default value: 30.0
Suggested values: 0.0, 1.0, 2.0, 3.0, 4.0, 5.0, 6.0, 7.0, 9.0, 11.0, 15.0, 17.0, 20.0, 30.0, 40.0, 50.0, 60.0, 70.0
Typical range of values: 0 ≤ MaxError ≤ 255
Minimum increment: 1
Recommended increment: 3
Exactness in subpixels in case of 'true'.
Default value: 'false'
List of values: 'false', 'true'
Number of the used resolution levels.
Default value: 3
Suggested values: 1, 2, 3, 4, 5, 6
Resolution level up to which the method “best match” is used.
Default value: 'original'
Suggested values: 'all', 'original', 0, 1, 2, 3, 4, 5, 6
Row position of the best match.
Column position of the best match.
Average divergence of the grayvalues in the best match.
If the parameter values are correct, the operator best_match_pre_mg returns the value 2 (H_MSG_TRUE). If the input is empty (no input images are available) the behaviour can be set via set_system('no_object_result',<Result>). If necessary, an exception is raised.
gen_gauss_pyramid, create_template, read_template, adapt_template, draw_region, draw_rectangle1, reduce_domain, set_reference_template
fast_match, fast_match_mg, exhaustive_match, exhaustive_match_mg