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