文件
dayu-color/research/ColorFinaleFilmMixer.md

7.7 KiB

Color Finale 胶片与通道混合:本机移植记录

2026-11-02,基线 b640b5da06f4c4455bb79c9b6bc16daa3088fa92,正式1.4.3(33)。当前为研究检查点,尚未替换正式程序。

目标身份与保存位置

参考为本机 ColorFinale 2.16.2(625)。插件 SHA-256 49121a6f5487060d322a59e7658166ab772e8a56f7dc1bcfa9d433a89436b30f;RenderingEngine 32dca93459347e5ad363cb145d0ccf84b933b2045eee2c9535676a01744b84e3;GradeKit e868a8c6df64bf03b7c24af5657c5ac7a2259a1943dfe06e01dbb7881df018a3。

REA/Ghidra12.1.4目标绑定;Hopper在本机不可用,未改环境或安装工具。原始反编译、AIR和原版运行探针数据仅在 /Users/mac/Library/Caches/CodexBuilds/ColorResearch/dayu-film-mixer-20261102/ 及其父目录的本轮 evidence/snapshot 文件中。产品不得依赖这些缓存或 Color Finale 的安装。

在改动前通过现有正式插件保存当前用户完整预设到 .../com.dayu.color/fcp-qa/film-mixer-before-user.json,77437字节;界面显示286个轨迹键。该私有预设不入Git或发行包。接手源码工作区干净,main与远程完整SHA一致,无待补推分支。

已观察的原版合同

模块 观察 证据
通道混合器 RGB三个输出行各读取RGB三系数,独立保持亮度、保持饱和度;缺省恒等矩阵,两保持选项为关 ev_de17c8b567e4f5b5975b7f65df03a00b6b48ccbc1053283619c02b95a8543387、ev_05d57fdd47b4aeca7b6928f1e37f3dd1f7d8ea482cb53c62689f0ed01d0194a4;原版AIR ChannelMixer
减色 gammaAll/Cyan/Magenta/Yellow、density、densitySwitch、valueSwitch进入SubSat;通道归一化幂函数再以白归一化,不是简单RGB幂函数 ev_90babd33318d6df4735fc2b4fd8ff79a76e6a035939d53e9dff1abdd99c0fa0d;AIR SubSat、compute_norm
晕光 原图clamp边缘→CIGaussianBlur(scatter)→HalationKernel;R/G使用boost/dyeTransmission,B保持 ev_a187b1b5479b8dcd3419136e4d6c7b4de8b1fd692e3469f8ce760277fc82e5b3;AIR HalationKernel
辉光 sensitivity、blurRadius、intensity送入独立通用kernel,后续Fx包装仍需追查 ev_91b77df09f4b079fb6dd3ec48048b920a1712de647717a18349585dab51035d2
颗粒 seed、intensity、grainSize、filmResponse、correlation及RGB标准差;PCG哈希+Box-Muller正态噪声;grainSize>1由MPS高斯扩散;逐通道响应与相关性混合 ev_ff3cd2863e3fcf6d834c2a9e80a550bb6c2c85fa28ccdd1f8c4ac941aba9f469、ev_591f74d294cd90958b4b5212f004171b38a49fc1799547b93b062c29f04b68ef、ev_6ddb156a25bce95378ef3b21653a84779d5a9a9f4924820f46a14d103359ff5e;AIR BoxMullerPCG、GrainFilter

RenderingEngine default.metallib SHA-256 6fd43083a38e76c95c6256a331eabb85d97b48c32d3418e8fee4c1d28480c7ff;metal_kernels.metallib ee21f6115ef96937d7e2c41e5293bcdb8a0fbaeee9570c60e547f550399920a3。用本机Apple Metal工具只读解析指令;静态观察不能替代实际输出对照。

原版最终根级顺序已由身份匹配的既有证据 ev_c0a2873d5bcdbddba37830f470f8face16b6ffef6f4ca3da012a3abd863f3164 建立:图层树→减色→晕光→辉光→颗粒→暗角→输出;ACES输出可选八种印片LMT。各Fx的数值映射、工作域、暗角和LMT仍在追查,不能宣称已经移植或等效。

本工程接入边界

保留原参数ID及944字节GPU前缀;新的参数仅追加。新增可重复通道混合器与胶片工具,沿用现有启停、折叠、蒙版、数量标记和相邻插入。旧工程缺省为严格中性,保留schema1尾层、schema2锚点及286键用户状态。

Cube只允许可静态表示的颜色数学;空间效果、颗粒和蒙版必须明确拒绝,完整预设保留其状态。待本机原版图像对照、原生回归和正式宿主验收完成后再记录结论。

开发检查点

已追加两种工具、42个宿主浮点参数及完整预设v5;旧ID与1104字节完整前缀保留。CST及原调色/蒙版/跟踪调度不重排;两个新根工具位于原显示域链/蜘蛛盘之后,schema1尾层之前。减色与颗粒用既有sRGB编码边界,晕光/辉光/暗角用宿主线性纹理;这属于本工程接入合同,并不声称与任意ACES管理的原版整条CMS完全等效。

原版Fx包装确认辉光使用固定2.5像素稀疏高斯预滤→向量Sobel阈值→用户diffusion高斯扩散→相加;晕光scatter缺省5,透射参数/500,boost缺省1;颗粒PCG与Box-Muller直接原版shader输出逐样本相符,相关性=1−2×colorVariation。暗角直接复用同一系统CIVignetteEffect及参数映射。证据:ev_f0221c32adbaa1e108aa560f0f8fa60c067619ac9f5b06225df548e2671a448f、ev_932531fcd8aaebf06eabd6e22f1a56615ba2462f6efc3fb53cfdbdb9fd618816、ev_b500f2f762efd1dbbd8ae7efab9d48016482ff1463775039d25504cb4ccd9d3f、ev_850af09a4640201b65745c78a10a0e0a0ef67eee9614d129517f6bf13c54c11e。

当前原生346项通过;独立原版CI/Metal对照仍在修正辉光边界采样。CI读取bitmap的上下行与Metal纹理相反,对照工具已有往返控制;产品CI→Metal往返验证无翻转。颗粒比对采用原版BoxMullerPCG/GrainFilter明确尺寸/种子,避免把Core Image内部切块的噪声坐标当作固定全帧坐标。此检查点尚未正式安装和宿主验收。

独立原版对照38项现已全部通过:四组通道保持选项、12组减色、3种晕光半径、3种辉光阈值、4种PCG种子与12组颗粒。最大线性RGB绝对差0.0001328(通道双保持),低于预先记录的0.00015浮点容差;其余各项有各自阈值。辉光普通区域采用可分离预滤,最外一圈直接求原25点邻域,保留原版clamp边界,避免把裁切中间图的边界当作原图边界。见 verification/FilmMixerReference.json。这只覆盖声明的有限组件和参数,不代表原版整条CMS、全部素材或全部印片外观等价。

正式构建准备:1.5.0(34),349项原生检查通过;独立原版对照在64×48、63×47、1×17、17×1四种尺寸共184项全部通过,含零矩阵/灰矩阵退化分支。上下纹理方向的颗粒固定全帧坐标验证通过;元数据旧前缀、原有跟踪/钢笔检查仍包含在原生回归中。静态3D Cube允许通道矩阵和纯减色,拒绝活跃的晕光/辉光/颗粒/暗角。FCP夹具只有三个独立合成项目,FCPXML1.12严格DTD与素材检查通过,不把内部FxPlug ID冒充模板发布参数路径;通过正式检视器设置验收参数。

兼容边界:新模块关闭/零混合以及旧工程缺省走原融合链;活跃减色沿用原SubSat对0…1的限幅。晕光/辉光保留邻域alpha权重,所有新处理保留入口alpha,非正alpha旁路;颗粒全帧种子不依赖Core Image内部切块顺序。原厂八种印片外观是ACES输出的另外一组资源,本轮五组胶片处理未使用这些资源,也不以相机F-Log名称冒充印片外观。

正式1.5.0(34)验收完成

实际编译源码 06d531c443b0bb2f179022a4e64148394f5d0690。正式安装349项原生检查通过,FCP12.4对用户旧234参数、资产路径、蜘蛛盘及287键蒙版载荷核验保持。新工具、胶片椭圆蒙版、折叠数量、独立初始化叠层及删除撤销/重做通过。正式ProRes导出验证颗粒两帧保持,组合/颗粒完整预设冷重开前后逐字节相同。三项目原生FCPXML回导严格校验与字段比较通过。见 verification/HostFilmMixer1.5.0.json;四尺寸184项独立组件对照见 verification/FilmMixerReference.json。本轮交付五组胶片处理及矩阵,不含八种ACES印片外观。

APP和PKG均Developer ID签名、公证Accepted、票据/Gatekeeper通过;PKG有20项展开验包,未再次执行安装脚本。发行包、标签、全量下载和恢复结果分别见 verification/Package.json、verification/Release.json 与本版恢复记录。