fast_matchT_fast_matchFastMatchFastMatchfast_match (Operator)

Name

fast_matchT_fast_matchFastMatchFastMatchfast_match — Suche nach allen guten Matches eines Templates und eines Bilds.

Warnung

fast_matchfast_matchFastMatchFastMatchFastMatchfast_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.

Signatur

fast_match(Image : Matches : TemplateID, MaxError : )

Beschreibung

fast_matchfast_matchFastMatchFastMatchFastMatchfast_match führt ein Matching zwischen dem Template von TemplateIDTemplateIDTemplateIDTemplateIDtemplateIDtemplate_id und ImageImageImageImageimageimage durch. Dabei wird das Template so über die Punkte von ImageImageImageImageimageimage geschoben, dass es immer vollständig innerhalb von ImageImageImageImageimageimage liegt. Das Matching-Kriterium („displaced frame difference“) ist wie folgt definiert: Die Laufzeit des Verfahrens hängt von der Größe des Definitionsbereiches von ImageImageImageImageimageimage 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 MaxErrorMaxErrorMaxErrorMaxErrormaxErrormax_error 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 MaxErrorMaxErrorMaxErrorMaxErrormaxErrormax_error ist, werden in der Ausgaberegion MatchesMatchesMatchesMatchesmatchesmatches übergeben.

Ausführungsinformationen

Multithreading-Typ: reentrant (läuft parallel zu nicht-exklusiven Operatoren).
Multithreading-Bereich: global (kann von jedem Thread aufgerufen werden).
Automatisch parallelisiert auf Tupelebene.

Parameter

ImageImageImageImageimageimage (input_object) singlechannelimage(-array) → object (byte)

Eingabebild, in dem das Pattern gefunden werden soll.

MatchesMatchesMatchesMatchesmatchesmatches (output_object) region(-array) → object

Alle Punkte, bei denen der Fehler unter der Schwelle liegt.

TemplateIDTemplateIDTemplateIDTemplateIDtemplateIDtemplate_id (input_control) template → (handle)

Nummer des Templates.

MaxErrorMaxErrorMaxErrorMaxErrormaxErrormax_error (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 MaxError MaxError MaxError maxError max_error ≤ 255

Minimale Schrittweite: 1

Empfohlene Schrittweite: 1

Ergebnis

Sind die Parameterwerte korrekt, dann liefert fast_matchfast_matchFastMatchFastMatchFastMatchfast_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>)set_system("no_object_result",<Result>)SetSystem("no_object_result",<Result>)SetSystem("no_object_result",<Result>)SetSystem("no_object_result",<Result>)set_system("no_object_result",<Result>) festlegen. Gegebenenfalls wird eine Fehlerbehandlung durchgeführt.

Vorgänger

create_templatecreate_templateCreateTemplateCreateTemplateCreateTemplatecreate_template, read_templateread_templateReadTemplateReadTemplateReadTemplateread_template, adapt_templateadapt_templateAdaptTemplateAdaptTemplateAdaptTemplateadapt_template, draw_regiondraw_regionDrawRegionDrawRegionDrawRegiondraw_region, draw_rectangle1draw_rectangle1DrawRectangle1DrawRectangle1DrawRectangle1draw_rectangle1, reduce_domainreduce_domainReduceDomainReduceDomainReduceDomainreduce_domain

Nachfolger

connectionconnectionConnectionConnectionConnectionconnection, best_matchbest_matchBestMatchBestMatchBestMatchbest_match

Alternativen

best_matchbest_matchBestMatchBestMatchBestMatchbest_match, best_match_mgbest_match_mgBestMatchMgBestMatchMgBestMatchMgbest_match_mg, fast_match_mgfast_match_mgFastMatchMgFastMatchMgFastMatchMgfast_match_mg, exhaustive_matchexhaustive_matchExhaustiveMatchExhaustiveMatchExhaustiveMatchexhaustive_match, exhaustive_match_mgexhaustive_match_mgExhaustiveMatchMgExhaustiveMatchMgExhaustiveMatchMgexhaustive_match_mg

Modul

Matching

Operatoren