# SortPatterns

Sortiert Muster entsprechend ihrer Position im Bild. Für jedes Muster in der Eingabe-Patterns-Datenstruktur berechnet SortPatterns die Position der Musterübereinstimmung relativ zum angegebenen Vorrichtungskoordinatensystem des Bilds. Muster können nach folgenden Optionen sortiert werden: x-Koordinate, y-Koordinate, Winkel, Winkelabstand, Abstand oder Gitter. Die sortierten Muster werden als neue Patterns-Datenstruktur zurückgegeben.

## SortPatterns – Eingaben

Parameter | Beschreibung
Muster | Dieses Argument muss auf eine Tabellenzelle verweisen, die eine gültige Patterns-Datenstruktur enthält, die von der Funktion zurückgegeben wird.
Zu sort. Anzahl | Legt die maximale Anzahl (1 bis 255; Standard = 1) der zu sortierenden Muster fest.
Sortieren nach | Legt die Sortiermethode fest.
0 = Y (Standard) | Sortierung nach dem Abstand entlang der y-Koordinate der Vorrichtung, von klein nach groß.
1 = X | Sortierung nach dem Abstand entlang der x-Koordinate der Vorrichtung, von klein nach groß.
2 = Winkel | Sortierung nach dem Winkel (0 bis 360 Grad), gemessen gegen den Uhrzeigersinn von der y-Achse des Koordinatensystems der Vorrichtung zum Liniensegment, definiert durch den Übereinstimmungspunkt des Musters und den Vorrichtungsursprung, vom nächsten zum entferntesten, in absteigender Reihenfolge.
3 = Winkelabstand | Nach Absolutwert des Winkels sortieren (-180 bis 180 Grad), gemessen von der x-Achse des Vorrichtung-Koordinatensystems bis zur Strecke definiert durch den Reaktionspunkt des Musters und dem Ursprung der Vorrichtung, vom kleinsten bis zum weitesten, in absteigender Reihenfolge.
4 = Abstand | Nach Abstand vom Ursprung der Vorrichtung bis zum Reaktionspunkt des Musters sortieren, vom kürzesten bis zum längsten, in absteigender Reihenfolge.
5 = Gitter Y | Sortierung nach dem Abstand zuerst entlang der y-Koordinate der Vorrichtung und dann entlang der x-Koordinate, vom nächsten bis zum entferntesten, in absteigender Reihenfolge. Hinweis: SortPatterns gibt #ERR zurück, wenn Gitter Y ausgewählt ist und die Funktion auf ein Bild verweist, das auf Weltkoordinatenwerte kalibriert wurde, z. B. die Ausgabe einer CalibrateImage- oder TransPatternsToWorld-Funktion. Sortieren nach Gitter Y kann nur auf Pixelkoordinaten angewendet werden.
6 = Gitter X | Sortierung nach dem Abstand zuerst entlang der x-Koordinate der Vorrichtung und dann entlang der y-Koordinate, vom nächsten bis zum entferntesten, in absteigender Reihenfolge. Hinweis: SortPatterns gibt #ERR zurück, wenn Gitter Y ausgewählt ist und die Funktion auf ein Bild verweist, das auf Weltkoordinatenwerte kalibriert wurde, z. B. die Ausgabe einer CalibrateImage- oder TransPatternsToWorld-Funktion. Sortieren nach Gitter Y kann nur auf Pixelkoordinaten angewendet werden.
Vorrichtung | Definiert das referenzierte Muster im Verhältnis zu einer Vorrichtung als Eingang oder zu einem Ausgang des Bildkoordinatensystems einer Vision Tools-Funktion. Wenn man das referenzierte Muster im Verhältnis zu einer Vorrichtung bestimmt, stellt man sicher, dass beim Drehen oder Umsetzen der Vorrichtung auch das referenzierte Muster im Verhältnis zur Vorrichtung gedreht oder umgesetzt wird. Die Standardeinstellung ist (0,0,0), die oberste linke Ecke des Bilds.
X | Der x-Offset in Bildkoordinaten.
Y | Der y-Offset in Bildkoordinaten.
Winkel | Die Drehung von der x-Bildachse im Bildkoordinatensystem. (+/-360 Grad im Uhrzeigersinn)
Sortiertoleranz | Legt die prozentuale Größe (1% bis 500%; Standard = 50%) der Höhe des eingelernten Musters fest, bei der ein gefundenes Muster in der Gruppe von Mustern inkludiert werden muss bei der Sortierung nach entweder Gitter X oder Gitter Y. Hinweis: Dieser Parameter wird nur verwendet, wenn der Parameter „Sortieren nach“ entweder auf Gitter X oder Gitter Y eingestellt ist.
Anzeigen | Definiert den Anzeigemodus für die Überlagerung der SortPatterns-Grafiken auf dem Bild.
0 = Alle ausblenden (Standard) | Alle Grafiken werden nur angezeigt, wenn die Zelle mit der SortPatterns-Funktion in der Tabelle markiert ist.
1 = Nur Ergebnis-Grafik | Es wird für jedes gefundene Muster immer ein Kreuz angezeigt.
3 = Alles anzeigen: Eingabe, Ergebnis und Übereinstimmungsmerkmale | Der Eingabebildbereich, ein Kreuz für jedes gefundene Muster und die Übereinstimmungsmerkmale werden immer angezeigt. Hinweis: Übereinstimmungsmerkmale werden nur für über PatMax eingelernte Muster angezeigt.

## SortPatterns – Ausgaben

Rückgabewert | Eine Patterns-Datenstruktur, die die sortierten Musterübereinstimmungspunkte enthält, oder #ERR, wenn einer der Eingabeparameter ungültig ist.
Ergebnisse | Wenn „SortPatterns“ erstmals in eine Zelle eingefügt wird, wird mit den folgenden Patterns Vision Data Access functions eine Ergebnistabelle in der Tabelle erstellt:
Label | Funktion | Beschreibung
X | GetX(Muster, Index) | Die x-Koordinate der Musterposition.
Y | GetY(Muster, Index) | Die y-Koordinate der Musterposition.
Winkel | GetAngle(Muster, Index) | Dies ist die Ausrichtung der Musterposition.
Skalieren | GetScale(Muster, Index) | Prozentuale Größe des Originalmodells.
Güte | GetScore(Muster, Index) | Die Güte der Musterreaktionen.
Hinweis: Wenn der Wert des Parameters Zu sort. Anzahl größer als Null ist, fügt SortPatterns automatisch eine Ergebnistabelle mit maximal 10 Einträgen ein, die den ersten 10 Mustern in der Patterns-Datenstruktur entsprechen. Möchten Sie mehr Einträge anzeigen lassen, können Sie die Tabelle durch kopieren der letzten Zeile und das Einfügen weiterer Zeilen am Ende erweitern. Vergewissern Sie sich, dass der Index der neu eingefügten Zeilen inkrementiert wird, so dass das korrekte Muster indiziert wird.