USB 2.0 USB 3.0 GigE	USB 2.0 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:

•On the models UI-124x/UI-324x/UI-524x and UI-125x/UI-325x/UI-525x: Toggle between shutter modes, see Basics: Shutter methods.

•On the models UI-148x/UI-348x/UI-548x, UI-158x/UI-358x/UI-558x, UI-359xCP Rev. 2, UI-359xLE Rev. 2, UI-386x/UI-586x and UI-388x/UI-588x: Enables the global start shutter function. For further information on the global start shutter mode, please refer to the Camera basics: Shutter methods chapter.

The global start shutter function is only supported in trigger mode (see also is_SetExternalTrigger()).

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_SET_SHUTTER_MODE Sets the shutter mode, see DEVICE_FEATURE_MODE_CAPS IS_DEVICE_FEATURE_CMD_GET_SHUTTER_MODE Returns the shutter mode
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 1

// Query current settings
INT nShutterMode = IS_DEVICE_FEATURE_CAP_SHUTTER_MODE_ROLLING;
nRet = is_DeviceFeature(m_hCam, IS_DEVICE_FEATURE_CMD_GET_SHUTTER_MODE, (void*)&nShutterMode, sizeof(nShutterMode));

Example 2

// Define new settings
INT nShutterMode = IS_DEVICE_FEATURE_CAP_SHUTTER_MODE_ROLLING;
nRet = is_DeviceFeature(m_hCam, IS_DEVICE_FEATURE_CMD_SET_SHUTTER_MODE, (void*)&nShutterMode, sizeof(nShutterMode));