GainControl
Top  Previous  Next

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.