GainControl

Description

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

-1 - Off

The gain control is disabled

0 - Manual

The gain level is controlled by the value of the Gain property

1 - Auto

The camera controls the gain level by itself continuously

2 - One push

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

Syntax

[VB]
objActiveDcam.GainControl [= Value]

[C/C++]
HRESULT get_GainControl( short *pGainControl );
HRESULT put_GainControl( short GainControl );


Data Type [VB]

Integer

Parameters [C/C++]

pGainControl [out, retval]

Pointer to the current gain control mode

GainControl [in]

The gain control mode to be set

Return Values

S_OK

Success

E_FAIL

The gain 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 gain control.

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

Remarks

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