# 2.6.1.9 imgHistcontrast

## Command Line Usage

 

1. imgHistcontrast a:=20; 

2. imgHistcontrast a:=-20 img:=mat(1) oimg:=mat(2); 

## Variables

Display
Name
Variable
Name
I/O
and
Type
Default
Value
Description

Input

double

0

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

Input Matrix img

Input

Image

<active>

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:

1. When the input image is active, select Image: Adjustments: HistContrast. This opens the dialog of the X-Function.
2. 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.

## References

LEADTOOLS Main API Help file, Version 14