Beim Aufruf von is_FreezeVideo() oder is_CaptureVideo() wird über den Parameter Wait der Timeout-Wert für die Bildaufnahme bestimmt. Trifft innerhalb dieser Wartezeit kein Bild ein, wird eine Timeout-Fehlermeldung ausgegeben. Unter Windows wird bei eingeschaltetem Error-Report ein Dialogfenster angezeigt (siehe is_SetErrorReport()). Informationen zur Fehlerursache können mit is_CaptureStatus() abgefragt werden.
Die nachfolgende Tabelle zeigt, wie sich der Parameter Wait abhängig vom Bildaufnahmemodus auswirkt:
Parameter Wait |
Aufnahmemodus |
Funktion kehrt zurück |
Timeout 1. Bild |
Timeout weitere Bilder*1 |
|---|---|---|---|---|
IS_DONT_WAIT |
Hardware-Trigger |
Nach Befehlsausführung*4 |
API-Standardwert oder benutzerdefiniert*3 |
API-Standardwert oder benutzerdefiniert*3 |
IS_WAIT |
Hardware-Trigger |
Wenn 1. Bild im Speicher |
API-Standardwert oder benutzerdefiniert*3 |
API-Standardwert oder benutzerdefiniert*3 |
Zeit t Wertebereich [4...429496729] |
Hardware-Trigger |
Wenn 1. Bild im Speicher |
Zeit t in 10 ms-Schritten (40 ms bis ca. 1193 Stunden) |
API-Standardwert oder benutzerdefiniert*3 |
IS_DONT_WAIT |
Freilaufend/Software-Trigger |
Nach Befehlsausführung*4 |
API-intern berechnet*2 |
API-intern berechnet*2 |
IS_WAIT |
Freilaufend/Software-Trigger |
Wenn 1. Bild im Speicher |
API-intern berechnet*2 |
API-intern berechnet*2 |
Zeit t Wertebereich [4...429496729] |
Freilaufend/Software-Trigger |
Wenn 1. Bild im Speicher |
Zeit t in 10 ms-Schritten (40 ms bis ca. 1193 Stunden) |
API-intern berechnet*2 |
*1 Nur bei fortlaufender Aufnahme mit is_CaptureVideo()
*2 Die Wartezeit wird aus der eingestellten Belichtungszeit, der Bildübertragungszeit (abhängig vom Pixeltakt) und dem optionalen Trigger-Delay (siehe is_SetTriggerDelay()) berechnet und beträgt mindestens 40 ms.
*3 Der Standardwert der uEye API beträgt 60 s. Benutzerdefinierte Werte können mit der Funktion is_SetTimeout() gesetzt werden.
*4 Im Fehlerfall kann es einige Zeit dauern bis die Funktion zurückkehrt, z. B. wenn die Kamera nicht verfügbar ist.
|
Da die Funktion in Verbindung mit IS_DONT_WAIT unmittelbar zurückkehrt, muss über das API-Event IS_SET_EVENT_FRAME abgefragt werden, ob das Bild im Speicher verfügbar ist. |
