文件
dayu-color/tools/kernels/README.md
T

3.9 KiB
原始文件 Blame 文件历史

可重建调色内核

生产构建只读取本目录的 LLVM AIR 文本和项目的 DYGrade.metal,不读取原厂 App、原始 metallib、网络或授权状态。来源、原始模块范围和改动见 PROVENANCE.json。这些文本是从已交付着色器还原的指令图,不是原始 Metal 源码。

python3 tools/build_kernels.py --output /absolute/default.metallib --intermediates /absolute/cache

DYGradeKernel.ll 保留参考颜色数学:线性输入转 sRGB 编码域 → 输入 LUT → RGB 三原色矩阵 → 曝光 → 白平衡 LUT → 对比/高光/阴影 → 自适应白场 → 黑场 → 局部纹理/清晰度/去雾 → 主及 RGB 曲线 → 主及 RGB 色阶 → 色彩平衡 → 8 色 HSL LUT 与自定义 HSL → 分级 LUT → 自然饱和/饱和度 → 黑白 → 5 层风格 LUT → 肤色保护 → 线性输出。中性参数直接返回输入;各章节和单项旁路保留。原许可、水印、字形表及其参数已移除。

CPU 和 Metal 共用 DYUniforms.h。大小 944 字节、16 字节对齐,102 个字段逐一检查偏移。普通调整中性为 0;色阶 white 为 255、gamma 为 1;黑白模式默认关闭;额外曲线点的 X 小于 0 表示该点不存在。白平衡、8 色 HSL 和分级由 CPU 生成 3D LUT,不能拿 identity 占位声称完成这些功能。

dyVertex 使用 buffer0 DYVertex2D[4]、buffer1 uint2 viewport;像素位置围绕输出中心,UV 对应输入纹理。dyFragment 绑定:

位置 纹理
0 linear straight RGBA source
1 输入 3D LUT
2–6 按顺序混合的 5 层风格 LUT
7 HSL mixer 3D LUT
8 白平衡 3D LUT
9 色彩分级 3D LUT

fragment buffer0 为 DYUniforms,buffer1 为 float sceneLevel,buffer2 必须绑定 16 字节 DYRenderOptions。其首 uint outputPremultiplied 控制处理后是否乘回 alpha,其余为 0。source 应已是 straight RGB;若宿主提供预乘颜色,先运行 dyUnpremultiply(texture0 读源、texture1 写不同的 RGBA16Float 目标),统计与所有邻域采样都使用该 straight 纹理。alpha<=0 输出 RGBA0;非零 alpha 保留输入 alpha。半精度转换会产生量化误差。

dyPreview 为每实例缩略采样核:texture0 straight linear source、buffer0 写 float4[4096];调度64×64,每格按归一化中心采样,RGB使用标准sRGB分段编码,alpha原样保留。不夹断HDR或负值;CPU用途自行决定显示、统计的有效范围。

局部滤镜最大采样半径 18×1.7=30.6 像素;tile 请求至少 32 像素 halo,并设置正确的 UV。自适应白场必须采用全帧统计;不能逐 tile 算独立白场。

dyWhitesSceneStatistics 绑定 texture0 source、texture1 白平衡 LUT、buffer0 uniforms、buffer1 写 float。必须只调度 1 个 threadgroup、每组 256 个线程。固定取 256×256 均匀网格,跳过 alpha<=0;统计 96%–99.5% 亮度区间,结果钳制 0.35–1。此路径按参考行为不执行输入 LUT/三原色矩阵。

dyLUTExportKernel 绑定 texture0–8 为上表 1–9;buffer0 uniforms、buffer1 写 float RGB、buffer2 uint cubeSize;调度 cubeSize³ 个线性线程。输出 red-fastest RGB triples(每格3个float)。空间纹理/清晰度无法写进 3D LUT,参考导出路径本身也省略这些操作。自适应白场按导出核既定逻辑处理,不能把导出 LUT 等同于任意画面渲染。

GPU 检查只运行命令行,不启动测试 App:

xcrun clang++ -std=c++17 -fobjc-arc -framework Foundation -framework Metal tools/verify_gpu.mm -o /absolute/cache/verify_gpu
/absolute/cache/verify_gpu /absolute/default.metallib verification/GPU.json

验证工具只读加载安装的原厂着色器作为独立数学对照,不把其库放进交付物。测试状态、设备、哈希、最大误差和未覆盖范围保存在报告中。原 GPU 的 half 输入/输出在此保留,不能将报告解释为原生 32 位 HDR 精度或宿主导出验收。