BrightnessControl

Description

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

-1 - Off

The brightness control is disabled

0 - Manual

The brightness level is controlled by the value of the Brightness property

1 - Auto

The camera controls the brightness level by itself continuously

2 - One push

The camera sets the optimal brightness level by itself and returns to the manual mode

Syntax

[VB]
objActiveDcam.BrightnessControl [= Value]

[C/C++]
HRESULT get_BrightnessControl( short *pBrightnessControl );
HRESULT put_BrightnessControl( short BrightnessControl );


Data Type [VB]

Integer

Parameters [C/C++]

pBrightnessControl [out, retval]

Pointer to the current brightness control mode

BrightnessControl [in]

The brightness control mode to be set

Return Values

S_OK

Success

E_FAIL

The brightness control is not available for the selected camera

Example

The following VB example demonstrates the use of a checkbox to switch between the manual and automatic brightness control.

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

Remarks

The property is available only if the currently selected camera supports automatic brightness control.