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: JPEG-Kompression setzen. Die JPEG-Kompression wird über is_SetColorConverter() aktiviert/deaktiviert.

Hinweis: In Verbindung mit der aktivierten JPEG-Kompression kann das Farbformat "Mono8" nicht ausgewählt werden.

Ü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_GET_JPEG_COMPRESSION_DEFAULT Gibt den Standardwert für die JPEG-Kompression zurück. Der Standardwert ist 2 (Beispiel). IS_DEVICE_FEATURE_CMD_GET_JPEG_COMPRESSION_RANGE Gibt den Wertebereich für die JPEG-Kompression zurück (1…9). Je höher der Wert ist, desto stärker werden die Bilddaten komprimiert. IS_DEVICE_FEATURE_CMD_GET_JPEG_COMPRESSION Gibt die aktuelle Einstellung für die JPEG-Kompression zurück. IS_DEVICE_FEATURE_CMD_SET_JPEG_COMPRESSION Setzt den Wert für die JPEG-Kompression.
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

/* Get capabilities */
INT nRet = 0;
INT nSupported = 0;
nRet = is_DeviceFeature(hCam, IS_DEVICE_FEATURE_CMD_GET_SUPPORTED_FEATURES, (void*)&nSupported, sizeof(nSupported));
if ((nRet == IS_SUCCESS) && (nSupported & IS_DEVICE_FEATURE_CAP_JPEG_COMPRESSION) == IS_DEVICE_FEATURE_CAP_JPEG_COMPRESSION)
{
…
}
 
/* Get compression range */
INT nRet = 0;
IS_RANGE_S32 rangeJpeg;
nRet = is_DeviceFeature(hCam, IS_DEVICE_FEATURE_CMD_GET_JPEG_COMPRESSION_RANGE, (void*)&rangeJpeg, sizeof(rangeJpeg));
 
/* Set compression */
INT nRet = 0;
INT nValue = 2;
nRet = is_DeviceFeature(hCam, IS_DEVICE_FEATURE_CMD_SET_JPEG_COMPRESSION, (void*)&nValue, sizeof(nValue));
 
/* Get the current compression */
INT nRet = 0;
INT nValue = 0;
nRet = is_DeviceFeature(hCam, IS_DEVICE_FEATURE_CMD_GET_JPEG_COMPRESSION, (void*)&nValue, sizeof(nValue));