# ExtractCalibrationPoints

Die ExtractCalibrationPoints-Funktion extrahiert Kalibrierungspunkte aus einem Bild eines schachbrettförmigen Kalibrierungsrastermusters. Die Kalibrierungspunkte können von anderen Kalibrierungswerkzeugen verwendet werden.

## ExtractCalibrationPoints – Übersicht

Ein Kalibrierungsbild, ein Schachbrettraster mit Bildkoordinaten und einer bekannter Skala, wird verwendet, um die ExtractCalibrationPoints-Funktion zu trainieren. Während der Analyse findet es die Pixelpositionen der Schnittpunkte der Rasterzellen und bildet sie dann auf ein Modell des Rastermusters ab. Die Funktion gibt eine CalibPoints-Datenstruktur zusammen mit der Anzahl der innerhalb des Rasters gefundenen Punkte zurück. Der Satz von Kalibrierungspunkten kann später von anderen Kalibrierungswerkzeugen verwendet werden, wie z. B. CalibratePoints, um Verzerrungen zu korrigieren oder um Bildkoordinaten reellen Koordinaten oder umgekehrt zuzuordnen.

Hinweis: Verwenden Sie ein schachbrettförmiges Kalibrierungsraster mit Bildkoordinaten-Markierungen. Die Kalibrierung mit einem Punktraster oder einem Raster ohne Bildkoordinaten wird gegenwärtig nicht unterstützt.

## ExtractCalibrationPoints – Eingaben

Parameter | Beschreibung
--- | ---
Bild | Dieses Argument muss eine Tabellenzelle mit einer gültigen Bild-Datenstruktur referenzieren. Standardmäßig wird die Zelle $A$0 referenziert, die die von zurückgegebene Image-Datenstruktur enthält.
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.
X | Der x-Offset in Bildkoordinaten.
Y | Der y-Offset in Bildkoordinaten.
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.
Ereignis extrahieren | Drücken Sie auf diese Schaltfläche, um Kalibrierungspunkte aus dem Bild zu extrahieren.
Rasterabstandseinheiten | Gibt die Maßeinheit an, die für den Abstand des Kalibrierungsrastermusters verwendet wird.
Mikron = 0 | „µm“
Millimeter = 1 (Standard) | „mm“
Zentimeter = 2 | „cm“
Zoll = 3 | „in“
Abstand x-Raster | Das Ist-Maß des Abstands des Kalibrierungsrastermusters entlang der x-Achse.
Abstand y-Raster | Das Ist-Maß des Abstands des Kalibrierungsrastermusters entlang der x-Achse.
Winkelbereich | Wählen Sie diese Option aus, um den Parameter Suchtoleranzen zu aktivieren und den Winkelbereich, der für die Suche nach dem Raster verwendet wird, zu beschränken. (Standard = 0; deaktiviert) Tipp: Die Beschränkung des Winkelbereichs kann die Punktextraktion beschleunigen, wenn die relative Ausrichtung zwischen Raster und Kamera bekannt ist.
Toleranz suchen | Der Start- und Stoppwinkelbereich, der für die Suche nach dem Raster verwendet wird.
Winkelanfang | Minimal möglicher Winkel zwischen der horizontalen Achse des Rasters und der horizontalen Achse der Kamera. (Min = -180, Max = 180, Standard = -180)
Winkelende | Maximal möglicher Winkel zwischen der horizontalen Achse des Rasters und der horizontalen Achse der Kamera. (Min = -180, Max = 180, Standard = +180)
Hinweis: Standardmäßig ist der Winkelbereich nicht eingeschränkt. Das Kontrollkästchen Winkelbereich muss aktiviert sein, um die Beschränkung des Start- und Endbereichs der Winkel zu aktivieren, die mit dem Parameter „Toleranzen finden“ definiert sind.
Zeitlimit | Gibt die Zeitdauer (Millisekunden) zur Ausführung der ExtractCalibrationPoints-Funktion an. Die Ausführung der Funktion wird angehalten, wenn das Zeitlimit überschritten wurde. (Minimal = 0, Maximum = 9999999, Standard = 120000) Hinweis: Das Zeitlimit wird als abgesicherter Modus verwendet, damit Prozessen mit einer potenziell sehr langen Ausführungsdauer beim Überschreiten des Zeitlimits beendet werden. Das Zeitlimit ist nicht genau. Die Ausführung kann das angegebene Zeitlimit um einige Sekunden überschreiten.
Anzeigen | Legt den Anzeigemodus für die Überlagerung von ExtractCalibrationPoints-Grafiken auf dem Bild fest.
0 = Alle ausblenden (Standard) | Alle Grafiken werden nur angezeigt, wenn die Zelle mit der ExtractCalibrationPoints-Funktion in der Tabelle markiert ist.
1 = Nur Ergebnis-Grafik | Zeigt die Positionen der extrahierten Punkte an, die das Eingabebild überlagern.
2 = Eingabe- und Ergebnis-Grafik | Zeigt die Positionen der extrahierten Punkt und den Suchbereich an.

## ExtractCalibrationPoints – Ausgaben

Rückgabewert | Eine CalibPoint-Datenstruktur oder #ERR, wenn mindestens ein Eingabeparameter ungültig ist. Die folgenden Calibrate Vision Data Access functions werden automatisch in die Tabelle eingefügt, um die Ergebnistabelle zu erstellen:
Beschriftung | Funktion | Beschreibung
Punkte | GetNFound() | Gibt die Anzahl der im Kalibrierungsrasterbild gefundenen Punkte zurück.