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

Dieser Parameter muss auf eine Tabellenzelle verweisen, die eine Bild-Datenstruktur enthält. Standardmäßig verweist dieser Parameter auf A0, die Zelle mit der Datenstruktur. Dieser Parameter kann auch andere Image-Datenstrukturen referenzieren, z. B. solche, die von den Image Datenzugriffsfunktionen oder Koordinatenumrechnungsfunktionen zurückgegeben werden.

Vorrichtung

Definiert den Inspektionsbereich (ROI) relativ zu einer Vorrichtung als Eingabe oder die Ausgabe des Bildkoordinatensystems einer Vision Tools-Funktion. Wenn man den ROI relativ zu einer Vorrichtung bestimmt, stellt man sicher, dass beim Verdrehen oder Umsetzen der Vorrichtung auch der Inspektionsbereich im Verhältnis zur Vorrichtung verdreht 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 im Vorrichtungskoordinatensystem.

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

Die Eingabebildregion und die gerade Kante werden immer angezeigt.

3 = Alles anzeigen: Eingabe, Ergebnis und Diagramm

Die Eingabebildregion, 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 Edges Datenzugriffsfunktionen 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.