You are here: Start » AVL.NET » Function Reference » Image » Image Point Transforms » AVL.CorrectGamma

AVL.CorrectGamma

Performs gamma correction.

Namespace:AvlNet
Assembly:AVL.NET.dll

Syntax

C++
C#
 
public static void CorrectGamma
(
	AvlNet.Image inImage,
	NullableRef<AvlNet.Region> inRoi,
	float inValue,
	AvlNet.Image outImage
)

Parameters

Name Type Range Default Description
inImageAvlNet.ImageInput image.
inRoiAvlNet.NullableRef<AvlNet.Region>Range of pixels to be processed. Default value: atl::NIL.
inValuefloat<0.01f, 8.0f>2.0fGamma coefficient, where 1.0 is neutral. Default value: 2.0f.
outImageAvlNet.ImageOutput image.

Description

The gamma correction is a standard nonlinear transformation of pixel brightness that was developed as a tool for the compensation of CRT display input-output characteristic. The operation scales brightness of each inImage pixel to the 0.0 - 1.0 range, exponentiates it to the power of inValue, and then scales the result back to the pixel values range.

Examples

The CorrectGamma performed on the sample image with inValue = 2.0 (left image) and inValue = 0.5 (right image).

Hardware Acceleration

This operation supports automatic parallelization for multicore and multiprocessor systems.

Hardware acceleration settings may be manipulated with Settings class.

Errors

List of possible exceptions:

Error type Description
DomainError Not supported inImage pixel format in CorrectGamma.

Function Overrides

See also