IDS Software Suite 4.95

Durch Ändern der Bildgröße, der Bildrate oder des Pixeltakts wird die Belichtungszeit verändert, deshalb muss is_Exposure() danach neu aufgerufen werden.

hint_info

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

•is_SetFrameRate()

•is_PixelClock()

•is_SetOptimalCameraTiming()

•is_SetAutoParameter()

•is_AutoParameter()

•is_SetHardwareGain()

Beispiel

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
}
}

Aktivieren Sie JavaScript, um die Website anzuzeigen.

IDS Software Suite 4.95