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