is_GetAutoInfo

USB 2.0

USB 3.0

GigE

USB 2.0

USB 3.0

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

•is_SetAutoParameter()

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.