2.6.1.10 imgHisteq

1 Menu Information
2 Brief Information
3 Command Line Usage
4 X-Function Execution Options
5 Variables
6 Description
7 Examples
8 Algorithm
9 References
10 Related X-Functions

Menu Information

Image: Adjustments: Histequalize

Brief Information

Apply histogram equalization to image

Command Line Usage

imgHisteq cs:=yuv;

imgHisteq cs:=yuv oimg:=mat(2);

X-Function Execution Options

Please refer to the page for additional option switches when accessing the x-function from script

Variables

Display
Name

Variable
Name

I/O
and
Type

Default
Value

Description

Color Space

Input

int

rgb

Specifies which color space to equalize.
Option list

RGB:RGB</center>
Linearizes the number of pixels across the RGB color space.(separated channels)
YUV:YUV
Linearizes the number of pixels across the YUV color space.(Best results)
GRAY:GRAY
Linearizes the number of pixels per gray level in a gray level representation of the image.

Input Matrix

img

Input

Image

Specifies the source image to be manipulated. The default input is the active image.

Output Image

oimg

Output

Image

<input>

Specifies the output image. By default, the output image is the same as the input image.

See the syntax here.

Description

This function applies histogram equalization to the input image. We can use it to improve the dynamic range and the contrast of the input image.

Examples

In this example, we use the Histequalize function to boost the contrast of the input image:

When the input image is active, select Image: Adjustments: HistEqualize: Open Dialog. This opens the dialog of the X-Function.
In the X-Function dialog, change the settings as the screenshot below and click OK to close the dialog.

We can see that the input image is modified and the contrast is increased.


The original image	The output image

Algorithm

The computation uses L_HistoEqualizeBitmap() function from LEADTOOLS Main API. Please refer to the LEADTOOLS Main API Help file, Version 14 and read the L_HistoEqualizeBitmap topic.