Gray-world white balance algorithm [詳解]

#include <white_balance.hpp>

cv::xphoto::WhiteBalancerを継承しています。

公開メンバ関数
virtual CV_WRAP float	getSaturationThreshold () const =0
	Maximum saturation for a pixel to be included in the gray-world assumption [詳解]

virtual CV_WRAP void	setSaturationThreshold (float val)=0
	Maximum saturation for a pixel to be included in the gray-world assumption [詳解]

基底クラス cv::xphoto::WhiteBalancer に属する継承公開メンバ関数
virtual CV_WRAP void	balanceWhite (InputArray src, OutputArray dst)=0
	Applies white balancing to the input image [詳解]

基底クラス cv::Algorithm に属する継承公開メンバ関数
virtual CV_WRAP void	clear ()
	Clears the algorithm state [詳解]

virtual void	write (FileStorage &fs) const
	Stores algorithm parameters in a file storage [詳解]

CV_WRAP void	write (const Ptr< FileStorage > &fs, const String &name=String()) const
	simplified API for language bindings これはオーバーロードされたメンバ関数です。利便性のために用意されています。元の関数との違いは引き数のみです。

virtual CV_WRAP void	read (const FileNode &fn)
	Reads algorithm parameters from a file storage [詳解]

virtual CV_WRAP bool	empty () const
	Returns true if the Algorithm is empty (e.g. in the very beginning or after unsuccessful read [詳解]

virtual CV_WRAP void	save (const String &filename) const

virtual CV_WRAP String	getDefaultName () const

その他の継承メンバ
基底クラス cv::Algorithm に属する継承静的公開メンバ関数
template<typename _Tp >
static Ptr< _Tp >	read (const FileNode &fn)
	Reads algorithm from the file node [詳解]

template<typename _Tp >
static Ptr< _Tp >	load (const String &filename, const String &objname=String())
	Loads algorithm from the file [詳解]

template<typename _Tp >
static Ptr< _Tp >	loadFromString (const String &strModel, const String &objname=String())
	Loads algorithm from a String [詳解]

基底クラス cv::Algorithm に属する継承限定公開メンバ関数
void	writeFormat (FileStorage &fs) const

詳解

Gray-world white balance algorithm

This algorithm scales the values of pixels based on a gray-world assumption which states that the average of all channels should result in a gray image.

It adds a modification which thresholds pixels based on their saturation value and only uses pixels below the provided threshold in finding average pixel values.

Saturation is calculated using the following for a 3-channel RGB image per pixel I and is in the range [0, 1]:

$\texttt{Saturation} [I] = \frac{\textrm{max}(R,G,B) - \textrm{min}(R,G,B) }{\textrm{max}(R,G,B)}$

A threshold of 1 means that all pixels are used to white-balance, while a threshold of 0 means no pixels are used. Lower thresholds are useful in white-balancing saturated images.

Currently supports images of type CV_8UC3 and CV_16UC3.