# CalibrateImage

Verbindet eine Kalibrierung mit einem Bild. CalibrateImage verbindet eine Calib-Datenstruktur mit einer Bild-Datenstruktur, um eine neue Image-Datenstruktur zu erstellen. Die resultierende Datenstruktur kann durch andere Vision-Tool-Funktionen referenziert werden, um ihre Ergebnisse in den durch die referenzierte Kalibrierung definierten Weltkoordinaten anzuzeigen.

Nehmen wir als Beispiel einen Sensor, der mit einer Calibrate kalibriert wurde. Als Nächstes wird die Funktion „CalibrateImage“ eingefügt, bei der der Parameter „Kalibrierung“ als Zellreferenzen auf die gerade erstellte Kalibrierungsstruktur der Calibrate-Funktion gesetzt ist. Dann setzt ein anderes Vision-Tool, wie zum Beispiel DetectBlobs, seinen Parameter „Bild“ als Zellreferenz auf die CalibrateImage-Datenstruktur, wodurch die DetectBlobs-Koordinaten aus den Weltkoordinaten des kalibrierten Bilds resultieren.

Hinweis: Die Ausgabe jedes Vision-Tools, das in realen Weltkoordinaten berichtet, kann nicht als Vorrichtung oder Bereich für eine Eingabe in ein anderes Vision-Tool verwendet werden.

## CalibrateImage – Eingaben

Parameter | Beschreibung
Bild | Dieses Argument muss eine Tabellenzelle mit einer gültigen Bild-Datenstruktur referenzieren. This parameter must reference a spreadsheet cell that contains an Bild data structure; by default, this parameter references A0, the cell containing the Image data structure returned by function. This parameter can also reference other Bild data structures, such as those returned by the Vision Tool Bildfunktionen or Koordinatenumrechnungsfunktionen.
Kalibrierung | Dieses Argument muss eine Tabellenzelle mit einer gültigen Calib-Datenstruktur referenzieren.

## CalibrateImage – Ausgaben

Rückgabewert | Eine Image-Datenstruktur mit dem verarbeiteten Bild oder #ERR, wenn ein oder mehrere Eingabeparameter ungültig sind.