AutoExposureRef

Description

Returns or sets the row value of the autoexposure reference


Syntax

[VB]
objActiveDcam.AutoExposureRef [= Value]

[C/C++]
HRESULT get_AutoExposureRef( long *pAutoExposureRef );
HRESULT put_AutoExposureRef( long AutoExposureRef );


Data Type [VB]

Long

Parameters [C/C++]

pAutoExposureRef [out,retval]

Pointer to the current autoexposure reference value

AutoExposureRef [in]

The autoexposure reference value to be set

Return Values

S_OK

Success

E_FAIL

The autoexposure control is not available for the selected camera

E_INVALIDARG

The value is out of range

Example

The following VB example demonstrates the use of a scroll control for real-time adjustment of the autoexposure reference.

Private Sub Form_Load()
ActiveDcam1.Acquire=True
ActiveDcam1.AutoExposure=True
HScroll1.Value = ActiveDcam1.AutoExposureRef
HScroll1.Min = ActiveDcam1.GetExposureMin
HScroll1.Max = ActiveDcam1.GetExposureMax
End Sub

Private Sub HScroll1_Scroll()
ActiveDcam1.AutoExposureRef = HScroll1.Value
End Sub

Remarks

This property changes the reference level used by the camera circuitry in the AutoExposure mode. The valid property range is reported by the GetExposureMin and GetExposureMax methods. Note that the property is available only if the currently selected camera supports the autoexposure control.

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