Please enable JavaScript to view this site.

IDS Software Suite 4.96.1

Windows_Logo
Linux_Logo

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.

hint_info

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

is_EnableHdr()

is_GetHdrMode()

is_GetHdrKneepointInfo()

is_GetHdrKneepoints()

© 2022 IDS Imaging Development Systems GmbH