Back to FabImage Studio website

You are here: Start » Filter Reference » Image » Image Point Transforms » CorrectGamma

CorrectGamma


Module: FoundationLite

Performs gamma correction.

Applications

Image enhancement for human perception. For computer vision consider LogarithmImage.
Name Type Range Description
Input value inImage Image Input image
Input value inRoi Region* Range of pixels to be processed
Input value inValue Real 0.01 - 8.0 Gamma coefficient, where 1.0 is neutral
Output value outImage Image Output image

Requirements

For input inImage only pixel formats are supported: int8, uint8, int16, uint16, int32.

Read more about pixel formats in Image documentation.

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.

Errors

This filter can throw an exception to report error. Read how to deal with errors in Error Handling.

List of possible exceptions:

Error type Description
DomainError Region exceeds an input image in CorrectGamma.
DomainError Not supported inImage pixel format in FisFilter_CorrectGamma. Supported formats: Int8, UInt8, Int16, UInt16, Int32.

Complexity Level

This filter is available on Basic Complexity Level.

See Also

  • RescalePixels – Applies linear transformation to pixel values.