BlackLevelAbs

Description

Returns or sets the absolute value of the camera's black level. This property is deprecated and replaced by BlackLevel.


Syntax

[VB]
objActiveGige.BlackLevelAbs [= Value]

[C/C++]
HRESULT get_BlackLevelAbs( float *pValue );
HRESULT put_BlackLevelAbs( float Value );


Data Type [VB]

Single

Parameters [C/C++]

pValue [out,retval]

Pointer to the current black level value

Value [in]

The black level value to be set

Return Values

S_OK

Success

E_NOINTERFACE

The feature is not available for the selected camera

E_INVALIDARG

The value is out of range

E_FAIL

Failure to set the feature value

Example

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

Private Sub Form_Load()
HScroll1.Value = ActiveGige1.BlackLevelAbs
HScroll1.Min = ActiveGige1.GetFeatureMin ("BlackLevelAbs")
HScroll1.Max = ActiveGige1.GetFeatureMax ("BlackLevelAbs")
ActiveGige1.Acquire=True
End Sub

Private Sub HScroll1_Scroll()
ActiveGige1.BlackLevelAbs = HScroll1.Value
End Sub

Remarks

This property changes the black level of the video by adding a constant amount of luminance to each pixel. The valid property range can be retrieved by the GetFeatureMin and GetFeatureMax methods.

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