best_mg_match ( Image : : MaxError, SubPixel, NumLevels, WhichLevels, TemplateID : Row, Column, Error )

Searching the best grayvalue matches in a pyramid.

Searching the best grayvalue matches in a pyramid.


Parameters

Image (input_object)
image(-array) -> object : byte
Input image inside of which the pattern has to be found.

MaxError (input_control)
real -> real
Maximal average difference of the grayvalues.
Default value: 5
Suggested values: 0, 1, 2, 3, 4, 5, 6, 7, 9, 11, 15, 17, 20, 30
Range of values: 0 <= MaxError <= 255
Minimum increment: 1
Recommended increment: 1

SubPixel (input_control)
string -> string
Exactness in subpixels in case of 'true'.
Default value: 'false'
List of values: 'true', 'false'

NumLevels (input_control)
integer -> integer
Number of the used resolution levels.
Default value: 2
List of values: 1, 2, 3, 4, 5, 6

WhichLevels (input_control)
string -> string
Resolution levels with the best match.
Default value: 'original'
List of values: 'all', 'original'

TemplateID (input_control)
integer -> integer
Template number.
Default value: 0

Row (output_control)
number -> real / integer
Row position of the best match.
Default value: 'false'

Column (output_control)
number -> real / integer
Column position of the best match.
Default value: 'false'

Error (output_control)
real -> real
Average divergence of the grayvalues in the best match.
Default value: 'false'


Result

If the parameter values are correct, the operator best_match returns the value 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.


Possible Predecessors

adapt_template, draw_region, draw_rectangle1, reduce_domain


Alternatives

fast_match, fast_mg_match, match__, mg_match__



Copyright © 1996-1997 MVTec Software GmbH