 |
 |
|---|---|
USB 2.0 USB 3.x GigE |
USB 2.0 USB 3.x GigE |
Syntax
INT is_SetHdrKneepoints (HIDS hCam, KNEEPOINTARRAY* KneepointArray, INT KneepointArraySize)
Beschreibung
Mit is_SetHdrKneepoints() kann der von einigen Sensoren unterstützte HDR-Modus (High Dynamic Range) eingestellt werden. Der HDR-Modus wird mit is_EnableHdr() aktiviert/deaktiviert.
Für weitere Informationen zum HDR-Modus siehe auch Sensoren mit Kniepunkt-HDR.
|
Der HDR-Modus mit Kniepunkten wird nur von den Modellen UI-122x/UI-322x/UI-522x, UI-313xCP/UI-513x und UI-314x/UI-514x unterstützt. |
Übergabeparameter
hCam |
Handle auf Kamera |
KneepointArray |
Zeiger auf ein Feld (siehe unten) |
Inhalt des Feldes KNEEPOINTARRAY
INT NumberOfUsedKneepoints |
Anzahl verwendeter Kniepunkte |
KNEEPOINT Kneepoint[10] |
Kniepunkt |
Inhalt der Struktur KNEEPOINT
double x |
X-Wert des Kniepunkts |
double y |
Y-Wert des Kniepunkts |
Der x-Wert eines Kniepunkts gibt die erste Belichtungsphase in Prozent der aktuell eingestellten Belichtungszeit an. Der y-Wert gibt den Anteil der maximalen Pixelintensität in Prozent an. Werden zwei Kniepunkte verwendet, so lassen sich zwei Phasen einstellen, bei denen die Belichtung unterbrochen wird. Ebenso werden dann zwei entsprechende Zeitpunkte auf der X-Achse festgelegt.
Eine Einstellung von x = 60, y = 80 beispielsweise hätte folgende Auswirkungen: Die erste Belichtungsphase dauert 60 % der eingestellten Belichtungszeit. Alle Pixel werden in dieser ersten Belichtungsphase bis auf höchstens 80 % der maximalen Pixelintensität belichtet und bleiben auf 80 % stehen, bis die Phase vorbei ist. In der zweiten Belichtungsphase werden sie wieder belichtet und können die volle Pixelintensität erreichen.
Rückgabewert
IS_CANT_COMMUNICATE_WITH_DRIVER |
Kommunikation mit dem Kameratreiber schlug fehl, weil kein Treiber geladen ist. |
IS_CANT_OPEN_DEVICE |
Ein Versuch die Kamera zu öffnen schlug fehl (Kamera nicht vorhanden oder Fehler beim Initialisieren). |
IS_INVALID_CAMERA_HANDLE |
Ungültiges Kamera-Handle |
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_SUPPORTED |
Das verwendete Kameramodell unterstützt diese Funktion oder Einstellung nicht. |
IS_SUCCESS |
Funktion erfolgreich |
Verwandte Funktionen
