BalanceRatioRaw
Top  Previous  Next

Description

Returns or sets the ratio (amplification factor) of the selected color component in relative units. Used for white balancing. This property is deprecated and replaced by BalanceRatio.


Syntax


[VB]
objActiveGige.BalanceRatioRaw [= Value]


[C/C++]
HRESULT get_BalanceRatioRaw( long *pValue );
HRESULT put_BalanceRatioRaw( long Value );



Data Type
[VB]

Integer

Parameters
[C/C++]

pValue [out,retval]  
Pointer to the white balance ratio  
Value [in]  
The white balance ratio 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 adjusts white balance factors for different color channels:

ActiveGige1.BalanceRatioSelector="Red"
ActiveGige1.BalanceRatioRaw = 12
ActiveGige1.BalanceRatioSelector="Green"
ActiveGige1.BalanceRatioRaw = 14
ActiveGige1.BalanceRatioSelector="Blue"
ActiveGige1.BalanceRatioRaw = -10


Remarks


This property changes the ratio of the selected color component relative to the base level of the component. The valid range of the ratio values can be obtained by the GetFeatureMin and GetFeatureMax methods. Before using BalanceRatioRaw, select a corresponding channel with BalanceRatioSelector.

Note that the property is available only if the currently selected camera supports the BalanceRatioRaw feature.