2.6.1.9 imgHistcontrast

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: Histcontrast

Brief Information

Adjust image contrast using histogram

Command Line Usage

1. imgHistcontrast a:=20;

2. imgHistcontrast a:=-20 img:=mat(1) 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

Adjustment

Input

double

Specifies the amount of contrast change. Valid value range is [-100, +100].

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 overwrites the input image.

See the syntax here.

Description

The imgHistcontrast function increases or decreases the contrast of the input image, using a histogram to determine the median brightness.

This function finds the median brightness of the image, then brightens the pixels with values above the median and darkens the pixels with values below the median. This is more sophisticated (but slower) than the imgContrast function, which uses the middle possible value (128) rather than finding the actual median.

Examples

In this example, we use the imgHistcontrast function to increase the contrast of the input image with the Adjustment as 20:

When the input image is active, select Image: Adjustments: HistContrast. 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.

A new image is created. We can see that the contrast is improved.


The original image	The output image

Algorithm

This function finds the median brightness of the image, and then brightens the pixels with values above the median and darkens the pixels with values below the median.

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