is_SetTimeout

uEye Kamera-Handbuch Version 4.92


is_SetTimeout

Windows_Logo
Linux_Logo

USB 2.0

USB 3.0

GigE

USB 2.0

USB 3.0

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.

hint_info

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

•is_GetTimeout()

•is_CaptureVideo()

•is_FreezeVideo()

•is_SetExternalTrigger()

Beispiel

// Benutzerdefinierten Timeout auf 120 Sekunden setzen
is_SetTimeout(hCam, IS_TRIGGER_TIMEOUT, 12000);

Haben Sie Verbesserungshinweise? Senden Sie ein kurzes Feedback zu diesem Kapitel. Vielen Dank!
Bei technischen Fragen wenden Sie sich bitte an Ihren lokalen Händler oder nutzen Sie das Support-Formular auf unserer Internetseite.


© 2019 IDS Imaging Development Systems GmbH
https://de.ids-imaging.com