 |
 |
|---|---|
USB 2.0 USB 3.x |
– |
Syntax
INT is_SetOptimalCameraTiming (HIDS hCam, INT Mode, INT Timeout, INT* pMaxPxlClk, double* pMaxFrameRate)
Beschreibung
|
WICHTIG! Die Funktion zum Ermitteln des optimalen Pixeltakts kann nicht für uEye Kameras verwendet werden, bei denen der interne Bildspeicher aktiviert ist. Diese Funktion wird von folgenden Kameramodellen nicht unterstützt: •UI-1007XS |
Mit is_SetOptimalCameraTiming() wird der höchstmögliche Pixeltakt (bei voller Auflösung) der aktuellen Konfiguration ermittelt. Es wird der Pixeltakt gesetzt, für den innerhalb der durch Timeout angegebenen Zeit keine Übertragungsfehler auftreten. Des Weiteren wird die mit diesem Pixeltakt maximal mögliche Bildwiederholrate zurückgegeben.
is_SetOptimalCameraTiming() kann nur im Freerun ausgeführt werden (is_CaptureVideo()). Wenn der Rückgabewert ≠ IS_SUCCESS ist, so werden keine Einstellungen vorgenommen.
Die Funktion sollte in einem eigenen Thread ausgeführt werden und im Hintergrund laufen, damit die durch zusätzliche Farbkonvertierungen etc. entstehende Rechenlast mit einkalkuliert werden kann. Andernfalls kann die Funktion nicht die optimalen Werte liefern.
Eine Änderung der Bildgeometrie oder des Pixeltakts beeinflusst die Wertebereiche von Bildwiederholrate und Belichtungszeit. Es wird empfohlen, nach dem Ausführen von is_SetOptimalCameraTiming() folgende Funktionen aufzurufen, um definierte Kameraeinstellungen zu erhalten:
•Wenn die Blitzfunktion der uEye Kamera verwendet wird: is_IO()
•Zum Starten der Bilderfassung im Livemodus (freerun): is_CaptureVideo()
Übergabeparameter
hCam |
Handle auf Kamera |
Timeout |
Stellt die Zeit in Millisekunden ein, während der kein Übertragungsfehler auftreten darf. Einstellbare Zeiten liegen zwischen 4 und 20 Sekunden. Je höher der Wert, desto sicherer ist der ermittelte Pixeltakt, wodurch die Laufzeit dieser Funktion allerdings entsprechend verlängert wird. |
pMaxPxlClk |
Gibt den maximalen Pixeltakt in MHz zurück. |
pMaxFrameRate |
Gibt die maximale Bildrate in fps zurück. |
Rückgabewert
IS_AUTO_EXPOSURE_RUNNING |
Die Einstellung kann nicht geändert werden, solange die automatische Belichtungszeitregelung aktiviert ist. |
IS_INVALID_IMAGE_SIZE |
Ungültige Bildgröße Wird zurückgegeben, wenn z.B. die Funktion bei aktiviertem Binning oder Subsampling aufgerufen wird. |
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_NOT_SUPPORTED |
Das verwendete Kameramodell unterstützt diese Funktion oder Einstellung nicht. |
IS_TRIGGER_ACTIVATED |
Die Funktion ist nicht möglich, da die Kamera auf ein Triggersignal wartet. |
Verwandte Funktionen
