USB 2.0 USB 3.x GigE |
USB 2.0 USB 3.x GigE |
Syntax
INT is_SetHdrKneepoints (HIDS hCam, KNEEPOINTARRAY* KneepointArray, INT KneepointArraySize)
Description
Using is_SetHdrKneepoints(), you can define settings for the HDR mode (high dynamic range) which is supported by some sensors. You can enable/disable HDR mode by calling is_EnableHdr().
For further information on HDR mode, please refer to the Kneepoint HDR sensors chapter.
The HDR mode with knee points is only supported by the models UI-122x/UI-322x/UI-522x, UI-313xCP/UI-513x, and UI-314x/UI-514x. |
Input parameters
hCam |
Camera handle |
KneepointArray |
Pointer to a field (see below). |
Contents of the KNEEPOINTARRAY field
INT NumberOfUsedKneepoints |
Number of knee points used. |
KNEEPOINT Kneepoint[10] |
Knee point |
Contents of the KNEEPOINT structure
double x |
Knee point x value |
double y |
Knee point y value |
The x value of a knee point indicates the first phase of the currently set exposure time (in %). The y value indicates the proportion of maximum pixel intensity in percent. If two knee points are used, you can set two phases in which the images will not be exposed. This means that two corresponding times will be set on the x-axis.
For instance, the effects of setting x = 60, y = 80 would be as follows: The first exposure phase takes up 60 % of the set exposure time. In this first exposure phase, all pixels are exposed up to a maximum of 80 % of the maximum pixel intensity and remain at 80 % until this phase is over. In the second exposure phase, they are exposed again and may reach the full pixel intensity.
Return values
IS_CANT_COMMUNICATE_WITH_DRIVER |
Communication with the driver failed because no driver has been loaded. |
IS_CANT_OPEN_DEVICE |
An attempt to initialize or select the camera failed (no camera connected or initialization error). |
IS_INVALID_CAMERA_HANDLE |
Invalid camera handle |
IS_INVALID_PARAMETER |
One of the submitted parameters is outside the valid range or is not supported for this sensor or is not available in this mode. |
IS_IO_REQUEST_FAILED |
An IO request from the uEye driver failed. Possibly the versions of the ueye_api.dll (API) and the driver file (ueye_usb.sys or ueye_eth.sys) do not match. |
IS_NO_SUCCESS |
General error message |
IS_NOT_SUPPORTED |
The camera model used here does not support this function or setting. |
IS_SUCCESS |
Function executed successfully |
Related functions