BlackLevel
Top  Previous  Next

Description

Returns or sets the absolute or raw value of the camera's black level.


Syntax


[VB]
objActiveUSB.BlackLevel [= Value]


[C/C++]
HRESULT get_BlackLevel( float *pValue );
HRESULT put_BlackLevel( 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 black level value.

Private Sub
 Form_Load()

HScroll1.Value = ActiveUSB1.BlackLevel
HScroll1.Min = ActiveUSB1.GetBlackLevel
HScroll1.Max = ActiveUSB1.GetBlackLevel
ActiveUSB1.Acquire=
True

End Sub


Private Sub
 HScroll1_Scroll()

ActiveUSB1.BlackLevel = 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 GetBlackLevelMin and GetBlackLevelMax methods.

Note that the property is available only if the currently selected camera supports one of the following GenICam features: BlackLevel, BlackLevelAbs, BlackLevelRaw.