is_SetOptimalCameraTiming

USB 2.0

USB 3.0

–

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 den Kameramodellen UI-3013XC, UI-1007XS nicht unterstützt.

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:

•is_SetFrameRate()

•is_Exposure()

•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
[4000...20000]

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

•is_PixelClock()

•is_SetFrameRate()

•is_SetAutoParameter()

•is_CaptureVideo()

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.