USB 3.1 Gen 1 USB 3.0 GigE	USB 3.1 Gen 1 USB 3.0 GigE

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:

•Set analog sensor source gain, see uEye Cockpit: Advanced features

The analog sensor source gain is currently supported by the following models: •UI-300x •UI-304x/UI-504x •UI-307x •UI-308x •UI-309x •UI-313x/UI-513x •UI-314x/UI-514x •UI-316x •UI-318x •UI-320x/UI-520x •UI-327x/UI-527x •UI-328x/UI-528x •UI-329x/UI-529x •UI-336x/UI-536x •UI-337x/UI-537x •UI-386x/UI-586x •UI-388x/UI-588x

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_SENSOR_SOURCE_GAIN_RANGE Returns the range for the sensor source gain. The value may also be negative. Default = 0 (Example) IS_DEVICE_FEATURE_CMD_GET_SENSOR_SOURCE_GAIN_DEFAULT Returns the default value of the sensor source gain. IS_DEVICE_FEATURE_CMD_GET_SENSOR_SOURCE_GAIN Returns the current set sensor source gain IS_DEVICE_FEATURE_CMD_SET_SENSOR_SOURCE_GAIN Sets the sensor source gain
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

INT nGain = 0;
 
/* Get sensor source gain range */
IS_RANGE_S32 rangeSourceGain;
INT nRet = is_DeviceFeature(hCam, IS_DEVICE_FEATURE_CMD_GET_SENSOR_SOURCE_GAIN_RANGE,
                          (void*)&rangeSourceGain, sizeof(rangeSourceGain));
 
if (nRet == IS_SUCCESS)
{
/* Set sensor source gain to max */
nGain = rangeSourceGain.s32Max;
nRet = is_DeviceFeature(hCam, IS_DEVICE_FEATURE_CMD_SET_SENSOR_SOURCE_GAIN,
                        (void*)&nGain, sizeof(nGain));
}
 
/* Get default sensor source gain */
nRet = is_DeviceFeature(hCam, IS_DEVICE_FEATURE_CMD_GET_SENSOR_SOURCE_GAIN_DEFAULT,
                      (void*)&nGain, sizeof(nGain));
 
/* Get the current sensor source gain */
nRet = is_DeviceFeature(hCam, IS_DEVICE_FEATURE_CMD_GET_SENSOR_SOURCE_GAIN,
                      (void*)&nGain, sizeof(nGain));