fast_match
— Suche nach allen guten Matches eines Templates und eines Bilds.
fast_match
ist veraltet und wird nur aus Gründen
der Rückwärtskompatibilität zur Verfügung gestellt. Neue
Applikationen sollten stattdessen die
Form-basierten oder NCC-basierten Operatoren verwenden.
fast_match(Image : Matches : TemplateID, MaxError : )
fast_match
führt ein Matching zwischen dem Template von
TemplateID
und Image
durch.
Dabei wird das Template so über die Punkte von
Image
geschoben, dass es immer vollständig innerhalb von
Image
liegt.
Das Matching-Kriterium („displaced frame difference“)
ist wie folgt definiert:
Die Laufzeit des Verfahrens hängt von der Größe des Definitionsbereiches
von Image
ab.
Es ist daher wichtig, den Definitionsbereich
möglichst einzugrenzen,
d.h. den Operator nur in einer möglichst eng umrissenen
„region of interest“ anzuwenden.
Der Parameter MaxError
legt den maximalen Fehler fest,
den die gesuchten Positionen haben dürfen.
Um so kleiner dieser Wert ist, um so schneller läuft das Verfahren.
Alle Punkte, bei denen der Fehler des Matching kleiner als
MaxError
ist, werden in der Ausgaberegion
Matches
übergeben.
Image
(input_object) singlechannelimage(-array) →
object (byte)
Eingabebild, in dem das Pattern gefunden werden soll.
Matches
(output_object) region(-array) →
object
Alle Punkte, bei denen der Fehler unter der Schwelle liegt.
TemplateID
(input_control) template →
(handle)
Nummer des Templates.
MaxError
(input_control) real →
(real)
Maximale mittlere Differenz der Grauwerte.
Defaultwert: 20.0
Wertevorschläge: 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
Typischer Wertebereich: 0
≤
MaxError
≤
255
Minimale Schrittweite: 1
Empfohlene Schrittweite: 1
Sind die Parameterwerte korrekt, dann liefert fast_match
den Wert 2 (H_MSG_TRUE).
Das Verhalten bei leerer Eingabe (keine Eingabebilder vorhanden) lässt
sich mittels set_system('no_object_result',<Result>)
festlegen. Gegebenenfalls wird eine Fehlerbehandlung durchgeführt.
create_template
,
read_template
,
adapt_template
,
draw_region
,
draw_rectangle1
,
reduce_domain
best_match
,
best_match_mg
,
fast_match_mg
,
exhaustive_match
,
exhaustive_match_mg
Matching