For the complete documentation index, see llms.txt. This page is also available as Markdown.

HDR Support

VIESUS automatically detects HDR images and converts them to SDR output using tonemapping. When a gainmap is present, VIESUS can apply it directly — or use one of several dedicated tonemapping methods to achieve a better SDR rendition.

The different HDRmode values are easiest to compare in the VIESUS Viewer, which lets you switch between modes and preview the tonemapping result interactively.

Why HDR needs special handling

Modern phone screens are bright enough to display high dynamic range content, so photos taken on a phone look punchy and alive on the device — a wider range of brightness than a typical monitor or print can reproduce. The catch: an HDR file actually carries two layers of data — a base image (usually SDR) plus a gain map that records the extra brightness information. On an HDR-capable display, the gain map is applied and you see the full range. On a non-HDR display or in print, only the base image gets used.

That SDR base image is usually a compromise. Phone cameras typically either:

  • Tonemap to preserve midtones — highlights blow out to flat white, or

  • Preserve highlights — the whole image loses contrast and looks flat.

Some cameras even produce intentionally flat SDR specifically so the HDR preview looks more impressive by comparison. Either way, the SDR fallback is missing information — and contrast enhancement alone cannot recover it. Contrast enhancement just shifts and stretches values that are already there; it can't reconstruct what wasn't recorded in the base image.

VIESUS reads the full HDR data — base image plus gain map — and applies tonemapping. Tonemapping does two things at once: it shifts values and decides which highlights to preserve and which to clip, using the extended dynamic range as a guide. The result is an SDR output that keeps the crisp, non-flat character of the HDR original, so prints and standard monitors show a punchier, more accurate image than the camera's built-in SDR fallback.

Example

The same source at four output levels: the HDR image clipped at SDR range (preserves midtones), its SDR base image, and two VIESUS tonemapping results.

HDR (clipped)

HDR original — HDR Support

SDR (base)

SDR version — HDR Support

VIESUS tonemapped · HDRmode 1

VIESUS tonemapped Mode 1 — HDR Support

VIESUS tonemapped · HDRmode 7

VIESUS tonemapped Mode 7 — HDR Support

Parameters

Parameter
Section
Range
Default
Description

HDRmode

Config

0 – 7

0

Mode selection (see below)

hdrstrength

Gpars

0.0 – 1.0

0.5

Tonemapping strength — blends the tonemapped result with the base SDR image

Modes

Mode
Character

0 — Off

Uses the SDR base image (or computes SDR from the gainmap if the base is HDR) — no tonemapping applied

1

Soft cinematic look — broadly forgiving default for mixed content

2

Broadcast-standard tonemapping — predictable for video and broadcast workflows

3

Dynamic metadata–aware — best when the source carries dynamic HDR metadata

4

Reference knee curve — predictable mid-tones, soft highlight rolloff

5

Smooth-gradient operator — can compress highlights heavily

6

Smooth gradient with explicit white point — sharper highlight rendition

7

High-contrast cinematic — popular for portraits and product shots

Last updated

Was this helpful?