文件

3.3 KiB

颜色查表与接入核验

本记录说明当前 CPU/GPU 数学契约和已有核验范围。Color Finale 相关迁移研究、第三方来源及历史记录入口见 ALGORITHM_SOURCES.md。

MIT 查表数据

Camera Raw 查表数据和组合行为来自 Compositor,MIT,Copyright 2026 Wonder Assembly LLC。已核对提交 92f5225afe7e921dbfa4c563462980e45db345fc 的 Compositor/Resources/CameraRawTables.bin;项目资源 DayuColorTables.bin 的 SHA-256 为 e67ff4dbcce35cb7765752acff4405be5c934d913ef1396b2ca3fc6dc8a85190。完整许可位于正式资源 THIRD-PARTY-NOTICES.txt。

  • CRT3 头;维度17、763张表、差值量化步长3。10字节头后为LZMA/xz,解压长度11,245,857字节。
  • 每张表按通道累计有符号Int8差值,还原为 round(axis * 255 / 16) + signedDelta * 3,钳制0–255。
  • 源表红轴最慢、蓝轴最快,RGB8;采用17³三线性插值。组合输出33³ RGBA32Float,Metal纹理红轴最快,alpha固定1。
  • 白平衡:温度和色调各−100…100、间隔25,四张相邻表双线性混合。
  • 八色HSL:依次组合明度、饱和度、色相;表起点 285 + (kind * 8 + color) * 5;各项−100…100、间隔50。
  • 分级:先阴影、中间调、高光、全局明度,再组合全局、中间调、高光、阴影色轮;保留公开实现的插值及平衡系数。

字段与旁路

CPU/Metal共用944字节 DYUniforms,字段偏移由静态断言检查。白平衡、HSL和颜色分级由CPU生成有效或中性3D纹理,停用时不能复用非中性的缓存。基础分组同时控制光影与颜色子组;纹理、清晰度和去雾遵循基础组旁路,肤色保护独立启停。

肤色保护开关阈值0.5,保护程度为0–100,内部乘0.01并钳制;中心色相除以360后参与HSL圆周距离。默认保护程度60、中心色相28。黑白六色默认系数依次为 40,60,40,60,20,80,着色色相与饱和度默认0。

三原色矩阵为列向量,GPU使用 r*M0 + g*M1 + b*M2。色相沿灰轴旋转,幅度 hue / 100 * 0.5235987305641174;饱和度系数 sat / 100 * 0.55,矩阵保持D65白点并限制极端偏移。

自动调色与导出

当前自动调色在320×180、RGB8数值域中计算分位数、饱和度和中性样本权重;先做输入转换和强度混合,再进行统计。阈值与计算式见 DYAutoGrade.mm。该实现与同系列 Color Finale 迁移工程的 Core/DYAuto.hpp 使用不同参数和公式,来源分别保存。

LUT导出输出 cubeSize³ * 3 个float,红轴最快。输入为输入LUT、五层风格LUT、HSL、白平衡及分级纹理;参数、RGB输出和cubeSize分别绑定buffer0/1/2。空间纹理、清晰度及逐画面统计无法完整表达为3D LUT。

验证范围

tools/verify_color_tables.mm 覆盖数据摘要、损坏拒绝、独立double三线性对照、白平衡、纹理轴序、24项HSL端点、四色轮、色相环绕、明度端点、三原色控制和D65保持。真实Metal纹理接口与非中性缓存后的组旁路由原生集成检查覆盖。

GPU数学、CPU表、自动分析、宿主交互和实际导出各自保留报告。有限数值检查与静态结构检查不能替代所有宿主、素材、图像原点、alpha和色彩空间的实际验收。