Please enable JavaScript to view this site.

uEye .NET Manual 4.97

The Exposure class provides methods for controlling the exposure of a uEye camera.

hint_info

Note on dependencies on other settings

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

PixelClock

Optimal()

Framerate

AOI (if the image size is changed)

Subsampling

Binning

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 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.

Applying new settings

In freerun mode, any modification of the exposure time will only become effective when the image after next is captured. In trigger mode, the modification will be applied to the next image.

Accuracy of the exposure time setting

The increments for setting the exposure time depend on the sensor's current timing settings (pixel clock, frame rate). The smallest increment usually corresponds to the duration of one pixel row, which is the time it takes the sensor to read out one pixel row.

You can query the actual exposure time setting with Get().

Some sensors allow setting the exposure time in smaller increments. Using GetSupported(), you can check whether your sensor supports these methods.

For minimum and maximum exposure times as well as other sensor-based dependencies, please refer to the "Camera and sensor data" chapter in the uEye manual.

Rounding errors from increments

When calculating a new exposure time based on the returned increment, note that calculations with floating point values in the PC will always be subject to rounding errors. Therefore, an addition or subtraction of the increment value might not always produce the exact desired result. In this case, the uEye API rounds down the floating point value and sets the exposure time to the next lower value.

You can avoid this behavior by additionally adding the value INCREMENT/2.f (half increment) when calculating with the increment. This ensures that the desired value will be set even after rounding.

The following classes and methods exist:

Dual

Fine

Long

Methods

Method

Description

Get

Returns the currently set exposure time (in ms).

GetDefault

Returns the default setting for the exposure time.

GetRange

Returns the exposure time range.

GetSupported

Returns the if the exposure time is supported.

Set

Sets the exposure time.