# FindLine

Sucht nach einer geraden Kante in einer Bildregion. FindLine bildet eine eindimensionale Projektionen der Bildregion durch Summieren von Pixelwerten auf radialen Strecken, die in der positiven y-Richtung des lokalen Koordinatensystems der Region gescannt werden. Kantenübergänge werden aus den projizierten Bilddaten extrahiert.

## FindLine – 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.
Polarität | Gibt die Polarität der zu lokalisierenden Kante relativ zur Scanrichtung des Kantenbereichs an. Die Funktion gibt nur Kanten der angegebenen Polarität zurück. Hinweis: Wenn Sie ein horizontales oder vertikales lineares Kantenmerkmal als Vorrichtungseingabe verwenden, berücksichtigt die Funktion nur die Bewegung der Kante in eine Richtung, entweder entlang der horizontalen oder der vertikalen Achse, je nach Position der Scanrichtung des Inspektionsbereichs (ROI).
0 = Schwarz -> Weiß | Gibt an, dass die Kantenpolarität Schwarz -> Weiß ist.
1 = Weiß -> Schwarz | Gibt an, dass die Kantenpolarität Weiß -> Schwarz ist.
2 = Beide (Standard) | Gibt an, dass die Kantenpolarität entweder Schwarz -> Weiß oder Weiß -> Schwarz sein kann.
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.
Akzeptanzschwelle | Gibt den minimal akzeptablen Kantenkontrast (0 bis 100; Standard = 25) an. Der Kontrastwert wird vom Graustufen-Histogramm innerhalb des Bereichs auf eine Skala von 0 bis 100 normalisiert. Die Funktion lehnt alle Kanten ab, deren Kontrastgüte unter diesem Wert liegt.
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.
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.
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 FindLine-Grafiküberlagerungen fest, die über dem Bild angezeigt werden.
0 = Alle ausblenden (Standard) | Alle Grafiken werden nur angezeigt, wenn die Zelle mit der FindLine-Funktion in der Tabelle aktiv ist.
1 = Nur Ergebnis-Grafik | Die gefundenen Kanten werden immer angezeigt.
2 = Eingabe- und Ergebnis-Grafik | Der Eingabebildbereich und die gerade Kante werden immer angezeigt.
3 = Alles anzeigen: Eingabe, Ergebnis und Diagramm | Der Eingabebildbereich, die gerade Kante und das Kantenverlaufsdiagramm werden immer angezeigt. Hinweis: Das Kantenverlaufsdiagramm ist ein andockbares Fenster. Weitere Informationen hierzu finden Sie im Thema Tabelleneditor – Diagramme.

## FindLine – Ausgaben

Rückgabewert | Eine Kante-Datenstruktur, die ein einzelnes gerades Kantensegment enthält, oder #ERR, wenn einer der Eingabeparameter ungültig ist.
Ergebnisse | Wenn FindLine in eine Zelle eingefügt wird, wird in der Tabelle eine Ergebnistabelle erstellt. Die folgenden Vision Data Access functions werden automatisch in die Tabelle eingefügt, um die Ergebnistabelle zu erstellen:
Label | Funktion | Beschreibung
--- | --- | ---
X0 | GetX(Kanten,0,0) | Die x-Koordinate des ersten Punkts.
Y0 | GetY(Kanten,0,0) | Die y-Koordinate des ersten Punkts.
X1 | GetX(Kanten,0,1) | Die x-Koordinate des zweiten Punkts.
Y1 | GetY(Kanten,0,1) | Die y-Koordinate des zweiten Punkts.
Güte | GetScore(Kanten, 0) | Die Kontrastgüte der Kante. Kontrast ist positiv bei Schwarz-nach-Weiß-Übergängen und negativ bei Weiß-nach-Schwarz-Übergängen.