Target

The targets that define the shadow and highlight levels of the automatic brightness control.

These values steer the automatic exposure and gain adjustment, see Exposure and (Gain).

Automatic brightness control does not aim for a single average image brightness. Instead, it analyzes the histogram of the captured image and measures the gray values at two quantiles:

  • the gray value at the Shadow/Quantile represents the darkest pixels that still contain real image content, and

  • the gray value at the Highlight/Quantile represents the brightest pixels that still contain real image content.

Exposure and gain are then adjusted so that the measured shadow level moves towards a dark target gray value and the measured highlight level towards a bright target gray value.

A histogram quantile is a fraction of the analyzed pixels. The pixels beyond the quantiles are treated as outliers (for example, image noise, dead pixels or specular reflections) and do not influence the measured shadow and highlight levels.

Both quantiles act on the overall image brightness:

  • Lowering a quantile selects a darker pixel as its reference. More exposure and gain are needed to reach that reference’s target gray value, so the image becomes brighter.

  • Raising a quantile selects a brighter reference pixel, so the image becomes darker.

The distance between the two quantiles determines how much of the scene the control tries to fit into the output image. Moving them apart asks for a wider dynamic range. Moving them towards each other narrows the range and yields a more contrasty image, at the price of losing content beyond the two references.

In practice:

  • If dark objects lack detail, decrease the Shadow/Quantile.

  • If the image is noisy or a few very dark pixels drive the exposure up, increase the Shadow/Quantile.

  • If shiny or reflective metal surfaces are overexposed, increase the Highlight/Quantile.

  • If a few small bright spots make the whole image too dark, decrease the Highlight/Quantile.

JSON Format

Type

Object

Permissions

Read-only

Below is an illustration of an image histogram with its corresponding low and high quantiles.

The darkest pixels of the image are driven toward the Shadow target and the brightest pixels toward the Highlight target.

Properties

Property

Description

Highlight

The highlight end of the automatic brightness control.

Mean

The target gray value of the legacy mean-based brightness control.

Shadow

The shadow end of the automatic brightness control.