Please enable JavaScript to view this site.

IDS Software Suite 4.96.1

Navigation: C: Programming > Function descriptions > is_Exposure

Exposure time with fine increments

Scroll Previous Top Next More
Windows_Logo
Linux_Logo

USB 2.0

USB 3.x

GigE

USB 2.0

USB 3.x

GigE

Syntax

INT is_Exposure (HIDS hCam, UINT nCommand, void* pParam, UINT cbSizeOfParam)

Description

Using is_Exposure() you can query the exposure time ranges with fine increment available in your camera, and set new exposure times.

hint_info

Note on dependencies on other settings

The use of the following functions will affect the exposure time:

is_PixelClock()

is_SetOptimalCameraTiming()

is_SetFrameRate()

is_AOI() (if the image size is changed)

is_SetSubSampling()

is_SetBinning()

Changes made to the image size, the frame rate or the pixel clock frequency also affect the exposure time. For this reason, you need to call is_Exposure() again after such changes.

hint_info

Note on new driver versions

Newer driver versions sometimes allow an extended value range for the exposure time setting. We recommend querying the value range every time and set the exposure time explicitly.

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.

Example 1

double dblMin, dblMax, dblInc;
 
INT nRet = is_Exposure(m_hCam, IS_EXPOSURE_CMD_GET_FINE_INCREMENT_RANGE_MIN,
                      (void*)&dblMin, sizeof(dblMin));
 
INT nRet = is_Exposure(m_hCam, IS_EXPOSURE_CMD_GET_FINE_INCREMENT_RANGE_MAX,
                      (void*)&dblMax, sizeof(dblMax));
 
INT nRet = is_Exposure(m_hCam, IS_EXPOSURE_CMD_GET_FINE_INCREMENT_RANGE_INC,
                      (void*)&dblInc, sizeof(dblInc));

Example 2

double dblRange[3];
double dblMin, dblMax, dblInc;
 
INT nRet = is_Exposure(m_hCam, IS_EXPOSURE_CMD_GET_FINE_INCREMENT_RANGE,
                      (void*)dblRange, sizeof(dblRange));
 
if (nRet == IS_SUCCESS)
{
  dblMin = dblRange[0];
  dblMax = dblRange[1];
  dblInc = dblRange[2];
}

© 2022 IDS Imaging Development Systems GmbH