# AcquireImage

Die Funktion „AcquireImage“ definiert die Parameter für die Aufnahme eines digitalen Bilds und seine Übertragung in den Verarbeitungsspeicher von In-Sight Vision-System.

Die In-Sight Vision-Systeme nehmen alle Bilder mithilfe eines asynchronen Zurücksetzvorgangs und eines progressiven Scanvorgangs auf. Die Graustufen-Vision-Systeme erzeugen 8-Bit-Bilder, während die Farb-Vision-Systeme (gekennzeichnet mit einem C-Suffix) 24-Bit-Bilder erzeugen. Der Bildaufnahmevorgang beginnt bei allen Vision-Systemen innerhalb von ca. 250 Mikrosekunden (µs). Der Vorgang läuft folgendermaßen ab:

- Der Bildsensor integriert Licht während der durch den Parameter Belichtung definierten Zeit.
- Das im Bildsensor erfasste Bild wird Zeile für Zeile in ein serielles Register übertragen.

- Bei jeder Zeilenübertragung taktet die Kamera das Register Pixel für Pixel aus dem Bildsensor über den folgenden Pfad:

  Videoverstärker -> Gain und Offset -> Analog-Digital-Wandler -> Bildverarbeitungsspeicher

Der Speicherpuffer mit dem aufgenommenen Bild wird in der Tabelle als eine Image-Datenstruktur dargestellt. Die von der Funktion AcquireImage zurückgegebene Image-Datenstruktur wird wiederum von anderen In-Sight-Tabellenfunktionen, die Bildregionen verarbeiten, referenziert. Jede direkt oder indirekt von aufgenommenen Bilddaten abhängige Funktion wird bei jeder Bildaufnahme automatisch aktualisiert. Diese Beziehung zwischen dem Eingabebild und anderen Funktionen in der Tabelle steuert die Ausführung von Bildverarbeitungsaufgaben in In-Sight Vision-Systemen. Weitere Informationen zu Abhängigkeiten und zur Zellenausführungsreihenfolge finden Sie unter Tabellenzellen-Ausführung.

Bei der erstmaligen Erstellung einer Tabelle wird die Funktion AcquireImage automatisch hinzugefügt und befindet sich in Zelle A0. Die meisten Vision Tool-Funktionen und viele andere Funktionen nutzen dies, indem sie eine absolute Referenz auf die Zelle A0 als Standardbildquelle verwenden. Weitere Informationen finden Sie unter Zellreferenzen.

Vorsicht: Sie können die Funktion „AcquireImage“ aus der Tabelle löschen. Sie sollten dies jedoch NICHT tun, da dies die Bildaufnahme verhindert. Wenn Sie die Funktion AcquireImage in Zelle A0 versehentlich löschen, machen Sie das Löschen über das Menü Bearbeiten > Rückgängig rückgängig, oder drücken Sie STRG+Z, oder fügen Sie die Funktion durch Eingabe des Zellausdrucks „AcquireImage()“ wieder hinzu.

Wenn Sie die Parameter für „AcquireImage“ ändern möchten, klicken Sie auf den Bildaufnahmebereich neben der Tabelle. Weitere Informationen finden Sie unter Bereich „Aufnahme“.

Hinweis:

- Da die Funktion keine Argumente enthält, bleiben die konfigurierten Aufnahmeeinstellungen beim Export der Zellen als Zellenvorlage nicht erhalten. Fügen Sie zum Exportieren der Aufnahmeeinstellungen „ApplyAcquisitionSettings“ zur Tabelle hinzu, aktivieren Sie die Parameter, die Sie beibehalten möchten, legen Sie die Einstellungen auf die gewünschten Werte fest und exportieren Sie anschließend „ApplyAcquisitionSettings“ als Zellenvorlage. Wenn die Zellenvorlage importiert wird, die ApplyAcquisitionSettings enthält, werden die Aufnahmeeinstellungen auf die Funktion angewendet, sobald die Zelle „ApplyAcquisitionSettings“ ausgeführt wird.
- Funktionen, die einen Bildparameter erfordern, müssen auf eine Tabellenzelle verweisen, die eine gültige Image-Datenstruktur enthält. Zelle A0 ist in allen Eigenschaftsblättern die standardmäßige Referenz des Bildparameters; sie enthält die von AcquireImage zurückgegebene Image-Datenstruktur. Image-Datenstrukturen, die über die Bild-Funktionen zurückgegeben werden, sind jedoch auch gültige Referenzen auf Bildparameterwerte in Eigenschaftsblättern.

## ApplyAcquisitionSettings

Wenn Sie einen Parameter per Drag & Drop aus dem Aufnahmebereich in die Tabelle ziehen, wird die Funktion ApplyAcquisitionSettings zu der Tabelle hinzugefügt, mit der Sie Aufnahmeparameter bearbeiten können, ohne die -Funktion zu öffnen. Außerdem wird der Wert der Aufnahmeparameter zur Laufzeit geändert. Im Aufnahmebereich zeigt der per Drag & Drop bewegte Parameter ein blaues Ausrufezeichen an. Dieses Symbol gibt an, dass die ApplyAcquisitionSettings-Funktion den Parameter überschreibt. Wenn Sie den Mauszeiger über das Symbol bewegen, wird die Zellenposition der ApplyAcquisitionSettings-Funktion als Hinweis angezeigt.

Hinweis:

- Das Eigenschaftsblatt für „AcquireImage“ zeigt auch ein blaues Ausrufezeichen an, wenn ein verknüpfter Parameter per Drag & Drop aus dem Eigenschaftsblatt für „ApplyAcquisitionSettings“ gezogen wird. Weitere Informationen finden Sie unter ApplyAcquisitionSettings.
- Wenn ein Parameter von mehreren ApplyAcquisitionSettings-Funktionen referenziert wird, gibt das Symbol die Zellpositionen der ApplyAcquisitionSettings-Funktion an (bis zu fünf Positionen).

- Wenn Sie einen Parameter im Eigenschaftsblatt „ApplyAcquisitionSettings“ deaktivieren, wird das blaue Ausrufezeichen des verknüpften Parameters nicht mehr im Eigenschaftsblatt für AcquireImage angezeigt.