HDR 图片和视频

HDR（高动态范围）让画面的高光比普通屏幕白色更亮，暗部更有层次。主流旗舰手机拍摄的照片和视频多数已是 HDR，但经过普通图片处理后往往丢失 HDR，甚至发灰。CoreIX 在处理过程中完整保留 HDR，也可以按需转为 SDR。

只有 HDR 源才能输出 HDR，SDR 源不会变成 HDR。

支持范围

类型	可识别的 HDR 源
增益图照片	JPEG（Ultra HDR）、HEIC（含 iPhone 照片）、AVIF
PQ / HLG 图片	HEIC、AVIF、JPEG XL、PNG
专业格式	相机 RAW（含 Apple ProRAW）、OpenEXR、JPEG XR
视频	PQ、HLG、杜比视界（MP4、MOV），可截图、可转码
实况照片	静图部分保留 HDR

HDR 源支持全部常规操作：裁剪、缩放、旋转、压缩、格式转换、水印。这些操作会同步作用到 HDR 信息上，输出仍是 HDR。

不加任何 HDR 参数时，输出形态由输出格式决定：

输出格式	HDR 形态	位深	兼容性
JPEG	增益图	8	最好：不支持 HDR 的设备自动显示 SDR
HEIC	增益图	8	同上
AVIF	PQ	10	Chrome、Safari 等现代浏览器
PNG	PQ	16	现代浏览器
JPEG XL	PQ	16	Safari
WebP、GIF	不支持 HDR，输出 SDR	8	–

面向大众分发时推荐 JPEG：一张图同时兼容 HDR 与 SDR 设备。追求体积与画质时选 AVIF。

参数	说明	默认值	取值
`hdr-rate`	HDR 亮度。百分比：按原图 HDR 强度的比例保留；数值：指定峰值亮度为 SDR 白色的多少倍。`0` 表示转为 SDR	保持原图	0% ~ 100%，或 0 ~ 10
`hdr-fmt`	HDR 形态。`gainmap`：增益图；`pq`：PQ；`hlg`：HLG；`keep`：跟随原图	`auto`	`auto` / `gainmap` / `pq` / `hlg` / `keep`
`depth`	输出位深上限，仅对 PQ / HLG 输出生效。AVIF 最高 12，JPEG XL、PNG 最高 16，HEIC 固定 10	见上表	10 ~ 16
`mark-hdr-rate`	水印的 HDR 亮度，详见水印文档	0.5	0 ~ 1

加上 hdr-rate=0，系统会把 HDR 映射为普通 SDR 画面，色彩与亮度自然，不会发灰。适用于目标设备或 App 不支持 HDR 的场景，处理速度也更快。

HDR 视频转码默认保持 HDR（HEVC 10 位）。指定 vcodec=h264 时自动映射为 SDR，兼容不支持 HDR 的播放器。

观看 HDR 效果需要：

HDR 资源	CoreIX 截图默认输出 HDR	CoreIX 截图转 SDR	阿里云 OSS 丢失色彩和方向
彩虹.mov（iPhone 录制）	查看大图	查看大图	查看大图
食物.mov（iPhone 录制）	查看大图	查看大图	查看大图