 |
 |
|---|---|
USB 2.0 USB 3.x GigE |
USB 2.0 USB 3.x GigE |
Syntax
INT is_SetFrameRate (HIDS hCam, double FPS, double* newFPS)
Beschreibung
Mit is_SetFrameRate() wird die Bildrate (Framerate) des Sensors im freilaufenden Modus (Livemodus) eingestellt. Da diese abhängig vom Sensor-Timing eingestellt wird, kann die tatsächlich verwendete Zeit leicht von dem eingestellten Wert abweichen. Die tatsächlich eingestellte Bildrate wird über den Parameter newFPS zurückgegeben.
Wird die Bildrate zu hoch eingestellt, kann unter Umständen nicht mehr jedes Bild übertragen werden. Die effektive Bildrate kann in diesem Fall abweichen.
Die minimalen- und maximalen Belichtungszeiten sowie weiter Abhängigkeiten der einzelnen Sensoren sind im Kapitel Kamera- und Sensordaten aufgeführt.
|
Neuere Treiberversionen ermöglichen teilweise erweiterte Wertebereiche für die Bildrate. Es wird daher empfohlen, diese Bereiche jedes Mal abzufragen und Werte explizit zu setzen. Eine Änderung der Bildrate beeinflusst den Wertebereich der Belichtungszeit. Nach dem Ändern der Bildrate muss die Funktion is_Exposure() aufgerufen werden, um definierte Kameraeinstellungen zu erhalten. |
|
Die Bildrate wird von folgenden Funktionen beeinflusst: •is_AOI() (wenn die Bildgröße geändert wird) Durch Ändern der Fenstergröße, der Bildrate oder des Pixeltakts wird die Bildrate verändert, deshalb muss is_SetFrameRate() danach neu aufgerufen werden. |
|
Die Standard-Bildrate wird nur erreicht, wenn der aktuelle Pixeltakt mindestens so hoch ist wie der Standard-Pixeltakt. |
|
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. |
Übergabeparameter
hCam |
Handle auf Kamera |
FPS |
Gewünschte Bildrate in Bildern pro Sekunde (fps) |
IS_GET_FRAMERATE |
Gibt die aktuell eingestellte Bildrate über den Parameter newFPS zurück. Die tatsächlich erreichte Bildrate kann über is_GetFramesPerSecond() abgefragt werden. |
IS_GET_DEFAULT_FRAMERATE |
Gibt die Standard-Bildrate zurück |
newFPS |
Gibt die tatsächlich eingestellte Bildrate zurück. |
Rückgabewert
IS_INVALID_CAMERA_HANDLE |
Ungültiges Kamera-Handle |
IS_INVALID_MODE |
Kamera im Standby, Funktion nicht erlaubt |
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_NO_SUCCESS |
Allgemeine Fehlermeldung |
IS_SUCCESS |
Funktion erfolgreich |
Verwandte Funktionen
