# ApplyAcquisitionSettings

Sie können die Funktion ApplyAcquisitionSettings zur Tabelle hinzufügen, indem Sie einen Parameter im Eigenschaftsblatt AcquireImage auswählen und diesen Parameter per Drag & Drop in die Tabelle ziehen. Die Funktion ApplyAcquisitionSettings agiert als Setter für die Aufnahmeparameter, die in der AcquireImage-Funktion angezeigt werden. Diese Funktion ist nützlich, wenn Sie die Aufnahmeeinstellungen aus der Tabelle zur Laufzeit schnell und einfach ändern möchten oder wenn Sie eine Einstellung basierend auf der externen Kommunikation (FFP) oder der Ausgabe eines Vision Tools aktualisieren möchten, ohne das Eigenschaftsblatt für AcquireImage zu öffnen.

Die Funktion ApplyAcquisitionSettings unterstützt die folgenden Parameter:

- Triggertyp, Entprellung (ms), Verzögerung (ms), Belichtung (ms), Offset, Gain, Ausrichtung, Startzeile, Anzahl von Zeilen
- Beleuchtung: Modus, Intensität, Gruppen aktiviert, Immer ein
- High Dynamic Range: HDR-Modus, Kernelgröße für HDR+

Hinweis:

- Andere Parameter (z. B. Triggermodus) können nicht per Drag & Drop aus dem AcquireImage-Eigenschaftsblatt in die Tabelle gezogen werden.

- Parameter, die das angeschlossene Gerät nicht unterstützt, sind abgeblendet und können nicht per Drag & Drop bewegt werden.
- 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. Weitere Informationen zu den Tabellenzellenvorlagen finden Sie unter Exportieren und Importieren von Zellen aus bzw. in Vorlagen.

## Verwendung von ApplyAcquisitionSettings

1. Öffnen Sie das AcquireImage-Eigenschaftsblatt in Zelle A0.
2. Bewegen Sie einen Parameter per Drag & Drop aus dem AcquireImage-Eigenschaftsblatt in die Tabelle.

3. Die Funktion ApplyAcquisitionSettings wird zur Tabelle hinzugefügt und gibt eine AcquisitionSettings-Datenstruktur, die Beschriftung des Parameters und ein Eingabefeld zurück. Wenn Sie beispielsweise den Parameter „Entprellung (ms)“ per Drag & Drop in die Tabelle ziehen, werden die AcquisitionSettings-Datenstruktur, die Beschriftung „Entprellung (ms)“ und ein Eingabefeld in der Tabelle ausgefüllt.

4. Klicken Sie zum Schließen des AcquireImage-Eigenschaftsblatts auf OK.

5. Wenn Sie der Tabelle einen weiteren Aufnahmeparameter hinzufügen möchten, öffnen Sie das ApplyAcquisitionSettings-Eigenschaftsblatt.

   Hinweis: Es empfiehlt sich, einen Parameter per Drag & Drop aus dem ApplyAcquisitionSettings-Eigenschaftsblatt zu ziehen, nachdem die erste ApplyAcquisitionSettings-Funktion erstellt wurde. Wenn Sie mehrere Parameter per Drag & Drop aus AcquireImage ziehen, erstellen Sie mehrere ApplyAcquisitionSettings-Funktionen, und es ist nicht eindeutig, welche Parameter jeweils eingestellt werden.

6. Aktivieren Sie das Kontrollkästchen für den gewünschten Parameter. Wenn Sie beispielsweise den Parameter „Verzögerung (ms)“ zur Tabelle hinzufügen möchten, aktivieren Sie das Parameterkontrollkästchen „Verzögerung“ (ms).

7. Ziehen Sie den Parameter per Drag & Drop in die Tabelle.

8. Die Beschriftung des Parameters und ein Eingabefeld werden in der Tabelle ausgefüllt. Wenn Sie beispielsweise den Parameter „Verzögerung (ms)“ per Drag & Drop in die Tabelle ziehen, wird die Beschriftung „Verzögerung (ms)“ und ein Eingabefeld in der Tabelle ausgefüllt.

9. Wiederholen Sie Schritte 5 bis 8, bis alle gewünschten Parameter hinzugefügt wurden.
10. Ändern Sie die Werte in den Eingabefeldern nach Bedarf.

11. Die neuen Werte werden bei der nächsten Bildaufnahme angewendet.

    Hinweis: Wenn Sie den Kameratriggermodus verwenden, werden die neuen Werte nach dem nächsten Gerätetrigger angewendet.

Hinweis:

- Wenn Sie mehr als eine ApplyAcquisitionSettings-Funktion in der Tabelle haben, wird nur der zuletzt aktualisierte Wert bei der Bildaufnahme verwendet.
- Die Beschriftung und das Eingabefeld des Parameters werden nur ausgefüllt, wenn Sie den Parameter per Drag & Drop aus dem AcquireImage- oder dem ApplyAcquisitionSettings-Eigenschaftsblatt in die Tabelle bewegen. Wenn Sie die FunktionApplyAcquisitionSettings mithilfe anderer Methoden (z. B. durch die Eingabe von ApplyAcquisitionSettings in eine Zelle) einfügen, wird nur die AcquisitionSettings-Datenstruktur ausgefüllt.
- Wenn Sie die Markierung für einen Parameter im ApplyAcquisitionSettings-Eigenschaftsblatt aufheben, dann überschreibt das zugeordnete Eingabefeld in der Tabelle nicht mehr den Wert in der AcquireImage-Funktion.

## ApplyAcquisitionSettings – Ausgaben

Wenn ein unterstützter Parameter per Drag & Drop aus dem AcquireImage-Eigenschaftsblatt in die Tabelle bewegt wird, wird Folgendes zurückgegeben:

Rückgabewert | AcquisitionSettings-Datenstruktur Beschriftung für den Parameter Eingabefeld für den Parameter