IDS Software Suite 4.96.1
 |
 |
|---|---|
USB 3 uEye CP Rev. 2 GigE |
USB 3 uEye CP Rev. 2 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:
•USB 3 uEye CP Rev. 2: You can query the temperature state of the camera. Temperature status monitoring is important for the camera's internal image memory (see Using the internal image memory).
•GigE uEye CP Rev. 2/GigE uEye FA/GigE uEye SE Rev. 4: You can query the temperature state of the camera.
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.
Fig. 198: Temperature state of USB 3 uEye CP Rev. 2
Fig. 199: Temperature state of GigE uEye CP Rev. 2/FA/SE Rev. 4
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_TEMPERATURE_STATUS |
Monitoring the temperature state is supported. The following message are possible: •0 = TEMPERATURE_CONTROL_STATUS_NORMAL •1 = TEMPERATURE_CONTROL_STATUS_WARNING •2 = TEMPERATURE_CONTROL_STATUS_CRITICAL |
Related functions
•Using the internal image memory
// Is monitoring the temperature status supported?
INT nFeatures = 0;
is_DeviceFeature(hCam, IS_DEVICE_FEATURE_CMD_GET_SUPPORTED_FEATURES, &nFeatures, sizeof(nFeatures));
if ((nFeatures & IS_DEVICE_FEATURE_CAP_TEMPERATURE_STATUS) == IS_DEVICE_FEATURE_CAP_TEMPERATURE_STATUS)
{
…
}
// Query the temperarture status
INT nTemperatureStatus = 0;
is_DeviceFeature(hCam, IS_DEVICE_FEATURE_CMD_GET_TEMPERATURE_STATUS, &nTemperatureStatus, sizeof(nTemperatureStatus));
if (nTemperatureStatus == TEMPERATURE_CONTROL_STATUS_CRITICAL)
{
…
}
else if (nTemperatureStatus == TEMPERATURE_CONTROL_STATUS_WARNING)
{
…
}
else if (nTemperatureStatus == TEMPERATURE_CONTROL_STATUS_NORMAL)
{
…
}
