is_SetAutoParameter

USB 2.0

USB 3.0

GigE

USB 2.0

USB 3.0

GigE

Syntax

INT is_SetAutoParameter (HIDS hCam, INT param, double* pval1, double* pval2)

Beschreibung

is_SetAutoParameter() steuert die automatischen Regelungen für Verstärkung (Gain), Belichtungszeit (Exposure Shutter), Bildrate (Framerate) und Weißabgleich (Whitebalance). Bei den HDR-Kameramodellen UI-112x/UI-512x können Sie über den Parameter IS_SET_ENABLE_AUTO_GAIN die automatische Anpassung für den Weißpunkt des Bildes aktivieren (siehe auch UI-112x/UI-512x Anwendungshinweise).

Für weitere Informationen zur automatischen Regelung siehe auch das Kapitel Automatische Bildregelung.

•Die Regelung ist nur aktiv, so lange die Kamera Bilder aufnimmt.

•Die Auto-Funktionen werden deaktiviert, wenn die Einstellungen für Belichtungszeit und Verstärkung manuell geändert werden.

•Bei eingeschalteter Auto-Belichtungszeit ist eine Veränderung des Pixeltakts nicht möglich.

•Auto-Bildrate ist nur bei eingeschalteter Auto-Shutter-Regelung möglich. Auto-Bildrate und Auto-Verstärkung können nicht gleichzeitig verwendet werden.

•Auto-Verstärkung ist nur für Kameras mit Gesamtverstärkung-Regler möglich. Auto-Weißabgleich ist nur für Kameras mit Hardware RGB-Verstärkungsregler möglich.

•Die sensorinternen Auto-Funktionen werden von den Sensoren der folgenden Kameramodelle unterstützt.
Bitte lesen Sie auch die Anwendungshinweise zu diesen Sensoren.

oUI-112x/UI-512x (HDR-Sensor)

oUI-122x/UI-322x/UI-522x

oUI-3013XC
Sensorinterner Weißabgleich, Belichtungs- und Gegenlichtkorrektur sowie Anti-Flacker-Modus (siehe Automatische Bildregelung).

oUI-1007XS
Sensorinterner Weißabgleich

Hinweis zur sensorinternen Regelung

Die gleichzeitige Verwendung der sensorinternen und der softwareseitigen Regelung ist nicht möglich. Um die sensorinterne Regelung nutzen zu können, muss die softwareseitige Regelung deaktiviert werden, und umgekehrt.

Modelle mit HDR-Sensor

Bei den Modellen UI-112x/UI-512x mit HDR-Sensor sind einige Auto-Funktionen anders belegt oder nicht verfügbar:

•Der HDR-Sensor besitzt keine Verstärkung. Die Parameter AUTO_GAIN/AUTO_SENSOR_GAIN regeln die Weißwert-Anpassung (siehe Kapitel UI-112x/UI-512x Anwendungshinweise).

•Die Parameter AUTO_SHUTTER/AUTO_SENSOR_SHUTTER, AUTO_FRAMERATE/AUTO_SENSOR_FRAMERATE sowie AUTO_SENSOR_WHITEBALANCE sind bei diesem Sensor nicht verfügbar.

USB 3 uEye XC

•Die Funktionen Auto-Kontrast-Korrektur und Gegenlichtkorrektur können nicht gleichzeitig verwendet werden.

•Wenn der Anti-Flacker-Modus aktiviert ist, dürfen die Einstellungen der Auto-Belichtungszeit nicht geändert werden.

Hinweis zur automatischen Regelung bei sehr hohen Bildraten

Sehr hohe Bildraten können eine zu große Zahl von Regelanweisungen an die Kamera bewirken. Erhöhen Sie bei Bildraten von über 100 Bilder/s den Wert für IS_SET_AUTO_SKIPFRAMES. Dadurch werden weniger Bilder für die Regelung verwendet und die Kamera wird entlastet.

Übergabeparameter

hCam

Handle auf Kamera

param

Auto-Funktion konfigurieren

IS_SET_ENABLE_AUTO_GAIN

Aktiviert/deaktiviert die Auto-Verstärkungs-Funktion bzw. bei HDR-Sensoren die Weißwert-Anpassung.

IS_GET_ENABLE_AUTO_GAIN

Gibt die aktuelle Einstellung der Auto-Verstärkung bzw. der Weißwert-Anpassung zurück.

IS_SET_ENABLE_AUTO_SENSOR_GAIN

Aktiviert/deaktiviert die interne Auto-Verstärkungs-Funktion bzw. bei HDR-Sensoren die Weißwert-Anpassung des Sensors*1.

IS_GET_ENABLE_AUTO_SENSOR_GAIN

Gibt die aktuelle Einstellung der Auto-Verstärkung bzw. der Weißwert-Anpassung des Sensors zurück*1.

IS_SET_ENABLE_AUTO_SHUTTER

Aktiviert/deaktiviert die Auto-Belichtungszeit-Funktion.

IS_GET_ENABLE_AUTO_SHUTTER

Gibt die aktuelle Auto-Belichtungszeit-Einstellung zurück.

IS_SET_ENABLE_AUTO_SENSOR_SHUTTER

Aktiviert/deaktiviert die interne Auto-Belichtungszeit-Funktion des Sensors*1.

IS_GET_ENABLE_AUTO_SENSOR_SHUTTER

Gibt die aktuelle Auto-Belichtungszeit-Einstellung des Sensors zurück*1.

IS_SET_ENABLE_AUTO_SENSOR_GAIN_SHUTTER

USB uEye XS: Aktiviert/deaktiviert die Auto-Belichtungszeit/Auto-Verstärkung-Funktion. Bei der USB uEye XS können die automatische Regelung der Belichtungszeit und Verstärkung nur zusammen aktiviert oder deaktiviert werden.

Hinweis: Wenn Sie eine manuelle Belichtungszeit setzen möchten, müssen Sie zuerst die Auto-Funktion deaktivieren (Beispiel 3).

IS_GET_ENABLE_AUTO_SENSOR_GAIN_SHUTTER

USB uEye XS: Gibt die aktuelle Auto-Belichtungszeit/Auto-Verstärkung zurück.

IS_SET_ENABLE_AUTO_WHITEBALANCE

Aktiviert/deaktiviert die Auto-Weißabgleich-Funktion.

IS_GET_ENABLE_AUTO_WHITEBALANCE

Gibt die aktuelle Auto-Weißabgleich-Einstellung zurück.

IS_SET_ENABLE_AUTO_SENSOR_WHITEBALANCE

Aktiviert/deaktiviert die interne Auto-Weißabgleich-Funktion des Sensors*1.

IS_GET_ENABLE_AUTO_SENSOR_WHITEBALANCE

Gibt die aktuelle Auto-Weißabgleich-Einstellung des Sensors zurück*1.

IS_SET_ENABLE_AUTO_FRAMERATE

Aktiviert/deaktiviert die Auto-Bildraten-Funktion.

IS_GET_ENABLE_AUTO_FRAMERATE

Gibt die aktuelle Auto-Bildraten-Einstellung zurück.

IS_SET_ENABLE_AUTO_SENSOR_FRAMERATE

Aktiviert/deaktiviert die interne Auto-Bildraten-Funktion des Sensors*1.

IS_GET_ENABLE_AUTO_SENSOR_FRAMERATE

Gibt die aktuelle Auto-Bildraten-Einstellung des Sensors zurück*1.

IS_SET_AUTO_REFERENCE

Setzt den Sollwert für Auto-Verstärkung/Auto-Belichtungszeit.

Bei der USB uEye XS gibt der Sollwert für die Auto-Verstärkung/Auto-Belichtungszeit nicht den quantitativen Sollwert für die mittlere Bildhelligkeit sondern lediglich einen qualitativen Sollwert vor.

IS_GET_AUTO_REFERENCE

Gibt den Sollwert für Auto-Verstärkung/Auto-Belichtungszeit zurück.

IS_SET_AUTO_GAIN_MAX

Setzt die obere Regelgrenze für Auto-Verstärkung.

Bei der USB uEye XS regelt die Auto-Helligkeitsregelung unter Umständen die Verstärkung nach oben bevor die maximale Belichtungszeit erreicht wird. Daher kann es zur Überschreitung des eingestellten Maximalwerts für die Auto-Verstärkung kommen.

IS_GET_AUTO_GAIN_MAX

Gibt die obere Regelgrenze für Auto-Verstärkung zurück.

IS_SET_AUTO_SHUTTER_MAX

Setzt die obere Regelgrenze für Auto-Belichtungszeit.

IS_GET_AUTO_SHUTTER_MAX

Gibt die obere Regelgrenze für Auto-Belichtungszeit zurück.

IS_SET_AUTO_BRIGHTNESS_ONCE

Aktiviert/deaktiviert automatisches Abschalten der Auto-Helligkeitsregelung (Verstärkung und Belichtungszeit)*2.

IS_GET_AUTO_BRIGHTNESS_ONCE

Gibt den Zustand der automatischen Abschaltung zurück*2.

Geschwindigkeit und Hysterese

IS_SET_AUTO_SPEED

Setzt den Geschwindigkeitswert der Auto-Funktion.

IS_GET_AUTO_SPEED

Gibt den Geschwindigkeitswert der Auto-Funktion zurück.

IS_SET_AUTO_SKIPFRAMES

Setzt die Anzahl der bei der Regelung nicht auszuwertenden Bilder.

IS_GET_AUTO_SKIPFRAMES

Gibt die Anzahl der bei der Regelung nicht auszuwertenden Bilder zurück.

IS_GET_AUTO_SKIPFRAMES_RANGE

Gibt den erlaubten Bereich für die Anzahl der nicht auszuwertenden Bilder zurück.

IS_SET_AUTO_HYSTERESIS

Setzt den Hysteresewert für Auto-Belichtungszeit und -Verstärkung.

IS_GET_AUTO_HYSTERESIS

Gibt den Hysteresewert für Auto-Belichtungszeit und -Verstärkung zurück.

IS_GET_AUTO_HYSTERESIS_RANGE

Gibt den erlaubten Bereich für den Hysteresewert zurück.

Auto-Kontast-Korrektur (nur UI-3013XC)

IS_SET_SENS_AUTO_CONTRAST_CORRECTION

Setzt den Wert für die Auto-Kontrast-Korrektur.

IS_GET_SENS_AUTO_CONTRAST_CORRECTION

Gibt den Wert für die Auto-Kontrast-Korrektur zurück.

IS_GET_SENS_AUTO_CONTRAST_CORRECTION_RANGE

Gibt den erlaubten Bereich für die Auto-Kontrast-Korrektur zurück.

IS_GET_SENS_AUTO_CONTRAST_CORRECTION_INC

Gibt die Schrittweite für die Auto-Kontrast-Korrektur zurück.

IS_GET_SENS_AUTO_CONTRAST_CORRECTION_DEF

Gibt den Standardwert für die Auto-Kontrast-Korrektur zurück.

Anti-Flacker-Modus (nur UI-3013XC)

IS_SET_ANTI_FLICKER_MODE

Setzt den Anti-Flacker-Modus.

IS_GET_ANTI_FLICKER_MODE

Gibt den Anti-Flacker-Modus zurück.

IS_GET_ANTI_FLICKER_MODE_DEF

Gibt den Standardwert für den Anti-Flacker-Modus zurück.

Gegenlichtkorrektur (nur UI-3013XC)

IS_SET_SENS_AUTO_BACKLIGHT_COMP

Aktiviert die Gegenlichtkompensation für die Auto-Helligkeitsregelung.

IS_GET_SENS_AUTO_BACKLIGHT_COMP

Gibt den Status der Gegenlichtkompensation zurück.

IS_SET_AUTO_WB_OFFSET

Setzt den Offset für den roten und blauen Kanal.

IS_GET_AUTO_WB_OFFSET

Gibt den Offset für den roten und blauen Kanal zurück.

IS_SET_AUTO_WB_GAIN_RANGE

Setzt die Regelgrenzen der Farbverstärkung für den Auto-Weißabgleich.

IS_GET_AUTO_WB_GAIN_RANGE

Gibt die Regelgrenzen der Farbverstärkung für den Auto-Weißabgleich zurück.

IS_SET_AUTO_WB_ONCE

Setzt automatisches Abschalten für Auto-Weißabgleich*2.

IS_GET_AUTO_WB_ONCE

Gibt den Zustand der automatischen Abschaltung zurück*2.

IS_GET_AUTO_WB_OFFSET_DEF

Gibt den Standard-Offset für Rot und Blau zurück (Beispiel 2).

IS_GET_AUTO_WB_OFFSET_MIN

Gibt den minimalen Offset für Rot und Blau zurück (Beispiel 2).

IS_GET_AUTO_WB_OFFSET_MAX

Gibt den maximalien Offset für Rot und Blau zurück (Beispiel 2).

Geschwindigkeit und Hysterese

IS_SET_AUTO_WB_SPEED

Setzt die Geschwindigkeit für Auto-Weißabgleich.

IS_GET_AUTO_WB_SPEED

Gibt die Geschwindigkeit für Auto-Weißabgleich zurück.

IS_SET_AUTO_WB_HYSTERESIS

Setzt den Hysteresewert für Auto-Weißabgleich.

IS_GET_AUTO_WB_HYSTERESIS

Gibt den Hysteresewert für Auto-Weißabgleich zurück.

IS_GET_AUTO_WB_HYSTERESIS_RANGE

Gibt den erlaubten Bereich für den Hysteresewert zurück.

IS_SET_AUTO_WB_SKIPFRAMES

Setzt die Anzahl der bei der Regelung nicht auszuwertenden Bilder.

IS_GET_AUTO_WB_SKIPFRAMES

Gibt die Anzahl der bei der Regelung nicht auszuwertenden Bilder zurück.

IS_GET_AUTO_WB_SKIPFRAMES_RANGE

Gibt den erlaubten Bereich für die Anzahl der nicht auszuwertenden Bilder zurück.

pval1

Einstellparameter, hat je nach Auto-Funktion eine andere Belegung

pval2

Einstellparameter, hat je nach Auto-Funktion eine andere Belegung

*1 Nicht von allen Sensoren unterstützt

*2 Nicht bei Verwendung der sensor-internen Regelung

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_INCOMPATIBLE_SETTING	Die Funktion ist nicht möglich, da andere Einstellungen nicht kompatibel sind.
IS_INVALID_CAMERA_TYPE	Kameratyp der .ini-Datei stimmt nicht mit dem aktuellen Kameramodell überein.
IS_INVALID_CAMERA_HANDLE	Ungültiges Kamera-Handle
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_INVALID_WB_BINNING_MODE	Bei Monobinning/-subsampling ist kein automatischer Weißabgleich möglich.
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_CALIBRATED	Die Kamera enthält keine Kalibrierungsdaten.
IS_NOT_SUPPORTED	Das verwendete Kameramodell unterstützt diese Funktion oder Einstellung nicht.
IS_NULL_POINTER	Ungültiges Array
IS_SUCCESS	Funktion erfolgreich
IS_TIMED_OUT	Ein Timeout trat auf. Eine Bildaufnahme konnte nicht in der vorgeschriebenen Zeit beendet werden.

Verwandte Funktionen

•is_ParameterSet()

•is_GetAutoInfo()

•is_SetHardwareGain()

•is_SetHWGainFactor()

•is_Exposure()

•is_SetFrameRate()

•is_AOI()

Beispiel 1

//Auto-Verstärkung aktivieren:
double dEnable = 1;
int ret = is_SetAutoParameter (hCam, IS_SET_ENABLE_AUTO_GAIN, &dEnable, 0);

//Helligkeitssollwert auf 128 stellen:
double soll = 128;
int ret = is_SetAutoParameter (hCam, IS_SET_AUTO_REFERENCE, &soll, 0);

//Belichtungszeit-Regelgrenze zurücklesen:
double maxShutter;
int ret = is_SetAutoParameter (hCam, IS_GET_AUTO_SHUTTER_MAX, &maxShutter, 0);

Beispiel 2

// Standard-Offset der XS abfragen
double dOffsetRDefault, dOffsetBDefault;
int ret = is_SetAutoParameter (hCam, IS_GET_AUTO_WB_OFFSET_DEF, &dOffsetRDefault, &dOffsetBDefault);

// Minimalen Offset der XS abfragen
double dOffsetRMin, dOffsetBMin;
int ret = is_SetAutoParameter (hCam, IS_GET_AUTO_WB_OFFSET_MIN, &dOffsetRMin, &dOffsetBMin);

// Maximalen Offset der XS abfragen
double dOffsetRMax, dOffsetBMax;
int ret = is_SetAutoParameter (hCam, IS_GET_AUTO_WB_OFFSET_MAX, &dOffsetRMax, &dOffsetBMax);

Beispiel 3

// Auto-Belichtungszeit deaktivieren
double dblEnable = 0;
double dblDummy = 0;
ret = is_SetAutoParameter(m_hCam, IS_SET_ENABLE_AUTO_SENSOR_GAIN_SHUTTER, &dblEnable, &dblDummy);

// Manuelle Belichtungszeit setzen
double newExposure = 50.0;
ret = is_Exposure(m_hCam, IS_EXPOSURE_CMD_SET_EXPOSURE, &newExposure, 8);

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.