Flecken finden

Mit diesem Tool finden Sie Flecken auf Oberflächen. Für dieses Tool ist easyTouch verfügbar.

Parameter

Standardparameter

Bild:

Dieser Parameter stellt das Bild dar, in dem Flecken gefunden werden sollen.

Bei der Verwendung eines Farbbilds als Eingabebild für dieses Tool wird nur der erste Kanal, d. h. der rote Kanal, für die Verarbeitung verwendet.

Fleckendurchmesser:

Dieser Parameter legt den Durchmesser der zu ermittelnden Flecken fest. Er wird in Pixeln angegeben und ist standardmäßig auf 10 px festgelegt. Wenn ein Fleck zur Fehlererkennung ausgewählt wurde, wird dessen „Fleckendurchmesser“ sofort bestimmt und automatisch übernommen. Sie können den Wert jedoch auch manuell über die entsprechende Verbindungsstelle ändern.

Fleckenkontrast:

Der „Fleckenkontrast“ definiert den Kontrast in Grauwerten der Flecken in Bezug auf den Hintergrund. Der Parameter ist standardmäßig auf den Wert 10 festgelegt. Wenn ein Fleck zur Fehlererkennung ausgewählt wurde, wird dessen „Fleckenkontrast“ sofort bestimmt und automatisch übernommen. Sie können den Wert jedoch auch manuell über die entsprechende Verbindungsstelle ändern.

Fleckeneigenschaft:

Dieser Parameter definiert die Eigenschaft, ob die Flecken im Hinblick auf den Hintergrund hell oder dunkel erscheinen. Die Standardeinstellung ist „hell“. Sie können den Wert über die zugehörige Verbindungsstelle ggf. ändern.

Wert	Beschreibung
hell	Verwenden Sie diesen Wert, wenn die zu ermittelnden Flecken auf einem dunklen Hintergrund hell erscheinen. Wenn dieser Wert eingestellt ist, werden alle hellen Flecken gefunden.
dunkel	Verwenden Sie diesen Wert, wenn die zu ermittelnden Flecken auf einem hellen Hintergrund dunkel erscheinen. Wenn dieser Wert eingestellt ist, werden alle dunklen Flecken gefunden.

Zusätzliche Parameter

ROI:

Dieser Parameter definiert die ROI für die Verarbeitung. Bildteile außerhalb der Vereinigung von ROI und „Verarbeitungsbereich“ werden nicht verarbeitet. Wenn zudem einer der Bereiche leer ist, wird der Bildteil, der innerhalb des jeweils anderen liegt, verarbeitet. Sind beide leer, wird das gesamte Bild verarbeitet.

Die ROI ist standardmäßig als leere ROI definiert. Wenn Sie eine nicht leere ROI für die Verarbeitung verwenden möchten, müssen Sie den Parameter mit einem geeigneten ROI-Ergebnis eines vorherigen Tools verbinden oder mit den verfügbaren ROI-Schaltflächen neue ROIs zeichnen.

Ausrichtungsdaten:

Dieser Parameter stellt die Ausrichtungsdaten dar, die zum Ausrichten der ROI verwendet werden. Ausrichtungsdaten sind standardmäßig nicht verbunden, sodass keine Auswirkung sichtbar ist. Wenn Sie bestimmte Ausrichtungsdaten verwenden möchten, müssen Sie den Parameter mit einem geeigneten Ergebnis eines vorherigen Tools verbinden, z. B. Ausrichtungsdaten mit Matching bestimmen, Ausrichtungsdaten mittels geradem Rand bestimmen, Bild ausrichten oder Bild drehen.

Minimale Fläche:

Dieser Parameter legt die „Minimale Fläche“ der zu ermittelnden Flecken fest. Er wird in Pixeln angegeben und ist standardmäßig auf 2 px festgelegt. Alle Flecken mit einer Fläche, die kleiner als die festgelegte „Minimale Fläche“ ist, werden nicht gefunden. Wenn ein Fleck zur Fehlererkennung ausgewählt wurde, wird dessen „Minimale Fläche“ sofort bestimmt und automatisch übernommen. Sie können den Wert jedoch auch manuell über die entsprechende Verbindungsstelle ändern.

Maximale Fläche:

Dieser Parameter legt die „Maximale Fläche“ der zu ermittelnden Flecken fest. Er wird in Pixeln angegeben und ist standardmäßig auf 1000 px festgelegt. Alle Flecken mit einer Fläche, die größer als die festgelegte „Maximale Fläche“ ist, werden nicht gefunden. Wenn ein Fleck zur Fehlerzählung ausgewählt wurde, wird dessen „Maximale Fläche“ sofort bestimmt und automatisch übernommen. Sie können den Wert jedoch auch manuell über die entsprechende Verbindungsstelle ändern.

Verarbeitungsbereich:

Dieser Parameter definiert die Region für die Verarbeitung. Bildteile außerhalb der Vereinigung von ROI und „Verarbeitungsbereich“ werden nicht verarbeitet. Wenn zudem einer der Bereiche leer ist, wird der Bildteil, der innerhalb des jeweils anderen liegt, verarbeitet. Sind beide leer, wird das gesamte Bild verarbeitet.

„Verarbeitungsbereich“ ist standardmäßig als leere Region definiert. Wenn Sie eine „Verarbeitungsbereich“ angeben möchten, müssen Sie den Parameter mit einem geeigneten Ergebnis eines vorherigen Tools verbinden, damit die Region an dieses Tool übertragen wird.

Ergebnisse

Standardergebnisse

Flecken:

Dieses Ergebnis beschreibt die Region der gefundenen Flecken.

Anzahl:

Dieses Ergebnis beschreibt die „Anzahl“ der Flecken, die mit den festgelegten Parametern gefunden wurden. Die Ausgabe erfolgt als Ganzzahl.

Toolstatus:

„Toolstatus“ gibt Informationen zum Status des Tools aus und kann daher für die Fehlerbehandlung verwendet werden. Weitere Informationen zu den verschiedenen Toolstatus-Ergebnissen finden Sie unter Toolstatus-Ergebnis.

Zusätzliche Ergebnisse

Verarbeitungszeit:

Dieses Ergebnis gibt die Dauer der letzten Ausführung des Tools in Millisekunden aus. Das Ergebnis wird als zusätzliches Ergebnis bereitgestellt. Es ist daher standardmäßig ausgeblendet, kann aber über die Schaltfläche neben den Toolergebnissen angezeigt werden. Weitere Informationen finden Sie im Abschnitt Verarbeitungszeit in der Tool-Referenz-Übersicht.

Anwendungsbeispiele

Dieses Tool wird in den folgenden MERLIC-Vision-App-Beispielen verwendet:

• count_defect_clusters.mvapp