F_VN_MatchTemplateWalsh
Match a template image with every location in the source image (using the Walsh transform) and return the comparison results.
Can use available TwinCAT Job Tasks for executing parallel code regions.
Can return partial results when canceled by Watchdog.
Syntax
Definition:
FUNCTION F_VN_MatchTemplateWalsh : HRESULT
VAR_INPUT
ipSrcImage : ITcVnImage;
ipTemplateImage : ITcVnImage;
ipResultImage : Reference To ITcVnImage;
nProjections : UDINT;
hrPrev : HRESULT;
END_VARInputs
|
Name |
Type |
Description |
|---|---|---|
|
ipSrcImage |
Source image (USINT or SINT, 1 or 3 channels) | |
|
ipTemplateImage |
Template image (same type as ipSrcImage, smaller width and height) | |
|
ipResultImage |
Reference To ITcVnImage |
Returns the result image (REAL, normalized to [0..1], 1 channel, dimensions: (ipSrcImage.width - ipTemplateImage.width + 1) x (ipSrcImage.height - ipTemplateImage.height + 1). The best match is the global minimum. The position in ipResultImage is the top-left corner of ipTemplateImage position in ipSrcImage.) |
|
nProjections |
UDINT |
Number of Walsh projections to be used. The higher nProjections the more details are considered for matching. As the most relevant information is captured by the first Walsh projections, a small number (e.g., 5, 10, 25, or 50) is sufficient for many use cases. Each projection requires additional computation time. Therefore, it is advantageous to choose a low number of Walsh projections as long as the matching requirements are fulfilled. The allowed maximum of nProjections is determined by the width and the height of the template image. |
|
hrPrev |
HRESULT indicating the result of previous operations (If SUCCEEDED(hrPrev) equals false, no operation is executed.) |
Weiterführende Informationen
Die Funktion F_VN_MatchTemplateWalsh verwendet die Walsh-Transformation, um alle Instanzen eines Referenzbildes (Template) im Suchbild zu lokalisieren und gibt die Ähnlichkeitswerte als Ergebnisbild zurück. Das Template wird ausschließlich in seiner ursprünglichen Ausrichtung mit jeder möglichen Position im Eingangsbild verglichen.
Parameter
Eingangsbild
Das Eingangsbild ipSrcImage muss ein 1- oder 3-kanaliges Bild vom Typ USINT oder SINT sein. Bei einem 3-kanaligen Bild wird das Matching gemeinsam in allen drei Kanälen durchgeführt, was auch zu mehr Rechenzeit führt.
Templatebild
Das Templatebild ipTemplateImage muss vom gleichen Typ wie ipSrcImage sein und kleinere Dimensionen (Höhe und Breite) aufweisen als das Eingangsbild.
Ergebnisbild
Das Ergebnisbild ipResultImage ist ein einkanaliges REAL-Bild mit folgenden Dimensionen:
- Breite:
ipSrcImage.Width - ipTemplateImage.Width + 1 - Höhe:
ipSrcImage.Height - ipTemplateImage.Height + 1 - Kanäle: Ein Kanal pro geprüftem Rotationsschritt (Default: 1)
Jeder Pixelwert repräsentiert die Ähnlichkeit zwischen dem Template und dem entsprechenden Bildausschnitt im Eingangsbild. Ein kleinerer Wert bedeutet dabei eine höhere Übereinstimmung. Das globale Minimum über alle Kanäle markiert den besten Match. Die Position des Minimums im Ergebnisbild entspricht der linken oberen Ecke der Templateposition im Eingangsbild.
Zur Auswertung kann beispielsweise F_VN_MinPixelValue verwendet werden, um den minimalen Pixelwert sowie die zugehörige Position und den Kanal zu bestimmen.
Anzahl an Walsh-Projektionen
Der Parameter nProjections legt fest, wie viele Walsh-Projektionen für das Matching verwendet werden. Niedrige Projektionszahlen erfassen vor allem grobe Bildstrukturen, höhere Projektionszahlen bilden zunehmend feinere Details ab, erhöhen jedoch die Rechenzeit. Daher sollte nProjections so niedrig wie möglich, aber so hoch wie nötig gewählt werden. In vielen Anwendungen sind 5–50 Projektionen ausreichend. Die zulässige Obergrenze von nProjections ist durch die Breite und Höhe des Template-Bildes begrenzt.
Verwandte Funktionen
- F_VN_FindTemplateWalsh(Exp): Sucht ein Template im Eingangsbild und gibt eine sortierte Liste gefundener Matches zurück.
- F_VN_FindTemplateWalsh(Exp)_AngleRange: Wie
F_VN_FindTemplateWalsh(Exp), jedoch mit frei definierbarem Winkelbereich und beliebiger Anzahl an Winkelschritten für gezielte Laufzeit- und Genauigkeitsoptimierung. - F_VN_MatchTemplateWalsh(Exp): Vergleicht ein Template mit jedem Ort im Eingangsbild und gibt das rohe Ergebnisbild zur applikationsspezifischen Nachverarbeitung zurück.
Required License
TC3 Vision Matching
System Requirements
Development environment | Target platform | PLC libraries to include |
|---|---|---|
TwinCAT V3.1.4026 or later | PC or CX (x64) with min. PL50, e.g. Intel 4-core Atom CPU | Tc3_Vision |