AutoExposure
Top  Previous  Next

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.