BlackLevelAuto

Description

Returns or sets the automatic black level control mode. Can be one of the following values:

"Off"

Black level is manually controlled using BlackLevelRaw or BlackLevelAbs

"Once"

The camera sets the optimal black level and returns to the "Off" state

"Continuous"

The camera constantly adjusts the black level

Syntax

[VB]
objActiveGige.BlackLevelControl [= Value]

[C/C++]
HRESULT get_BlackLevelAuto( bstr *pValue );
HRESULT put_BlackLevelAuto( bstr Value );


Data Type [VB]

String

Parameters [C/C++]

pValue [out, retval]

Pointer to the string specifying the black level control mode

Value [in]

The black level control mode to be set

Return Values

S_OK

Success

E_NOINTERFACE

The feature is not available for the selected camera

E_INVALIDARG

The value is not part of the enumerated set

E_FAIL

Failure to set the feature value

Example

The following VB example demonstrates the use of a check box to switch between the manual and automatic black level control.

Private Sub Check1_Click()
If Check1.Value = 1 Then
ActiveGige1.BlackLevelAuto = "On"
Else
ActiveGige1.BlackLevelAuto = "Off"
End If
End Sub

Remarks

Depending on a camera model, other device-specific values may be available for this feature. The list of valid values can be retrieved using GetEnumList.

Note that the property is available only if the currently selected camera supports the BlackLevelAuto feature per GenICam standard.