Back to FabImage Studio website
You are here: Start » Filter Reference » Image Enhancement » EqualizeImageHistogram
EqualizeImageHistogram
Maps image pixels to new values to achieve uniform distribution of intensities in the range (0, 255).
| Name | Type | Range | Description | |
|---|---|---|---|---|
 |
inImage | Image | Input image | |
|
inRoi | Region* | Range of pixels to be processed | |
|
inSaturateBrightestFraction | Real | 0.0 - 1.0 | Fraction of the brightest pixels skipped during normalization |
|
inSaturateDarkestFraction | Real | 0.0 - 1.0 | Fraction of the darkest pixels skipped during normalization |
 |
outImage | Image | Output image | |
Only the following inImage pixel formats are supported: 1xuint8
Description
The filter applies non-linear mapping to image pixel values so that pixel intensities of the resulting image are evenly distributed in range from 0 to 255.
The operation computes the cumulative histogram \(C\) of inImage and the image size \(N\). Then the result is computed as follows:
\[ \begin{aligned} outImage[i,j] &= C[ inImage[i,j] ] \times \frac{255}{N} \end{aligned} \]Examples
 |
 |
EqualizeImageHistogram run on example image.
Errors
This filter can throw an exception to report error. Read how to deal with errors here: Error Handling
| Error type | Description |
|---|---|
| DomainError | The sum of inSaturateBrightestFraction and inSaturateDarkestFraction can't be greater than 1 in EqualizeImageHistogram. |
Complexity Level
This filter is available on Basic Complexity Level.
