Histogram Equalizer

Histogram Equalizer

Status:

Maintained

Keyframes:

No

Source library:

avfilter

Source filter:

histeq

Available:

On Master only:

No

Known bugs:

No

Description

This effect/filter applies a global color histogram equalization on a per-frame basis.

It can be used to correct video that has a compressed range of pixel intensities. The filter redistributes the pixel intensities to equalize their distribution across the intensity range. It may be viewed as an “automatically adjusting contrast filter”. This filter is useful only for correcting degraded or poorly captured source video.

Parameters

Parameter	Value	Description
Strength	Float	Determine the amount of equalization to be applied. As the strength is reduced, the distribution of pixel intensities more and more approaches that of the input frame. The value must be a float number in the range from 0 to 1 and defaults to 0.200.
Intensity	Float	Set the maximum intensity that can generate and scale the output values appropriately. The strength should be set as desired and then the intensity can be limited if needed to avoid wash-out. The value must be a float number in the range from 0 to 1 and defaults to 0.210.
Antibanding level	Selection	Set the antibanding level. If enabled the filter will randomly vary the luminance of output pixels by a small amount to avoid banding of the histogram.

The following selection items are available:

Antibanding level

None	Default
Weak
Strong