AutoExposure

Description

Returns or sets the auto exposure control mode. The values from -1 to 2 correspond to the following modes:

-1 - Off

The auto exposure control is disabled

0 - Manual

The auto exposure reference level is controlled by the value of the AutoExposureRef property

1 - Auto

The camera controls the auto exposure reference level by itself continuously

2 - One push

The camera sets the optimal auto exposure reference level by itself and returns to the manual mode

Syntax

[VB]
objActiveDcam.AutoExposure [= Value]

[C/C++]
HRESULT get_AutoExposure( bool *pAutoExposure );
HRESULT put_AutoExposure( bool AutoExposure );


Data Type [VB]

Integer

Parameters [C/C++]

pAutoExposure [out, retval]

Pointer to the current auto exposure control mode

AutoExposure [in]

The auto exposure control mode to be set

Return Values

S_OK

Success

E_FAIL

The auto exposure control is not available for the selected camera

Example

The following VB example demonstrates the use of a checkbox to activate the auto exposure mode

Private Sub Check1_Click()
If Check1.Value = 1 Then
ActiveDcam1.AutoExposure = 1
Else
ActiveDcam1.AutoExposure = 0
End If
End Sub

Remarks

When the auto exposure mode is activated, the camera will automatically control the exposure by keeping Shutter, Gain and/or Iris at optimal levels. The property is available only if the currently selected camera supports auto exposure control. The reference value for auto exposure can be adjusted by AutoExposureRef.

Note that for some cameras based on older chipsets (DCAM 1.20) the auto exposure feature controls the shutter speed.