Please enable JavaScript to view this site.

IDS Software Suite 4.96.1

Windows_Logo
Linux_Logo

USB 2.0

USB 3.x

GigE

USB 2.0

USB 3.x

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.

hint_info

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

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_SHUTTER_MODE_ROLLING

Rolling shutter mode is supported/Set mode

IS_DEVICE_FEATURE_CAP_SHUTTER_MODE_ROLLING_GLOBAL_START

Rolling shutter mode with global start is supported/Set mode

IS_DEVICE_FEATURE_CAP_SHUTTER_MODE_GLOBAL

Global shutter mode is supported/Set mode

IS_DEVICE_FEATURE_CAP_SHUTTER_MODE_GLOBAL_ALTERNATIVE_TIMING

Global shutter mode with different timing parameters is supported/Set mode

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

© 2022 IDS Imaging Development Systems GmbH