Please enable JavaScript to view this site.

IDS Software Suite 4.96.1

Windows_Logo
Linux_Logo

USB 3 uEye CP Rev. 2

USB 3 uEye CP Rev. 2

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: Enable or disable the image memory of the camera.

hint_info

From IDS Software Suite 4.81 on, the camera is operated with active image memory by default. Deactivation of the image memory is not possible any more. See IDS Camera Manager: Camera information.

If you check the "Compatibility mode" option, you can disable the internal image memory again. This corresponds to the camera behavior up to and including IDS Software Suite 4.80.2.

Note that the camera has to be closed if you enable or disable the image memory.

For some USB 3 uEye cameras, you must activate the image memory to operate them on a USB 2.0 port, see Camera and sensor data.

If the image memory is activated the cameras can be operated with a higher pixel clock and frame rate. Temporary CPU loads are therefore compensated.

Note that higher camera pixel clocks causes a higher power consumption. Therefore, provide sufficient heat dissipation, see Ambient conditions USB 3 uEye CP Rev. 2.

hint_info

Hint: Note that from driver version 4.80 on the internal image memory can only be enabled or disabled when the device ID and not the camera handle is used for calling. Please refer to the Application Note on our website for more information on this topic.

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_MEMORY_MODE

Internal image memory is supported.

Related functions

Querying the temperature state

is_Event()

is_EnableMessage()

Example 1

// Is using the image memory supported?
// Via camera handle
int nMemoryMode;
nRet = is_DeviceFeature(hCam, IS_DEVICE_FEATURE_CMD_GET_MEMORY_MODE_ENABLE_SUPPORTED, &nMemoryMode, sizeof(nMemoryMode));
if (nMemoryMode == IS_MEMORY_MODE_ON)
{
// is supported...
}
 
// Is using the image memory supported?
// Via device ID
int nMemoryMode;
nRet = is_DeviceFeature(nDevID | IS_USE_DEVICE_ID, IS_DEVICE_FEATURE_CMD_GET_MEMORY_MODE_ENABLE_SUPPORTED, &nMemoryMode, sizeof(nMemoryMode));
if (nMemoryMode == IS_MEMORY_MODE_ON)
{
// is supported...
}

Example 2

// Enable memory mode, device ID must be used for this purpose
UINT nEnable = IS_MEMORY_MODE_ON;
INT nRet = is_DeviceFeature(nDevID | IS_USE_DEVICE_ID, IS_DEVICE_FEATURE_CMD_SET_MEMORY_MODE_ENABLE, (void*)&nEnable, sizeof(nEnable));

Example 3

// Query the status of the image memory via camera handle
int nMemoryMode;
nRet = is_DeviceFeature(hCam, IS_DEVICE_FEATURE_CMD_GET_MEMORY_MODE_ENABLE, &nMemoryMode, sizeof(nMemoryMode));
if (nMemoryMode == IS_MEMORY_MODE_ON)
{

}
 
// Query the status of the image memory via device ID
int nMemoryMode;
nRet = is_DeviceFeature(nDevID | IS_USE_DEVICE_ID, IS_DEVICE_FEATURE_CMD_GET_MEMORY_MODE_ENABLE, &nMemoryMode, sizeof(nMemoryMode));
if (nMemoryMode == IS_MEMORY_MODE_ON)
{

}

Example 4

// Query the default setting for the image memory via camera handle
int nMemoryMode;
nRet = is_DeviceFeature(hCam, IS_DEVICE_FEATURE_CMD_GET_MEMORY_MODE_ENABLE_DEFAULT, &nMemoryMode, sizeof(nMemoryMode));
if (nMemoryMode == IS_MEMORY_MODE_ON)
{

}
 
// Query the default setting for the image memory via device ID
int nMemoryMode;
nRet = is_DeviceFeature(nDevID | IS_USE_DEVICE_ID, IS_DEVICE_FEATURE_CMD_GET_MEMORY_MODE_ENABLE_DEFAULT, &nMemoryMode, sizeof(nMemoryMode));
if (nMemoryMode == IS_MEMORY_MODE_ON)
{

}

© 2022 IDS Imaging Development Systems GmbH