Aktivieren Sie JavaScript, um die Website anzuzeigen.

IDS Software Suite 4.95.1

Windows_Logo
Linux_Logo

USB 2.0

USB 3.x

GigE

USB 2.0

USB 3.x

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).

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-122x/UI-322x/UI-522x

oUI-1007XS
Sensorinterner Weißabgleich

hint_info

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.

hint_info

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

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 abfragen
double dOffsetRDefault, dOffsetBDefault;
int ret = is_SetAutoParameter (hCam, IS_GET_AUTO_WB_OFFSET_DEF, &dOffsetRDefault, &dOffsetBDefault);
 
// Minimalen Offset abfragen
double dOffsetRMin, dOffsetBMin;
int ret = is_SetAutoParameter (hCam, IS_GET_AUTO_WB_OFFSET_MIN, &dOffsetRMin, &dOffsetBMin);
 
// Maximalen Offset 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);

© 2021 IDS Imaging Development Systems GmbH