USB uEye XS	USB uEye XS

Syntax

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

Description

Using is_DeviceFeature() you can configure special camera functions provided by specific uEye models:

•USB uEye XS: Set JPEG compression. The JPEG compression is enabled/disabled by is_SetColorConverter().

Note: If the JPEG compression is active, the color format "Mono8" cannot be selected.

The nCommand input parameter is used to select the function mode. The pParam input parameter depends on the selected function mode. If you select functions for setting or returning a value, pParam contains a pointer to a variable of the UINT type. The size of the memory area to which pParam refers is specified in the cbSizeOfParam input parameter.

Input parameters

hCam	Camera handle
nCommand IS_DEVICE_FEATURE_CMD_GET_JPEG_COMPRESSION_DEFAULT Returns the default value for the JPEG compression. The default value is 2 (Example). IS_DEVICE_FEATURE_CMD_GET_JPEG_COMPRESSION_RANGE Returns the range for the JPEG compression (1…9). The higher the value, the more the image data is compressed. IS_DEVICE_FEATURE_CMD_GET_JPEG_COMPRESSION Returns the current value of the JPEG compression. IS_DEVICE_FEATURE_CMD_SET_JPEG_COMPRESSION Sets the value for the JPEG compression.
pParam	Pointer to a function parameter, whose function depends on nCommand.
cbSizeOfParam	Size (in bytes) of the memory area to which pParam refers.

Status flags from DEVICE_FEATURE_MODE_CAPS

Example

/* 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));