![]() |
![]() |
|---|---|
USB 2.0 USB 3.x GigE |
USB 2.0 USB 3.x GigE |
Syntax
INT is_SetTimeout (HIDS hCam, UINT nMode, UINT Timeout)
Beschreibung
Mit is_SetTimeout() können benutzerdefinierte Timeout-Werte der uEye-API geändert werden. Wenn kein benutzerdefinierter Timeout gesetzt ist, wird der Standardwert der uEye-API für den jeweiligen Timeout verwendet.
Für weitere Informationen siehe auch Kapitel Vorgehensweise: Timeout-Werte für die Bildaufnahme.
|
Der benutzerdefinierte Timeout gilt nur für die bezeichnete Kamera und die Laufzeit des Programms. |
Timeout für Hardware-Trigger
Wenn Sie einen benutzerdefinierten Wert für den Timeout setzen, wird folgende Formel für die Berechnung des Timeouts empfohlen:
Timeout = (max. Zeit zwischen den Triggersignalen + max. Belichtungszeit + Bilddauer + Trigger-Verzögerung) * Faktor
•Max. Zeit zwischen den Triggersignalen: der maximale Abstand zwischen zwei Hardware-Triggersignalen in der Applikation
•Max. Belichtungszeit: die maximale Belichtungszeit in der Applikation
•Bilddauer: 1/Bildrate
•Trigger-Verzögerung: Triggerverzögerung, die über is_SetTriggerDelay() eingestellt wird.
•Faktor: Der Faktor sollte einen Wert zwischen 1,5 und 2 haben. Bei einem zu großen Wert wird die Applikation zu lange blockiert und bei einem zu kleinen Wert können Bilder verloren gehen.
Übergabeparameter
hCam |
Handle auf Kamera |
nMode |
Wählt aus, welcher Timeout-Wert gesetzt werden soll |
IS_TRIGGER_TIMEOUT |
Setzt den Timeout-Wert für die getriggerte Bildaufnahme |
Timeout |
Timeout-Wert in 10 ms. Wertebereich [0; 4...429496729] (entspricht 40 ms bis ca. 1193 Stunden) 0 = Standardwert der uEye API verwenden Für 1...3 wird der Wert 4 verwendet. |
Rückgabewert
IS_CANT_COMMUNICATE_WITH_DRIVER |
Kommunikation mit dem Kameratreiber schlug fehl, weil kein Treiber geladen ist. |
IS_CANT_OPEN_DEVICE |
Ein Versuch die Kamera zu öffnen schlug fehl (Kamera nicht vorhanden oder Fehler beim Initialisieren). |
IS_INVALID_CAMERA_HANDLE |
Ungültiges Kamera-Handle |
IS_IO_REQUEST_FAILED |
Eine IO Anforderung des uEye Treibers schlug fehl. Eventuell passen die Versionen der Dateien ueye_api.dll (API) und ueye_usb.sys bzw. ueye_eth.sys (Treiber) nicht zusammen. |
IS_NO_SUCCESS |
Allgemeine Fehlermeldung |
IS_NOT_SUPPORTED |
Das verwendete Kameramodell unterstützt diese Funktion oder Einstellung nicht. |
IS_SUCCESS |
Funktion erfolgreich |
Verwandte Funktionen
Beispiel
// Benutzerdefinierten Timeout auf 120 Sekunden setzen
is_SetTimeout(hCam, IS_TRIGGER_TIMEOUT, 12000);