USB 2.0 USB 3.0 GigE	USB 2.0 USB 3.0 GigE

Syntax

INT is_Blacklevel(HIDS hCam, UINT nCommand, void* pParam, UINT cbSizeOfParam)

Beschreibung

is_Blacklevel() steuert die Schwarzwert-Korrektur der Kamera, mit der die Bildqualität unter Umständen verbessert werden kann. Standardmäßig regelt der Sensor den Schwarzwert der Pixel selbstständig. Bei sehr starker Helligkeitseinwirkung kann eine manuelle Anpassung des Schwarzwerts nötig sein.

UI-112x/UI-512x: Bei Modellen mit HDR-Sensor regelt die Funktion is_Blacklevel() den Schwarzwert bei der Kontrastanpassung in der Kamera.

Abb. 211: Schwarzwert-Korrektur Auto

Abb. 212: Schwarzwert-Korrektur Auto + Offset

Abb. 213: Schwarzwert-Korrektur nur Offset

Über den Übergabeparameter nCommand wird dabei der Funktionsmodus gewählt. Der Übergabeparameter pParam ist abhängig vom Funktionsmodus unterschiedlich belegt; bei Funktionen zum Setzen oder Rücklesen eines Wertes enthält pParam einen Zeiger auf eine Variable vom Typ UINT. Die Größe des Speicherbereichs, auf den pParam verweist, wird im Übergabeparameter cbSizeOfParam angegeben.

Übergabeparameter

hCam	Handle auf Kamera
nCommand IS_BLACKLEVEL_CMD_GET_CAPS Gibt die Blacklevel-Fähigkeiten der Kamera zurück (Beispiel 1): •IS_BLACKLEVEL_CAP_SET_AUTO_BLACKLEVEL: Der Zustand des automatischen Blacklevels kann verändert werden. Das Flag gibt keine Auskunft darüber, ob die Kamera standardmäßig mit Auto-Blacklevel läuft oder nicht. Verwenden Sie hierfür IS_BLACKLEVEL_CMD_GET_MODE_DEFAULT. •IS_BLACKLEVEL_CAP_SET_OFFSET: Der Offset kann geändert werden. Das Flag gibt keine Auskunft darüber, ob die Kamera standardmäßig einen Offset gesetzt hat oder nicht. Verwenden Sie hierfür IS_BLACKLEVEL_CMD_GET_OFFSET_DEFAULT. IS_BLACKLEVEL_CMD_GET_MODE_DEFAULT Gibt den Standard-Blacklevel-Modus zurück (Beispiel 2) IS_BLACKLEVEL_CMD_GET_MODE Gibt den aktuellen Blacklevel-Modus zurück (Beispiel 2) IS_BLACKLEVEL_CMD_SET_MODE Setzt den Blacklevel-Modus (Beispiel 2) •IS_AUTO_BLACKLEVEL_OFF: Der automatische Blacklevel wird ausgeschaltet. •IS_AUTO_BLACKLEVEL_ON: Der automatische Blacklevel wird eingeschaltet. IS_BLACKLEVEL_CMD_GET_OFFSET_DEFAULT Gibt den Standard-Offset zurück (Beispiel 3) IS_BLACKLEVEL_CMD_GET_OFFSET_RANGE Gibt den Einstellbereich des Offsets zurück (Beispiel 3) IS_BLACKLEVEL_CMD_GET_OFFSET Gibt den aktuellen Offset zurück (Beispiel 3) IS_BLACKLEVEL_CMD_SET_OFFSET Setzt den Offset (Beispiel 3)
pParam	Zeiger auf Funktionsparameter, der abhängig von nCommand unterschiedlich belegt ist.
cbSizeOfParam	Größe des Speicherbereichs in Byte, auf den pParam verweist.

Rückgabewert

Beispiel 1

INT nBlacklevelCaps;

nRet = is_Blacklevel(hCam, IS_BLACKLEVEL_CMD_GET_CAPS,

                  (void*)&nBlacklevelCaps, sizeof(nBlacklevelCaps) );

if (nRet == IS_SUCCESS) {

// The user can changed the state of the auto blacklevel

BOOL bSetAutoBlacklevel = (nBlacklevelCaps & IS_BLACKLEVEL_CAP_SET_AUTO_BLACKLEVEL) != 0;

// the user can change the offset

BOOL bSetBlacklevelOffset = (nBlacklevelCaps & IS_BLACKLEVEL_CAP_SET_OFFSET) != 0;

}

Beispiel 2

INT nMode = IS_AUTO_BLACKLEVEL_OFF;

// Get default blacklevel mode

INT nRet = is_Blacklevel(hCam, IS_BLACKLEVEL_CMD_GET_MODE_DEFAULT, (void*)&nMode, sizeof(nMode));

// Get current blacklevel mode

nRet = is_Blacklevel(hCam, IS_BLACKLEVEL_CMD_GET_MODE, (void*)&nMode, sizeof(nMode));

// Set new mode (enable auto blacklevel)

nMode = IS_AUTO_BLACKLEVEL_ON;

nRet = is_Blacklevel(hCam, IS_BLACKLEVEL_CMD_SET_MODE, (void*)&nMode , sizeof(nMode ));

Beispiel 3

INT nOffset = 0;

// Get default blacklevel offset

INT nRet = is_Blacklevel(hCam, IS_BLACKLEVEL_CMD_GET_OFFSET_DEFAULT,

                        (void*)&nOffset, sizeof(nOffset));

// Get offset range

IS_RANGE_S32 nRange;

nRet = is_Blacklevel(hCam, IS_BLACKLEVEL_CMD_GET_OFFSET_RANGE, (void*)&nRange, sizeof(nRange));

INT nOffsetMin = nRange.s32Min;

INT nOffsetMax = nRange.s32Max;

INT nOffsetInc = nRange.s32Inc;

// Get current blacklevel offset

nRet = is_Blacklevel(hCam, IS_BLACKLEVEL_CMD_GET_OFFSET, (void*)&nOffset, sizeof(nOffset));

// Set new offset

nOffset = 100;

nRet = is_Blacklevel(hCam, IS_BLACKLEVEL_CMD_SET_OFFSET, (void*)&nOffset, sizeof(nOffset));