比纯白更明亮的光。
普通视频的亮度上限就是纯白:一件白衬衫和太阳的亮度其实是一样的。而 HDR 屏幕在“白色”之上还保留了充沛的亮度余量,专门留给真正发光的物体。
这份余量取决于你的显示屏以及当前亮度设置。MacBook Pro 的 XDR 显示屏峰值高光可达 1,600 尼特——远比网页上的白色更加耀眼。
你的日常视频,从此熠熠生辉。
你手头几乎所有视频都是为普通屏幕制作的。SDR 转 HDR 能让画面中的灯光、天空与反光充分利用屏幕的亮度余量——同时让人像肤色与暗部阴影保持原本的质感。


只提亮高光部分
亮度仅在高光区域平滑抬升,色彩本身保持原有色相。在“均衡”档位下,漫反射白(大致相当于白衬衫的亮度)以下的所有画面都原封不动。
上限由你掌控
“高光提升上限”滑块就像 HDR 电影的母带峰值亮度设置。MacLC 绝不会向你的屏幕请求超出其当前能力的亮度。
随时对比前后效果
按住 M 键,或点击“按住对比”按钮,即可立即查看原片。按住 Option 点击 HDR 徽章可快速开关。
它不会做什么
它无法凭空创造原片中不存在的细节;在普通屏幕上不会产生任何变化,也不会改动原本就是 HDR 的视频。
自动挑选当前 Mac 能实时稳定运行的最高档位:接通电源的 Pro 或 Max 芯片启用“极高”,使用电池或机身发热时则切至更轻量的档位。
对整帧画面应用单条扩展曲线,最省电。
随场景动态适应,保留自然的白色与顺滑过渡,并保护字幕和台标不被过曝。
通过训练好的神经网络精准识别光源与反光,仅对它们进行提亮。
以最高精细度运行训练网络,对细小点光源的刻画尤为出色。
最佳格式,一句话说明白。
打开 HDR 电影时,界面会弹出小卡片说明文件内包含哪些格式、以及 MacLC 为你屏幕选了哪一种——随后自动淡出。点击一下即可随时切换。

准确
在屏幕能力范围内尽可能忠实还原母带调色。在光线充足的室内可能会显得偏暗。
均衡
当屏幕峰值亮度低于电影母带时保留高光细节,是绝大多数 Mac 日常观影的最佳选择。
明亮
整体抬升中间调与高光,画面更明亮通透,代价是会损失少量高光细节并增加耗电。
iPhone 视频
iPhone 拍摄的 HLG 视频既可以像 HDR 电影一样明亮耀眼,也可以适配你的屏幕呈现更柔和的观感——随你选择。
舒适的字幕
字幕始终保持在普通白字的亮度,绝不会像太阳一样刺眼。
多屏无缝切换
将播放窗口拖到另一块屏幕,MacLC 会立即针对新屏幕重新调整画面。
兼顾电池续航
当使用电池或低电量模式导致亮度受限时,MacLC 会及时提示;当两种格式显示效果一致时,会自动挑选更省电的那一种。
集中一处,明明白白。
“设置 › HDR 与色彩”会直观展示当前屏幕与视频的实时状态,并让你决定打开 HDR 视频时的默认行为。默认设置已能满足绝大多数人的需求。


自动
在支持的屏幕上输出 HDR,在普通屏幕上自动转换。推荐选项。
始终使用 HDR
强制以 HDR 信号输出普通视频(这会导致普通视频变暗)。仅限特殊用途。
将 HDR 转为 SDR
以标准亮度呈现 HDR 电影,保留全部高光细节,不在 XDR 屏幕上触发额外亮度。
写给喜欢探究技术细节的你。
代码库中真实的数学公式、性能实测与每一项参数。
扩展公式
图像首先线性化,每个像素的驱动能量取其亮度与最大通道值 85% 中的较大者。在“快速”档位下,以 SDR 白色为基准,能量在半数 SDR 白色拐点以下保持不变,之上则按二次曲线抬升:x ≤ ½ 时 f(x) = x,其上为 f(x) = x + 4(B − 1)(x − ½)²。
拐点处数值与斜率均连续(f(½) = ½,f′(½) = 1),且 SDR 白色恰好达到目标倍率(f(1) = B)。整个像素按所得比例统一缩放,从而完整保留色相与饱和度。“均衡”档仅提升漫反射白以上的部分,且大面积高亮时会自动收敛;“高”与“极高”档则会为每一帧场景预测增益网格。
快速档拐点:半数 SDR 白色,保持不变
SDR 转 HDR原生显示路径上的 Metal 着色通道
- 处理管线
- Y′CbCr 或 BGRA → R′G′B′ → 线性光(严格匹配 macOS 对不同缓冲区应用的实测曲线:BT.1886 或 sRGB)→ 扩展映射 → BT.2020 原色 → 64 位半精度线性浮点缓冲(1.0 = SDR 白色),直接送入 AVSampleBufferDisplayLayer 且不附带伪造的母带元数据。
- 峰值上限
min(setting, current EDR headroom);对于 PQ 与 HLG 片源以及指定 SDR 呈现的画面自动跳过。- 快速(Fast)
- 逐像素应用上述二次扩展曲线。
- 均衡(Balanced)
- 仅提升漫反射白以上的像素,当大面积区域较亮时自动减弱强度;结合场景统计、引导基底层、面积限制器、去色带以及内嵌字幕与台标保护。
- 高、极高(High, Maximum)
- 在“均衡”分析的基础上,通过 MPSGraph 运行小型神经网络,从 256×256 缩略图预测双边增益网格;网络权重自
.maclcnn文件加载并在加载时逐层校验维度。增益以 log(10) 的比例读取,各通道与亮度加权增益的差值控制在 0.2 log 以内(测试场景色相误差仅 0.06°)。 - 网络模型
sdr2hdr-high-v1、sdr2hdr-max-v1:由 Hazen Studio 基于 Poly Haven CC0 摄影素材训练,与加载模块同采用 LGPL 许可。- 自动(Auto)
- 根据供电状态、机身温度、GPU 级别与像素吞吐量自动挑选档位;若超出 GPU 时间预算,自动降档直至快速档。
- 实测数据(M3 Max)
- 模型预测每帧耗时 0.45 ms(高)与 0.53 ms(极高)。初版引入扩展器时含同步等待测得 1080p 为 0.53 ms、4K 为 0.91 ms;在八阶梯测试图上与独立 CPU 参考实现完全吻合;60 秒 4K 播放实测耗时与关闭时持平且内存占用恒定。应用内输出在 HDR 截屏验证中与离线模型误差在 1–3% 以内。
- 技术对比
- 逆色调映射本身并非新概念——libplacebo、mpv 及部分电视均提供类似功能。MacLC 的独特之处在于将其直接运行在 macOS 默认原生显示路径上(这是 libplacebo 无法触及的),并提供简洁的开关与滑块、专属训练模型以及上述实测性能。
HDR 影片格式支持、决策器与画面模式
- 支持格式
- Dolby Vision Profile 5、7(基础层与 RPU;忽略增强层)、8.1 与 8.4;HDR10+(ST 2094-40,如电视般持续保持直至码流更新);HDR10(ST 2084 配 ST 2086 母带与 CTA-861.3 MaxCLL/MaxFALL);HLG。首帧解码前即读取 Matroska 中的 Dolby Vision 配置记录(dvcC、dvvC、dvwC)。
- 格式决策器
- 综合分析轨道的传输函数、色域原色、母带亮度范围、MaxCLL/MaxFALL、Dolby Vision 配置,以及显示器的潜在/当前/参考 EDR 余量、电池与低电量模式状态。若母带完全落在屏幕峰值内,三种格式画面一致,此时优先推荐 HDR10(macOS 原生管线,功耗更低);否则按 Dolby Vision → HDR10+ → HDR10 顺序优选。每个文件自动重启轨道限制在两次以内;手动切换格式会精准对齐时间点,耗时约一秒。
- 画面模式
- “准确”在屏幕峰值 90% 以内精确还原,其余部分在 PQ 域平滑指数滚降;“均衡”采用 ITU-R BT.2390 EETF;“明亮”在 BT.2390 平滑前提供最高 1.6× 提亮。当母带完全处于屏幕能力范围内时,映射即为恒等(或受峰值限制的线性增益)。已通过 ST 2084 往返、0 至 10,000 cd/m² 单调性、峰值限制与拐点连续性验证。
- 参考白基准
- PQ 将 SDR 白色锚定在 100 cd/m²,这是 macOS 对 PQ 表面的标准约定(已在 macOS 26.2 HDR 截屏中实测确认)。HLG 则通过 BT.2100 OOTF 面向 1,000 尼特参考屏(
reference)或 100 × 当前动态余量(display)进行映射。 - 渲染引擎
- HDR10、HLG 与 SDR 采用原生路径(AVSampleBufferDisplayLayer,EDR),并在 GPU 上按画面模式曲线重算。Dolby Vision RPU 与 HDR10+ 采用 MacLC 自研 Metal 引擎(从 libplacebo 7.351 移植的 Dolby Vision 解码器在 4K Profile 8.1 帧上相对 C 参考实现平均误差仅 0.05%),同时保留 OpenGL 作为后备。
修复继承 HDR 路径的缺陷对继承视频管线的审计在 Apple Silicon 上共发现六项缺陷与九项缺失功能
| 遇到的问题 | 你此前看到的画面 | MacLC 的做法 |
|---|---|---|
| 仅在启动时从主显示器读取一次亮度 | 将窗口拖到第二块显示器后,HDR 亮度计算错误。 | 每当更换屏幕、移动窗口或切换色彩描述文件时都会重新测量。 |
| HDR 设置项毫无作用 | 模式菜单和亮度滑块实际上只是摆设。 | 两项设置在播放期间均会实时生效。 |
| 普通屏幕上无法正常观看 HDR | HDR 影片在普通显示器上高光全部被裁切为死白。 | 提供真正的 HDR 转 SDR 映射,并在旧系统上自动回退。 |
| 字幕与画面最高光一样刺眼 | 在较暗的 HDR 场景中,白色字幕刺眼得令人不适。 | 字幕始终保持在舒适的 SDR 白色亮度。 |
| 高于 10 bit 的片源被压成 8 bit | 12 bit 与 16 bit 片源在送达屏幕前就已丢失细节。 | 解码至 10 bit 缓冲(P010);16 bit 4:2:2 全程无损传递。 |
| 低于 4K 的 HDR 文件被误判为普通视频 | 低于 4K 分辨率的广色域视频色彩显示严重失真。 | 严格按视频流实际属性打标,不再出现 0 尼特母带范围。 |
额外新增不止于修复
- AV1 硬件解码
- M3 及更新芯片使用 VideoToolbox(通过
VTIsHardwareDecodeSupported检测),其余机型使用 dav1d。 - 动态元数据
- HDR10+ 元数据贯穿整条滤镜链传递;加固的解析器从 VideoToolbox 码流中稳定提取 Dolby Vision,并修复了首帧异常比特导致 Dolby Vision 丢失的问题。
- 色彩管理
- 将 ST 2086 与 CTA-861.3 元数据传递至显示层;实时读取窗口所在屏幕的 ICC 描述文件。
- 软件解码优化
- 手写 ARM64 NEON 色度格式转换(NV12/P010 ↔ I420/I420_10L)。
- OpenGL 支持
- 启用带 64 位色彩的 Core 4.1/3.2 Profile,使 libplacebo 着色器得以运行(原 VLC 会报错“OpenGL version too old”)。
高级设置设置 › HDR 与色彩 › 高级
- 色调映射曲线
- 自动(使用 MacLC 画面模式)、硬裁切、ITU-R BT.2390 EETF、Reinhard、Mobius、Hable、Gamma-Power、线性拉伸、ITU-R BT.2446A、单枢轴样条曲线
- 色调映射参数
- 所选曲线的肩部滚降平滑度;设为 0 则使用默认值
- 色域映射
- 自动、裁切(Clip)、感知优先、相对色度、保留饱和度、绝对色度、去饱和(针对 BT.2020 片源)
- 缩放滤镜
- 内置双线性、Mitchell-Netravali 与 Catmull-Rom 双三次、Lanczos、Spline16/36/64、EWA Lanczos(Jinc),分别用于放大与缩小
- 抖动处理(Dithering)
- 蓝噪声、白噪声、16×16 Bayer 或关闭(OpenGL 后端;Metal 后端全程采用 16 位浮点渲染)
- 视频后端
- 自动、原生或 Metal;OpenGL(传统)作为后备方案
- 解码器
- 仅限硬件解码;解码器像素格式(默认 10 bit P010,可选 8 bit 格式)
- SDR 转 HDR 高级选项
- 中间调(标准 → 提亮)、高光色彩(柔和 → 浓郁)、去色带强度(关、标准、强)、字幕与台标保护
命令行选项适用于终端启动与 vlcrc 配置文件
| 选项 | 可选值 | 默认值 | 说明 |
|---|---|---|---|
--macosx-hdr-mode | 0–3 | 0 | HDR 播放模式:自动、始终 HDR、转为 SDR、关闭 HDR |
--macosx-edr-headroom | float | 0.0 | 0 表示跟随显示器;≥ 1.0 表示手动强制指定亮度余量 |
--macosx-sdr-to-hdr | bool | off | 将 SDR 视频以 HDR 方式播放 |
--macosx-sdr-to-hdr-quality | auto | fast | balanced | high | maximum | auto | SDR 转 HDR 画质档位 |
--macosx-sdr-to-hdr-boost | 1.0–16.0 | 4.0 | 高光扩展峰值(以 SDR 白色的倍数计) |
--macosx-sdr-to-hdr-midtones | 0.0–1.0 | 0.0 | 中间调提亮幅度 |
--macosx-sdr-to-hdr-saturation | 0.5–1.5 | 1.0 | 增强高光的色彩饱和度 |
--macosx-sdr-to-hdr-deband | off | normal | strong | normal | 对高光增强区域进行去色带平滑 |
--macosx-sdr-to-hdr-protect | bool | on | 将内嵌字幕与台标维持在原始亮度 |
--maclc-hdr-presentation | auto | dolbyvision | hdr10plus | hdr10 | hlg | sdr | auto | HDR 视频默认开启的呈现格式 |
--maclc-hdr-picture | auto | accurate | balanced | bright | auto | HDR 呈现所使用的画面风格 |
--maclc-hdr-hlg | reference | display | reference | HLG 按 HDR10 参考基准渲染或随当前屏幕调整 |
--maclc-hdr-card | 0–2 | 1 | 格式信息卡片显示时机:始终、存在多格式可选时、从不 |
Mac 与电视上的 YCbCr 与 RGB(以及全范围与有限范围)详解
通过 HDMI 将 Mac 连接到电视?了解为什么 YCbCr 和 RGB 范围不匹配会导致黑位发灰或暗部死黑,以及如何彻底修复。
MacBook Pro 上的 Mini-LED 光晕:成因与缓解方法
在 MacBook Pro XDR 屏幕的文字与字幕周围看到了发亮的光圈?了解 mini-LED 光晕(Blooming)为何产生,以及如何在看电影时有效减轻。
MacBook Pro 参考模式全解:看视频应该选哪一个预设?
了解 MacBook Pro 的 XDR 参考预设在看电影时如何工作。揭秘为何「Apple XDR 显示屏」是观影首选,以及为何专业参考模式会让 HDR 画面发暗。
为什么 HDR 电影中的字幕会这么刺眼?
HDR 电影中过亮的字幕会毁掉夜景并引发光晕。了解播放器为何以 1,000 尼特渲染文字、如何调暗字幕,以及 Mac 如何处理 HDR 文本。
为什么 HDR 看起来太暗?(以及如何在 Mac 上解决)
HDR 电影看起来太暗,是因为它们是针对暗室环境调色母带的。了解为什么白天看片暗部会消失,以及如何在 Apple Silicon Mac 上提亮 HDR。
什么是 HDR10?(以及它与 HDR10+ 的区别)
HDR10 是采用 10-bit 色深与静态元数据的开放 HDR 视频基础标准。了解其工作原理、HDR10+ 如何通过动态曲线优化画质,以及 Mac 如何播放这两种格式。
