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.
Note on dependencies on other settings The use of the following functions will affect the exposure time: •is_AOI() (if the image size is changed) 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. |
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. |
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));
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];
}