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

•Querying and setting the timestamp configuration

Note: This function is supported by the following camera families: •USB 3 uEye CP Rev. 2 •GigE uEye CP Rev. 2 •GigE uEye CP •GigE uEye FA •GigE uEye LE •GigE uEye RE PoE •GigE uEye SE Rev. 4 •GigE uEye SE

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_TIMESTAMP_CONFIGURATION Returns the current configuration of the timestamp (Example) IS_DEVICE_FEATURE_CMD_SET_TIMESTAMP_CONFIGURATION Sets the new configuration of the timestamp
pParam	Pointer to a function parameter, whose function depends on nCommand.
cbSizeOfParam	Size (in bytes) of the memory area to which pParam refers.

Contents of the IS_TIMESTAMP_CONFIGURATION structure

Status flags from DEVICE_FEATURE_MODE_CAPS

Example

IS_TIMESTAMP_CONFIGURATION timestampConfiguration;
 
/* Returns the current timestamp configuration */
nRet = is_DeviceFeature(hCam, IS_DEVICE_FEATURE_CMD_GET_TIMESTAMP_CONFIGURATION,
                       (void*) &timestampConfiguration, sizeof(timestampConfiguration));
 
/* A falling edge on the trigger pin will reset the device timestamp once. All 3 parameters will be set at the same time */
timestampConfiguration.s32Mode = IS_RESET_TIMESTAMP_ONCE;
timestampConfiguration.s32Edge = TIMESTAMP_CONFIGURATION_EDGE_FALLING; timestampConfiguration.s32Pin = TIMESTAMP_CONFIGURATION_PIN_TRIGGER;
nRet = is_DeviceFeature(hCam, IS_DEVICE_FEATURE_CMD_SET_TIMESTAMP_CONFIGURATION,
                       (void*) &timestampConfiguration, sizeof(timestampConfiguration));
 
/* Set only the edge */
timestampConfiguration.s32Mode = IS_IGNORE_PARAMETER;
timestampConfiguration.s32Edge = TIMESTAMP_CONFIGURATION_EDGE_RISING;
timestampConfiguration.s32Pin = IS_IGNORE_PARAMETER;
nRet = is_DeviceFeature(hCam, IS_DEVICE_FEATURE_CMD_SET_TIMESTAMP_CONFIGURATION,
                       (void*)&timestampConfiguration, sizeof(timestampConfiguration));
 
/* Set only the pin */
timestampConfiguration.s32Mode = IS_IGNORE_PARAMETER;
timestampConfiguration.s32Edge = IS_IGNORE_PARAMETER;
timestampConfiguration.s32Pin = TIMESTAMP_CONFIGURATION_PIN_GPIO_1;
nRet = is_DeviceFeature(hCam, IS_DEVICE_FEATURE_CMD_SET_TIMESTAMP_CONFIGURATION,
                       (void*)&timestampConfiguration, sizeof(timestampConfiguration));
 
/* Set only the mode */
timestampConfiguration.s32Mode = IS_RESET_TIMESTAMP_ONCE;
timestampConfiguration.s32Edge = IS_IGNORE_PARAMETER;
timestampConfiguration.s32Pin = IS_IGNORE_PARAMETER;
nRet = is_DeviceFeature(hCam, IS_DEVICE_FEATURE_CMD_SET_TIMESTAMP_CONFIGURATION,
                       (void*)&timestampConfiguration, sizeof(timestampConfiguration));