 |
 |
|---|---|
USB 2.0 USB 3.x GigE |
USB 2.0 USB 3.x GigE |
Syntax
INT is_GetAutoInfo (HIDS hCam, UEYE_AUTO_INFO* pInfo)
Beschreibung
Mit der Funktion is_GetAutoInfo() können Statusinformationen der automatischen Bildregelung abgefragt werden. Die Informationen werden in die Struktur UEYE_AUTO_INFO geschrieben.
Für weitere Informationen zur automatischen Regelung siehe auch das Kapitel Automatische Bildregelung.
|
Die in der Struktur UEYE_AUTO_INFO gelieferten Statusinformationen sind nur gültig, wenn mindestens eine Auto-Funktion mit is_SetAutoParameter() aktiviert wurde. |
Übergabeparameter
hCam |
Handle auf Kamera |
pinfo |
Struktur UEYE_AUTO_INFO (siehe unten) |
Inhalt der Struktur UEYE_AUTO_INFO
INT |
AutoAbility |
Unterstützte Auto-Funktionen •AC_SHUTTER: Auto-Belichtungszeit unterstützt •AC_SENSOR_SHUTTER: Sensorinterne Auto-Belichtungszeit unterstützt •AC_FRAMERATE: Auto-Bildrate unterstützt •AC_SENSOR_FRAMERATE: Sensorinterne Auto-Bildrate unterstützt •AC_GAIN: Auto-Verstärkung unterstützt •AC_SENSOR_GAIN Sensorinterne Auto-Verstärkung unterstützt •AC_SENSOR_AUTO_CONTRAST_CORRECTION: Auto-Kontrast-Korrektur für die Auto- Helligkeitsregelung unterstützt •AC_SENSOR_AUTO_CONTRAST_FDT_AOI: Verwendung der Gesichtsdetektion als Messfeld für die Auto-Helligkeitsregelung unterstützt •AC_SENSOR_AUTO_BACKLIGHT_COMP: Gegenlichtkompensation für die Auto-Helligkeitsregelung unterstützt •AC_WHITEBAL: Auto-Weißabgleich unterstützt •AC_SENSOR_WB: Sensorinterner Auto-Weißabgleich unterstützt |
AUTO_BRIGHT_STATUS |
sBrightCtrlStatus |
Status der automatischen Helligkeitsregelung, siehe unten. |
AUTO_WB_STATUS |
sWBCtrlStatus |
Status des automatischen Weißabgleichs, siehe unten. |
DWORD |
AShutterPhotomCaps |
Gibt eine Bitmaske zurück, die alle unterstützten Photometrie-Einstellungen (Messfelder) für die Auto-Belichtungszeit enthält, siehe unten. |
DWORD |
AGainPhotomCaps |
Gibt eine Bitmaske zurück, die alle unterstützten Photometrie-Einstellungen (Messfelder) für die Auto-Verstärkung enthält, siehe unten. |
DWORD |
AAntiFlickerCaps |
Gibt eine Bitmaske zurück, die alle unterstützten Anti-Flacker-Einstellungen für die Auto-Regelung enthält, siehe unten. |
DWORD |
SensorWBModeCaps |
Gibt eine Bitmaske zurück, die alle unterstützten Einstellungen für den Auto-Weißabgleich des Sensors enthält, siehe unten. |
DWORD |
reserved[8] |
Reservierter Platz für Erweiterungen |
Inhalt der Struktur UEYE_AUTO_INFO::AUTO_BRIGHT_STATUS
INT |
curValue |
Aktueller mittlere Helligkeit des Bildes (Ist-Wert), wobei unabhängig von der Bittiefe des Bildes gilt: •0 = schwarz •255 = weiß |
INT |
curError |
Aktuelle Regelabweichung (Error) |
INT |
curController |
Aktueller Wert der Parameter •AC_SHUTTER: Belichtungszeit (Shutter) •AC_GAIN: Verstärkung (Gain) |
INT |
curCtrlStatus |
Aktueller Reglerstatus •ACS_ADJUSTING: Regelung aktiv •ACS_FINISHED: Regelung abgeschlossen •ACS_DISABLED: Regelung ausgeschaltet |
Inhalt der Struktur UEYE_AUTO_INFO::AUTO_WB_STATUS
INT |
curController |
Aktueller Weißabgleichregler •AC_WB_RED_CHANNEL: Wert des Rotkanals •AC_WB_GREEN_CHANNEL: Wert des Grünkanals •AC_WB_BLUE_CHANNEL: Wert des Blaukanals |
AUTO_WB_CHANNEL_STATUS |
RedChannel |
Siehe AUTO_WB_CHANNEL_STATUS |
AUTO_WB_CHANNEL_STATUS |
GreenChannel |
Siehe AUTO_WB_CHANNEL_STATUS |
AUTO_WB_CHANNEL_STATUS |
BlueChannel |
Siehe AUTO_WB_CHANNEL_STATUS |
Inhalt der Struktur UEYE_AUTO_INFO::AUTO_WB_STATUS::AUTO_WB_CHANNEL_STATUS
INT |
curValue |
Aktueller mittlerer Grauwert (Ist-Wert) |
INT |
curError |
Aktuelle Regelabweichung (Error) |
INT |
curCtrlStatus |
Aktueller Reglerstatus •ACS_ADJUSTING: Regelung aktiv •ACS_FINISHED: Regelung abgeschlossen •ACS_DISABLED: Regelung ausgeschaltet |
Statusflags in UEYE_AUTO_INFO::AShutterPhotomCaps
AS_PM_NONE |
Es wird das ganze Bildfeld zur Messung verwendet. |
AS_PM_SENS_CENTER_AVERAGE |
Die Messung erfolgt über das ganze Bildfeld, wobei alle Bildbereich gleich stark gewichtet werden und ein Durchschnittswert ermittelt wird. |
AS_PM_SENS_CENTER_WEIGHTED |
Die Messung erfolgt über das ganze Bildfeld, wobei der mittlere Bildbereich stärker gewichtet wird. |
AS_PM_SENS_CENTER_SPOT |
Die Messung erfolgt nur über einen kleinen Ausschnitt in der Bildmitte. |
AS_PM_SENS_PORTRAIT |
Die Messung erfolgt über einen Teil des Bildfelds, der sich am Hochformat ausrichtet. |
AS_PM_SENS_LANDSCAPE |
Die Messung erfolgt über einen Teil des Bildfelds, der sich am Querformat ausrichtet. |
Statusflags in UEYE_AUTO_INFO::AGainPhotomCaps
AG_PM_NONE |
Es wird das ganze Bildfeld zur Messung verwendet. |
AS_PM_SENS_CENTER_AVERAGE |
Die Messung erfolgt über das ganze Bildfeld, wobei alle Bildbereich gleich stark gewichtet werden und ein Durchschnittswert ermittelt wird. |
AG_PM_SENS_CENTER_WEIGHTED |
Die Messung erfolgt über das ganze Bildfeld, wobei der mittlere Bildbereich stärker gewichtet wird. |
AG_PM_SENS_CENTER_SPOT |
Die Messung erfolgt nur über einen kleinen Ausschnitt in der Bildmitte. |
AS_PM_SENS_PORTRAIT |
Die Messung erfolgt über einen Teil des Bildfelds, der sich am Hochformat ausrichtet. |
AS_PM_SENS_LANDSCAPE |
Die Messung erfolgt über einen Teil des Bildfelds, der sich am Querformat ausrichtet. |
Statusflags in UEYE_AUTO_INFO::AAntiFlickerCaps
ANTIFLCK_MODE_OFF |
Anti-Flacker-Funktion deaktiviert. |
ANTIFLCK_MODE_SENS_AUTO |
Der Anti-Flacker-Modus wird automatisch ausgewählt (50 oder 60 Hz). |
ANTIFLCK_MODE_SENS_50_FIXED |
Der Anti-Flacker-Modus wird fest auf 50 Hz gesetzt. |
ANTIFLCK_MODE_SENS_60_FIXED |
Der Anti-Flacker-Modus wird fest auf 60 Hz gesetzt. |
Statusflags in UEYE_AUTO_INFO::SensorWBModeCaps
WB_MODE_DISABLE |
Weißabgleich-Regelung des Sensors deaktiveren |
WB_MODE_AUTO |
Der Sensor ermittelt den Weißabgleich automatisch. |
WB_MODE_ALL_PULLIN |
Der Sensor ermittelt den Weißabgleich automatisch nach dem Grey-World-Algorithmus. Dieser geht davon aus, dass der mittlere Farbwert einer Szene Grau ist. |
WB_MODE_INCANDESCENT_LAMP |
Der Sensor setzt den Weißabgleich auf Glühlampenlicht. |
WB_MODE_FLUORESCENT_DL |
Der Sensor setzt den Weißabgleich auf Leuchtstoffröhrenlicht (tageslichtweiß). |
WB_MODE_FLUORESCENT_LAMP |
Der Sensor setzt den Weißabgleich auf Leuchtstoffröhrenlicht (warmweiß). |
WB_MODE_FLUORESCENT_NL |
Der Sensor setzt den Weißabgleich auf Leuchtstoffröhrenlicht (neutral-/ kaltweiß). |
WB_MODE_OUTDOOR_CLEAR_SKY |
Der Sensor setzt den Weißabgleich auf direktes Tageslicht. |
WB_MODE_OUTDOOR_CLOUDY |
Der Sensor setzt den Weißabgleich auf bewölkten Himmel. |
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
