IDS Software Suite 4.96.1
 |
 |
|---|---|
USB 3.x GigE |
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:
•Enable/disable the use of the level controlled trigger, see uEye Cockpit: Advanced features
|
The level controlled trigger is currently supported by the following models: •UI-300x •UI-304x •UI-306x •UI-307x •UI-308x •UI-309x •UI-320x/UI-520x •UI-326x/UI-526x •UI-327x/UI-527x •UI-328x/UI-528x •UI-329x/UI-529x Note that the level-controlled trigger is not supported by the uEye LE camera families. |
By using the level-controlled trigger, you can control the exposure time directly via the duration of the trigger signal.
|
The level controlled trigger cannot be used in combination with the software trigger mode, trigger prescaler, or the IDS line scan ("AOI merge mode"). |
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_LEVEL_CONTROLLED_TRIGGER |
The use of the level controlled trigger is supported. |
/* Query the current settings */
INT nMode = IS_LEVEL_CONTROLLED_TRIGGER_INPUT_OFF;
INT nRet = is_DeviceFeature(hCam, IS_DEVICE_FEATURE_CMD_GET_LEVEL_CONTROLLED_TRIGGER_INPUT_MODE,
(void*)&nMode, sizeof(nMode));
if (IS_SUCCESS == nRet)
{
if (IS_LEVEL_CONTROLLED_TRIGGER_INPUT_OFF == nMode)
{
/* Level controlled trigger is disabled */
}
else if (IS_LEVEL_CONTROLLED_TRIGGER_INPUT_ON == nMode)
{
/* Level controlled trigger is enabled */
}
}
/* Enable level controlled trigger */
nMode = IS_LEVEL_CONTROLLED_TRIGGER_INPUT_ON;
nRet = is_DeviceFeature(hCam, IS_DEVICE_FEATURE_CMD_SET_LEVEL_CONTROLLED_TRIGGER_INPUT_MODE,
(void*)&nMode, sizeof(nMode));
if (IS_SUCCESS == nRet)
{
/* Level controlled trigger is enabled */
}
/* Get default setting */
nRet = is_DeviceFeature(hCam,
IS_DEVICE_FEATURE_CMD_GET_LEVEL_CONTROLLED_TRIGGER_INPUT_MODE_DEFAULT,
(void*)&nMode, sizeof(nMode));
if (IS_SUCCESS == nRet)
{
/* nMode returns the default setting */
}
