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.

Hinweis zur Abhängigkeit von anderen Einstellungen Die Belichtungszeit wird von folgenden Funktionen beeinflusst: •is_PixelClock() •is_SetOptimalCameraTiming() •is_SetFrameRate() •is_AOI() (wenn die Bildgröße geändert wird) •is_SetSubSampling() •is_SetBinning() 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.

Übernahme neuer Einstellungen

Im freilaufenden Modus (is_CaptureVideo()) wirkt sich die Änderung der Belichtungszeit erst bei der Aufnahme des übernächsten Bildes aus. Im Triggermodus (is_SetExternalTrigger()) wird die Änderung zum nächsten Bild übernommen. Siehe auch Kapitel Übernahme neuer Parameter.

In der Regel wird der Pixeltakt einmalig beim Öffnen der Kamera gesetzt und danach nicht mehr geändert. Beachten Sie, dass sich beim Ändern des Pixeltakts auch die Einstellbereiche für die Bildrate und die Belichtungszeit ändern. Bei einer Änderung wird folgende Reihenfolge empfohlen: 1.Pixeltakt ändern. 2.Einstellbereich für die Bildrate abfragen und ggf. neu setzen. 3.Einstellbereich für die Belichtungszeit abfragen und ggf. neu setzen. Wenn ein Parameter verändert wird, müssen aufgrund der Abhängigkeiten auch die nachfolgenden Parameter angepasst werden.

Genauigkeit der Belichtungszeiteinstellung

Die Schrittweite für die Einstellung der Belichtungszeit (IS_EXPOSURE_CMD_GET_EXPOSURE_RANGE_INC) ist vom aktuellen Timing des Sensors (Pixeltakt, Bildrate) abhängig. Die kleinste Schrittweite entspricht in der Regel einer Zeilendauer, also der Zeit, die der Sensor zum Auslesen einer Bildzeile benötigt.

Die tatsächlich eingestellte Belichtungszeit können Sie über den Parameter IS_EXPOSURE_CMD_GET_EXPOSURE abfragen.

Manche Sensoren besitzen die Möglichkeit, die Belichtungszeit mit kleineren Schrittweiten einzustellen. Ob ein Sensor diese Funktion unterstützt, können Sie über den Parameter IS_EXPOSURE_CMD_GET_CAPS abfragen.

Die minimalen und maximalen Belichtungszeiten sowie weitere Abhängigkeiten der einzelnen Sensoren sind im Kapitel Kamera- und Sensordaten aufgeführt.

Rundungsfehlern bei der Schrittweite

Wenn Sie eine neue Belichtungszeit über das zurückgegebene Inkrement berechnen, beachten Sie, dass Berechnungen mit Gleitkommawerten im PC immer mit Rundungsfehlern behaftet sind. Daher kann es vorkommen, dass eine Addition oder Subtraktion des Wertes n*INCREMENT nicht exakt zum gewünschten Ergebnis führt. Die uEye API rundet in diesem Fall den Gleitkommawert ab und setzt die nächst kleinere Belichtungszeit.

Um dieses Verhalten zu umgehen, sollte bei Berechnungen mit n*INCREMENT zusätzlich der Wert INCREMENT/2.f (halbes Intervall) addiert werden. Dadurch wird auch nach der Abrundung der gewünschte Wert gesetzt.

Ü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
nCommand IS_EXPOSURE_CMD_GET_EXPOSURE_DEFAULT Gibt die Standardeinstellung für die Belichtungszeit zurück. •pParam: Zeiger auf Variable vom Typ double, in der der Standardwert zurückgegeben wird. •nSizeOfParam: 8 Wird der Wert 0.0 zurückgegeben, bedeutet dies, dass die Belichtungszeit auf den maximalen Wert 1/Bildrate gesetzt ist. IS_EXPOSURE_CMD_GET_EXPOSURE Gibt die aktuell eingestellte Belichtungszeit zurück (in ms). •pParam: Zeiger auf Variable vom Typ double, in der der aktuelle Wert zurückgegeben wird. •nSizeOfParam: 8 IS_EXPOSURE_CMD_GET_EXPOSURE_RANGE_MIN Gibt die minimale Belichtungszeit zurück. •pParam: Zeiger auf Variable vom Typ double, in der der minimale Wert zurückgegeben wird. •nSizeOfParam: 8 IS_EXPOSURE_CMD_GET_EXPOSURE_RANGE_MAX Gibt die maximale Belichtungszeit zurück. •pParam: Zeiger auf Variable vom Typ double, in der der maximale Wert zurückgegeben wird. •nSizeOfParam: 8 IS_EXPOSURE_CMD_GET_EXPOSURE_RANGE_INC Gibt das Inkrement der Belichtungszeit zurück. •pParam: Zeiger auf Variable vom Typ double, in der das Inkrement zurückgegeben wird. •nSizeOfParam: 8 IS_EXPOSURE_CMD_GET_EXPOSURE_RANGE Gibt den Wertebereich der Belichtungszeit zurück. •pParam: Zeiger auf ein Array vom Typ double, in dem der minimale und maximale Wert sowie das Inkrement zurückgegeben werden (in genau dieser Reihenfolge). •nSizeOfParam: 24 IS_EXPOSURE_CMD_SET_EXPOSURE Setzt die Belichtungszeit (in ms) •pParam: Zeiger auf Variable vom Typ double, in der der zu setzende Wert übergeben wird. Enthält nach dem Setzen der neuen Belichtungszeit die tatsächlich gesetzte Belichtungszeit. Diese kann je nach Sensor minimal von der gewünschten Belichtungszeit abweichen. •nSizeOfParam: 8 Bei Übergabe von 0 wird die Belichtungszeit auf den maximalen Wert 1/Bildrate gesetzt.
pParam	Zeiger auf Funktionsparameter, der abhängig von nCommand unterschiedlich belegt ist.
cbSizeOfParam	Größe des Speicherbereichs in Byte, auf den pParam verweist.