# LatchImage

Speichert ein Bild beim Auftreten des angegebenen Ereignisses.

## LatchImage – Eingaben

Parameter | Beschreibung
Bild | Dieses Argument muss eine Tabellenzelle mit einer gültigen Bild-Datenstruktur referenzieren. Standardmäßig wird die Zelle A0 referenziert. Sie enthält die von zurückgegebene Image-Datenstruktur.
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 | Gibt den x-Offset in Bildkoordinaten an.
Y | Gibt den y-Offset in Bildkoordinaten an.
Winkel | Dies ist die Ausrichtung im Bildkoordinatensystem.
Bereich | Auch als Inspektionsbereich oder ROI bezeichnet. Gibt den Bereich des Bilds an, der einer Bildverarbeitung unterzogen wird. Erstellt einen Bildbereich, der transformiert und gedreht werden kann. Bei Auswahl dieses Parameters wird nach Klicken auf die Schaltfläche der Bereich automatisch so gedehnt, 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 | Dies ist die Ausrichtung im Bildkoordinatensystem.
Hinweis: Die Parameter Vorrichtung und Bereich müssen innerhalb der Bildgrenzen festgelegt werden. Andernfalls gibt die Funktion #ERR zurück.
Ereignis | Definiert das Aktualisierungsereignis, bei dem das Bild gespeichert werden soll. Dieser Parameter muss auf eines der folgenden verweisen: die Image-Datenstruktur in Zelle A0 (mit der Funktion ). Eine Zelle, die eine Button-Funktion enthält.
Einfärben | Ist nur für Farbbilder relevant. Wenn aktiviert, wird das gespeicherte Bild in Graustufen konvertiert (andernfalls bleibt es in Farbe).
0 = Deaktiviert (Standard)
1 = Aktiviert
Anzeigen | Legt fest, welche Grafiküberlagerungen über dem Bild angezeigt werden sollen.
0 = Alle ausblenden (Standard) | Die verfügbaren Grafikelemente werden nur dann angezeigt, wenn die Zelle mit der Funktion die aktive Zelle in der Tabelle ist. Hinweis: Bei Änderung des Eingabebereichs wird ein zweiter Bereich angezeigt, der den Speicherort beim nächsten angegebenen Ereignis angibt.
1 = Nur Ergebnis-Grafik | Das bearbeitete Bild wird immer angezeigt.
2 = Nur Eingabegrafik | Die mit dem Eingabebildbereich verknüpften Grafikelemente werden immer angezeigt.

## LatchImage – Ausgaben

Rückgabewert | Eine LatchImage-Datenstruktur mit dem beim letzten Ereignis gespeicherten Bild.