TImageEnProc.CalcAverageRGB

Declaration

function CalcAverageRGB(SampleCount : Integer = 0): TRGB;

Description

Return the average RGB values of the selection.

If iSampleCount = 0 the entire image is analyzed. To speed up processing you can sample a smaller number of points, e.g. 100.
You can also get a sample of the border color by specifying -9 (returns the average of the four corners of the image plus four border midpoints - ignoring any selection).

Note: If the image PixelFormat is not ie24RGB, it will be converted

Demo

Demos\ImageEditing\EveryMethod\EveryMethod.dpr

Examples

// Load test image
ImageEnView1.IO.LoadFromFile( 'D:\TestImage.jpg' );

// Return the average RGB values of the selection (with sample size of 100)
rgb := ImageEnView1.Proc.CalcAverageRGB( 100 );
s := format( 'Average RGB: %d, %d, %d', [ rgb.r, rgb.g, rgb.b ]);

ImageTest1.jpg: Average RGB: 138, 106, 86
ImageTest2.jpg: Average RGB: 245, 218, 144
ImageTest3.jpg: Average RGB: 102, 91, 82

// Guess the border color
rgb := ImageEnView1.Proc.CalcAverageRGB( -9 );

TImageEnProc.CalcAverageRGB