You are here: Start » Filter Reference » Image » Image Point Transforms » CorrectGamma
Module: | FoundationLite |
---|
Performs gamma correction.
Applications
Name | Type | Range | Description | |
---|---|---|---|---|
inImage | Image | Input image | ||
inRoi | Region* | Range of pixels to be processed | ||
inValue | Real | 0.01 - 8.0 | Gamma coefficient, where 1.0 is neutral | |
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
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 AvsFilter_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.