Support text-annotated Cube rows with Custom LUT zero-fill compatibility
这个提交包含在:
1 父节点
5c547100c1
当前提交
58a17de438
10 个文件已更改
+1307
-1072
没有与搜索条件相匹配的文件
@@ -0,0 +1,25 @@
|
||||
# 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 状态以本轮交付记录为准。
|
||||
在新工单中引用
屏蔽一个用户