uEye Kamera-Handbuch Version 4.92
 |
 |
USB 2.0 USB 3.0 GigE |
USB 2.0 USB 3.0 GigE |
Syntax
INT is_Exposure (HIDS hCam, UINT nCommand, void* pParam, UINT cbSizeOfParam)
Beschreibung
Mit is_Exposure() können Sie erlaubte Wertebereiche für die Belichtungszeit der Kamera abfragen und neue Belichtungszeiten setzen:
•Belichtungszeit in feiner Schrittweite
 |
Hinweis zur Abhängigkeit von anderen Einstellungen Die Belichtungszeit wird von folgenden Funktionen beeinflusst: •is_AOI() (wenn die Bildgröße geändert wird) Durch Ändern der Bildgröße, der Bildrate oder des Pixeltakts wird die Belichtungszeit verändert, deshalb muss is_Exposure() danach neu aufgerufen werden. |
 |
Hinweis zu neuen Treiberversionen Neuere Treiberversionen ermöglichen teilweise erweiterte Wertebereiche für die Belichtungszeit. Es wird daher empfohlen, diese Bereiche jedes Mal abzufragen und Werte explizit zu setzen. |
Über den Übergabeparameter nCommand wird dabei der Funktionsmodus gewählt. Der Übergabeparameter pParam ist abhängig vom Funktionsmodus unterschiedlich belegt; bei Funktionen zum Setzen oder Rücklesen eines Wertes enthält pParam einen Zeiger auf eine Variable vom Typ UINT. Die Größe des Speicherbereichs, auf den pParam verweist, wird im Übergabeparameter cbSizeOfParam angegeben.
Übergabeparameter
hCam |
Handle auf Kamera |
||
|
|||
pParam |
Zeiger auf Funktionsparameter, der abhängig von nCommand unterschiedlich belegt ist. |
||
cbSizeOfParam |
Größe des Speicherbereichs in Byte, auf den pParam verweist. |
||
Inhalt der Struktur EXPOSURE_CAPS
INT |
IS_EXPOSURE_CAP_EXPOSURE |
Die Belichtungszeiteinstellung wird unterstützt. |
INT |
IS_EXPOSURE_CAP_FINE_INCREMENT |
Das feine Belichtungszeitraster wird unterstützt. |
INT |
IS_EXPOSURE_CAP_LONG_EXPOSURE |
Die Langzeitbelichtung wird unterstützt. Abhängig vom Kameramodell wird die Langzeitbelichtung nur im getriggerten nicht aber im freilaufenden Betrieb unterstützt. |
INT |
IS_EXPOSURE_CAP_DUAL_EXPOSURE |
Nur UI-336x/UI-536x und UI-337x/UI-537x: Der Sensor unterstützt die duale Belichtung. Diese Modelle können gerade und ungerade Zeilen unterschiedlich lang belichten. |
Rückgabewerte
IS_CANT_OPEN_DEVICE |
Ein Versuch die Kamera zu öffnen schlug fehl (Kamera nicht vorhanden oder Fehler beim Initialisieren). |
IS_CANT_COMMUNICATE_WITH_DRIVER |
Kommunikation mit dem Kameratreiber schlug fehl, weil kein Treiber geladen ist. |
IS_INVALID_CAMERA_TYPE |
Kameratyp der .ini-Datei stimmt nicht mit dem aktuellen Kameramodell überein. |
IS_INVALID_CAMERA_HANDLE |
Ungültiges Kamera-Handle |
IS_INVALID_MODE |
Kamera im Standby, Funktion nicht erlaubt Modelle UI-146x/UI-546x: Funktion ist nicht erlaubt weil sich die Kamera im Modus Freerun-Synchronisation befindet. |
IS_INVALID_PARAMETER |
Einer der übergebenen Parameter ist außerhalb des gültigen Bereichs, oder für diesen Sensor nicht unterstützt, bzw. in diesem Modus nicht zugänglich. |
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_CALIBRATED |
Die Kamera enthält keine Kalibrierungsdaten. |
IS_NOT_SUPPORTED |
Das verwendete Kameramodell unterstützt diese Funktion oder Einstellung nicht. |
IS_SUCCESS |
Funktion erfolgreich |
IS_TIMED_OUT |
Ein Timeout trat auf. Eine Bildaufnahme konnte nicht in der vorgeschriebenen Zeit beendet werden. |
Verwandte Funktionen
UINT nCaps = 0;
INT nRet = is_Exposure(m_hCam, IS_EXPOSURE_CMD_GET_CAPS, (void*)&nCaps, sizeof(nCaps));
if (nRet == IS_SUCCESS)
{
if (nCaps & IS_EXPOSURE_CAP_FINE_INCREMENT)
{
// Fine increment supported
}
}
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.
