Back to FabImage Library website

You are here: Start » Function Reference » Image » Image Enhancement » NormalizeLocalBrightness_Gauss

NormalizeLocalBrightness_Gauss


Header: FIL.h
Namespace: fil
Module: FoundationBasic

Normalizes local brightness of the image. Internally uses Gauss smoothing.

Applications: Compensates uneven illumination.

Syntax

C++
C#
 
void fil::NormalizeLocalBrightness_Gauss
(
	const fil::Image& inImage,
	ftl::Optional<const fil::Region&> inRoi,
	float inStdDevX,
	ftl::Optional<float> inStdDevY,
	float inTargetMean,
	float inGammaValue,
	fil::Image& outImage
)

Parameters

Name Type Range Default Description
Input value inImage const Image& Input image
Input value inRoi Optional<const Region&> NIL Range of pixels to be processed
Input value inStdDevX float 0.0 - 5.0f Horizontal smoothing standard deviation
Input value inStdDevY Optional<float> 0.0 - NIL Vertical smoothing standard deviation
Input value inTargetMean float 128.0f Target mean brightness
Input value inGammaValue float 0.01 - 8.0 1.0f Gamma coefficient, where 1.0 is neutral
Output value outImage Image& Output image

Description

This filter normalizes every pixels brightness to inTargetMean based on a local average calculated using SmoothImage_Gauss passing to it parameters inStdDevX and inStdDevY.

Gamma correction can be performed on the image before normalization through the inGammaValue parameter.

Examples

Example image

Output of NormalizeLocalBrightness_Gauss

Hardware Acceleration

This operation supports automatic parallelization for multicore and multiprocessor systems.

See Also

  • NormalizeImage – Rescales an image linearly, so that its minimum becomes inNewMinimum and the maximum of the remaining pixels becomes inNewMaximum.