文件
dayu-color/research/LUTNotes1.7.1.md
T

2.8 KiB
原始文件 Blame 文件历史

1.7.1:带文字行的 Cube 容错

基线为 5c547100c1a15feb7a1a9a67c98f2ac44056583a,正式版 1.7.0(45)。用户提供的 tlfs.cube 为 UTF-8、65³;两行保留 R 数值,G/B 位置被文字替换。原解析器报第 1899 行无效,编码识别本身没有失败。

苹果行为依据

本机 Final Cut Pro 12.4(454072)的 ProCore 中,cc::lut_t::readCUBE 逐行调用 _readrow,后者连续调用 qdcstr2float;遇到文字不会继续寻找其中的数字,读不到的通道输出 0,每行仍推进三个表格位置。只读分析使用 REA/Ghidra,临时提取 arm64 切片,未修改 Apple APP。

通过已签名原始框架的实际行读取函数,对用户原文件全部 274625 行进行受控重放:两处结果分别为 (559,0,0)、(45643,0,0)(16 位);本产品保留原有浮点精度,对应 (0.00854505,0,0)、(0.696468,0,0)。全表差异不超过一个 16 位量化单位。摘要、版本、源文件与框架摘要见 verification/LUTNoteAppleReference.json。这证明本文件的数据读取规则,不代表与 FCP 的完整色彩管理、插值和最终画面逐像素相同。

独立实现及边界

  • 数值与尾部文字必须以空白分开,至少存在一个有效前导数值;文字必须是有效 UTF-8 且以字母/汉字起始。已有 UTF-16/32 先按原机制归一化。
  • 保留已读取通道,文字起始后的未读取通道补 0;读满 RGB 后允许同样的文字尾注。不扫描尾注中的数字,不删除行、不插值、不重排。
  • 缺少数据行、纯文字行、没有尾注的残缺 RGB、NaN/Inf、四个数值、数值粘连文字、损坏字节、无效尺寸与 DOMAIN 继续拒绝。兼容范围有意小于苹果读取器的所有宽松行为。
  • 标准 LUT 仍使用既有浮点精度、DOMAIN 与缓存/异步/取消机制;产品不加载 Apple 私有框架,也不携带 Apple 代码。
  • 原文件及导入副本逐字节保留。用户 LUT 和仅供验证的完整数值副本不进入源码、安装包或远端。

验证入口

独立 tools/verify_lut_annotations.mm 覆盖 UTF-8/16/32、三种换行、补零与后续行位置、尾注数字、数值基准、缩略图、原字节导入及拒绝边界;既有库/编码回归同步运行。编译方法与现有原生检查一致:使用 clang++ -std=c++17 -fblocks 链接 DYLUTLibrary.mm、AppKit 与 zlib。

正式插件 --self-test 新增合成 Cube 与完整数值基准的 GPU 对照。可通过 DY_DIAGNOSTIC_LUT_FILE 和 DY_DIAGNOSTIC_LUT_ORACLE 追加只读用户文件检查,导入到本次自检的独立临时库,比较全表、缩略图、GPU 结果及源/导入字节;自检结束清理。不要把这些路径写入公测上传数据。

最终安装、公证、宿主、打包和 Release 状态以本轮交付记录为准。