fast_mg_match ( Image : Matches : MaxError, Level, TemplateID : )

Searching all good grayvalue matches in a pyramid.

The operator fast_mg_match like the operator fast_match performs a matching of the template of TemplateID and Image. In contrast to fast_match, however, the search for good matches starts in scaled down images (pyramid). The number of levels of the pyramid will be determined by Level. Hereby the value 1 indicates that no pyramid will be used. In this case the operator fast_mg_match is equivalent to the operator fast_match. The value 2 triggers the search in the image with half the framesize. The search for all those points showing an error small enough in the scaled down image (error smaller than MaxError) will be refined at the corresponding positions in the original image (Image). Level indicates the number of levels of the pyramid, including the original image.


Parameters

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

Matches (output_object)
region(-array) -> object
All points which have an error below a certain threshold.

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

Level (input_control)
integer -> integer
Number of levels in the pyramid.
Default value: 3
Suggested values: 1, 2, 3, 4, 5, 6
Range of values: 1 <= Level <= 10
Minimum increment: 1
Recommended increment: 1

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


Result

If the parameter values are correct, the operator fast_mg_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

best_match, fast_mg_match, match__, mg_match__



Copyright © 1996-1997 MVTec Software GmbH