Skip to content
Console

HDR images and video

HDR (high dynamic range) lets highlights appear brighter than the white of a standard display while keeping more detail in the shadows. Most photos and videos shot on today's flagship phones are already HDR, but ordinary image processing often strips the HDR and can even leave images looking washed out. CoreIX fully preserves HDR throughout processing, and can also convert to SDR when you need it.

Only HDR sources can produce HDR output. SDR sources are never turned into HDR.

Supported sources

TypeRecognized HDR sources
Gain map photosJPEG (Ultra HDR), HEIC (including iPhone photos), AVIF
PQ / HLG imagesHEIC, AVIF, JPEG XL, PNG
Professional formatsCamera RAW (including Apple ProRAW), OpenEXR, JPEG XR
VideoPQ, HLG, Dolby Vision (MP4, MOV); supports frame capture and transcoding
Live PhotosHDR is preserved in the still image

HDR sources support all standard operations: crop, resize, rotate, compress, format conversion, and watermark. These operations are applied to the HDR information as well, so the output remains HDR.

Default output

When you don't pass any HDR parameters, the output format determines the HDR form:

Output formatHDR formBit depthCompatibility
JPEGGain map8Best: devices without HDR support automatically show SDR
HEICGain map8Same as above
AVIFPQ10Modern browsers such as Chrome and Safari
PNGPQ16Modern browsers
JPEG XLPQ16Safari
WebP, GIFNo HDR support; outputs SDR8–

For distribution to a broad audience, we recommend JPEG: a single image works on both HDR and SDR devices. If file size and image quality matter most, choose AVIF.

Parameters

ParameterDescriptionDefaultValues
hdr-rateHDR brightness. As a percentage: keeps that proportion of the original image's HDR intensity. As a number: sets the peak brightness as a multiple of SDR white. 0 converts to SDRSame as original0% to 100%, or 0 to 10
hdr-fmtHDR form. gainmap: gain map; pq: PQ; hlg: HLG; keep: match the originalautoauto / gainmap / pq / hlg / keep
depthMaximum output bit depth. Applies only to PQ / HLG output. Up to 12 for AVIF and up to 16 for JPEG XL and PNG; HEIC is fixed at 10See the table above10 to 16
mark-hdr-rateHDR brightness of the watermark. See the watermark docs for details0.50 to 1
  • hlg supports HEIC, AVIF, JPEG XL, and PNG. JPEG has no HLG form, so the default behavior applies.
  • Frames captured from video carry no peak brightness information, so the percentage form of hdr-rate may have no effect. Use a number or 0 instead.

Convert to SDR

Add hdr-rate=0 to map HDR to a standard SDR image with natural color and brightness and no washed-out look. Use this when the target device or app doesn't support HDR. Processing is also faster.

HDR video transcoding

HDR video transcoding keeps HDR by default (HEVC, 10-bit). When you specify vcodec=h264, the video is automatically mapped to SDR for compatibility with players that don't support HDR.

HDR demo

To see the HDR effect, you need:

  • An HDR-capable display (peak brightness of 600 nits or higher), such as a MacBook Pro, iPhone, or LG 32GQ950.
  • A browser that supports HDR, such as Chrome or Safari.

Frames captured from HDR video

HDR sourceCoreIX frame, HDR output (default)CoreIX frame, converted to SDRAlibaba Cloud OSS: color and orientation lost
rainbow.mov (recorded on iPhone)Rainbow: HDR frame
View full size
Rainbow: SDR frame
View full size
Rainbow: Alibaba Cloud OSS frame
View full size
foods.mov (recorded on iPhone)Food: HDR frame
View full size
Food: SDR frame
View full size
Food: Alibaba Cloud OSS frame
View full size