BalanceRatioSelector
Top  Previous  Next

Description

Returns or sets the color channel to be controlled by BalanceRatio. Used for white balancing and can be one of the following values:

"Red"  
Gain adjustments will be applied to the red channel.  
"Green"  
   Gain adjustments will be applied to the green channel.  
"Blue"  
   Gain adjustments will be applied to the blue channel.  
"Y"  
   Gain adjustments will be applied to Y channel.  
"U"  
   Gain adjustments will be applied to U channel.  
"V"  
   Gain adjustments will be applied to V channel.  
     


Syntax


[VB]
objActiveUSB.BalanceRatioSelector [= Value]


[C/C++]
HRESULT get_BalanceRatioSelector( string *pValue );
HRESULT put_BalanceRatioSelector( string Value );



Data Type
[VB]

String

Parameters
[C/C++]

pValue [out, retval]  
Pointer to the string specifying the current color channel for white balancing  
Value [in]  
The color channel 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 combo box to switch between different white balance channels:

The following VB example adjusts white balance factors for different color channels:

ActiveUSB1.BalanceRatioSelector="Red"
ActiveUSB1.BalanceRatioAbs = 1.2
ActiveUSB1.BalanceRatioSelector="Green"
ActiveUSB1.BalanceRatioAbs = 1.4
ActiveUSB1.BalanceRatioSelector="Blue"
ActiveUSB1.BalanceRatioAbs = 1.
 

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 BalanceRatioSelector feature per GenICam standard.