USB uEye XS	USB uEye XS

Syntax

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

Beschreibung

Mit is_DeviceFeature() können kameraspezifische Funktionen einiger uEye-Modelle konfiguriert werden:

•USB uEye XS: Bildeffekte verwenden, siehe USB uEye XS öffnen

Ü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_DEVICE_FEATURE_CMD_SET_IMAGE_EFFECT Setzt einen Bildeffekt (Beispiel): •IS_IMAGE_EFFECT_DISABLE: Deaktiviert den Bildeffekt •IS_IMAGE_EFFECT_SEPIA: Aktiviert den Sepia-Bildeffekt •IS_IMAGE_EFFECT_MONOCHROME: Aktiviert den Monochrom-Bildeffekt •IS_IMAGE_EFFECT_NEGATIVE: Aktiviert den Negativ-Bildeffekt •IS_IMAGE_EFFECT_CROSSHAIRS: Aktiviert das Fadenkreuz IS_DEVICE_FEATURE_CMD_GET_IMAGE_EFFECT Gibt den aktuellen Bildeffekt zurück. IS_DEVICE_FEATURE_CMD_GET_IMAGE_EFFECT_DEFAULT Gibt die Standardeinstellung zurück.
pParam	Zeiger auf Funktionsparameter, der abhängig von nCommand unterschiedlich belegt ist.
cbSizeOfParam	Größe des Speicherbereichs in Byte, auf den pParam verweist.

Statusflags aus DEVICE_FEATURE_MODE_CAPS

Beispiel

/* Set image effect to sepia */
INT nImageEffect = IS_IMAGE_EFFECT_SEPIA;
nRet = is_DeviceFeature(hCam, IS_DEVICE_FEATURE_CMD_SET_IMAGE_EFFECT, (void*)&nImageEffect, sizeof(nImageEffect));
 
/* receive the current image effect */
nRet = is_DeviceFeature(hCam, IS_DEVICE_FEATURE_CMD_GET_IMAGE_EFFECT, (void*)&nImageEffect, sizeof(nImageEffect));
 
/* receive the default image effect */
nRet = is_DeviceFeature(hCam, IS_DEVICE_FEATURE_CMD_GET_IMAGE_EFFECT_DEFAULT, (void*)&nImageEffect, sizeof(nImageEffect));
 
/* disable the image effect */
INT nImageEffect = IS_IMAGE_EFFECT_DISABLE;
nRet = is_DeviceFeature(hCam, IS_DEVICE_FEATURE_CMD_SET_IMAGE_EFFECT, (void*)&nImageEffect, sizeof(nImageEffect));