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 |
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
IS_DEVICE_FEATURE_CAP_JPEG_COMPRESSION |
JPEG compression is supported |
/* 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));