Home > C: Programming > Function Descriptions > History back  Previous chapter  Next chapter  Print  

is_SetHdrKneepoints

uEye Camera Manual Version 3.80

is_SetHdrKneepoints

Windows_Logo

Linux_Logo

USB 2.0

GigE

USB 2.0

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 HDR Sensor Principles chapter.

Hinweis

HDR mode is only supported by sensors of the UI-122x/522x camera models.

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_SUCCESS

Function executed successfully

IS_NO_SUCCESS

General error message

IS_NOT_SUPPORTED

Unsupported sensor

Related Functions

is_EnableHdr()
is_GetHdrMode()
is_GetHdrKneepointInfo()
is_GetHdrKneepoints()

Sample Programs

uEyeC# Hdr Demo (C#)

Suggestion for improvement? Send us your short Feedback on this chapter. Thank you very much!


© 2010 IDS Imaging Development Systems GmbH
http://www.ids-imaging.com