# FindMultiLine

Sucht nach mehreren geraden Kanten in einem Bildbereich. FindMultiLine bildet eindimensionale Projektionen des Bildbereichs durch Summieren von Pixelwerten auf radialen Liniensegmenten, die in positiver y-Richtung relativ zum lokalen Koordinatensystem des Bereichs gescannt werden. Kantenübergänge werden aus den projizierten Bilddaten extrahiert.

## FindMultiLine – Eingaben

Parameter | Beschreibung
Bild | This parameter must reference a spreadsheet cell that contains an Bild data structure; by default, this parameter references A0, the cell containing the data structure. This parameter can also reference other Image data structures, such as those returned by the Image Vision Data Access functions or Koordinatenumrechnungsfunktionen.
Vorrichtung | Definiert den Inspektionsbereich (ROI) relativ zu einer Vorrichtung als Eingabe oder die Ausgabe des Bildkoordinatensystems einer Vision Tools-Funktion. Wenn man den Inspektionsbereich (ROI) relativ zu einer Vorrichtung bestimmt, stellt man sicher, dass beim Drehen oder Umsetzen der Vorrichtung auch der Inspektionsbereich (ROI) 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)
Bereich | Auch als Inspektionsbereich (ROI) bezeichnet; gibt den Bereich des Bilds an, der einer Analyse unterzogen wird. Doppelklicken Sie auf den Parameter „Bereich“, um einen Interaktiver Grafikmodus zu erstellen, den Sie transformieren und drehen können. Wählen Sie diesen Parameter aus und klicken Sie in der Symbolleiste „Job bearbeiten“ des Eigenschaftsblatts auf die Schaltfläche „Bereich maximieren“, um den Bereich automatisch so zu dehnen, dass er das gesamte Bild einnimmt.
X | Der x-Offset vom Ursprung in Vorrichtungskoordinaten.
Y | Der y-Offset vom Ursprung im Vorrichtungskoordinatensystem.
Breite | Die Abmessung entlang der x-Achse des Bereichs.
Höhe | Die Abmessung entlang der y-Achse des Bereichs.
Winkel | Die Ausrichtung im Vorrichtungskoordinatensystem.
Krümmung | Die Winkelabweichung zwischen der x-Achse des Bereichs und der gegenüberliegenden Grenzlinie des Bereichs.
Hinweis: Die Parameter Vorrichtung und Bereich müssen innerhalb der Bildgrenzen festgelegt werden. Andernfalls gibt die Funktion #ERR zurück.
Anzahl | Gibt die maximale Anzahl der Kanten an, die die Funktion zurückgibt (von 1 bis zur Bildbreite des Sensors, minus 1; Standard = 3). Die maximale Anzahl von Kanten, die erkannt werden können, ist einen Inkrementwert geringer als die Breite des Bilds für die jeweilige In-Sight-Kamera, die das Bild aufnimmt (d. h. bei einer Bildauflösung von 1600 x 1200 des Vision-Systems wäre der Höchstwert einer ISC 8402-Kamera 1599).
Schwellwert: S->W | Gibt die minimal akzeptable Kantenkontrastgüte für Schwarz-nach-Weiß an (0 bis 100; Standard = 25). FindMultiLine verwirft alle Schwarz-nach-Weiß-Kanten, deren Kontrastgüte unter dem Wert Schwellenwert: S->W liegt. Kantenkontrast ist durch das Graustufen-Histogramm des Scanbereichs normalisiert.
Schwellenwert: W->S | Gibt die minimal akzeptable Kantenkontrastgüte für Weiß -nach-Schwarz an (0 bis 100; Standard = 25). FindMultiLine verwirft alle Weiß-nach-Schwarz-Kanten, deren Kontrastgüte unter dem Wert Schwellenwert: W->S liegt. Kantenkontrast ist durch das Graustufen-Histogramm des Scanbereichs normalisiert.
Güte normalisieren | Gibt an, ob die Kantengüten durch das Graustufen-Histogramm des Bereichs normalisiert werden. Bei Aktivierung von Güte normalisieren werden Rohkantengüten anhand des maximalen Kontrasts normalisiert, der innerhalb des Bildbereichs gefunden wird, wobei die folgende Formel verwendet wird: Ergebnis = (Rohkantengüte) x (100/max. Kontrast) Wobei Rohkantengüte die Graustufendifferenz über die gesamte Kante und Max. Kontrast die Differenz zwischen der maximalen und minimalen Graustufe (0 bis 255) innerhalb des Bildbereichs ist. Bei Deaktivierung von Güte normalisieren werden Kanten mit niedrigem Kontrast niedriger bewertet als Kanten mit hohem Kontrast. Dabei wird folgende Formel verwendet: Punktzahl = (Rohkantengüte) x (100/255)
0 = AUS | Die Güte nicht normalisieren.
1 = EIN (Standard) | Die Güte normalisieren.
Hinweis: Tipp: Dieser Parameter ist nützlich, um Kanten in einem Bereich mit niedrigem Kontrast zu finden. Wenn Sie davon ausgehen, dass die zu erkennenden Kanten nur einen hohen Kontrast aufweisen, deaktivieren Sie diesen Parameter.
Suchkriterium | Gibt die Kantenauswahltechnik an, die die Funktion verwendet, um eine Kante unter mehreren Kantenkandidaten auszuwählen.
0 = stärkste Kante (Standard) | Gibt an, dass die Kante mit der höchsten Güte die höchste Berücksichtigung erhält.
1 = erste Kante | Gibt an, dass die erste erkannte Kante die höchste Berücksichtigung erhält.
2 = letzte Kante | Gibt an, dass die letzte erkannte Kante die höchste Berücksichtigung erhält.
Winkelbereich | Gibt die Toleranz der Funktion gegenüber Kantendrehung an (0 bis 10; Standard = 0). Die Funktion findet weiterhin Kanten, die außerhalb des angegebenen Bereichs liegen, die Genauigkeit ist aber möglicherweise nicht so hoch. Hinweis: Wenn der Wert dieses Parameters größer als 0 ist, wird die Geschwindigkeit der Funktion verringert.
Kantenbreite | Gibt den Abstand in Pixel (1 bis 50; Standard = 3) an, über den hinaus ein Kantenübergang stattfindet. Kantenbreite wird zum Filtern des Bilds verwendet, bevor die Kanten extrahiert werden.
Anzeigen | Legt den Anzeigemodus für FindMultiLine-Grafiküberlagerungen fest, die über dem Bild angezeigt werden.
0 = Alle ausblenden (Standard) | Alle Grafiken werden ausgeblendet, es sei denn, die Zelle mit der Funktion „FindMultiLine“ ist in der Tabelle aktiv.
1 = Nur Ergebnis-Grafik | Die gefundenen Kanten werden immer angezeigt.
2 = Eingabe- und Ergebnis-Grafik | Der Eingabebildbereich und die gefundenen geraden Kanten werden immer angezeigt.
3 = Alles anzeigen: Eingabe, Ergebnis und Diagramm | Der Eingabebildbereich, die gefundenen geraden Kanten und das Kantenverlaufsdiagramm werden immer angezeigt. Hinweis: Das Kantenverlaufsdiagramm ist ein andockbares Fenster. Weitere Informationen hierzu finden Sie im Thema Tabelleneditor – Diagramme.

## FindMultiLine – Ausgaben

Rückgabewert | Eine Kante-Datenstruktur mit mehreren geradlinigen Kantensegmenten oder #ERR, wenn ein oder mehrere Eingabeparameter ungültig sind.
Ergebnisse | Wenn FindMultiLine erstmals in eine Zelle eingefügt wird, wird in der Tabelle eine Ergebnistabelle erstellt. Eine Edges Vision Data Access functions wird automatisch in die Tabelle eingefügt, um die Ergebnistabelle zu erstellen:
Label | Funktion | Beschreibung
--- | --- | ---
Anzahl gefunden | GetNFound(Kanten) | NFound ist die Anzahl der gefundenen Kanten.
Über Edges Vision Data Access functions kann auf zusätzliche Datenelemente zugegriffen werden.