文件
dayu-color/大鱼调色FxPlug4交接.md
T

5.8 KiB
原始文件 Blame 文件历史

大鱼调色FxPlug4交接:1.5.0胶片与通道混合器

2026-11-02(Asia/Shanghai)。当前正式1.5.0(34),APP已经签名、公证、粘附并安装,FCP12.4宿主验收完成。安装包/Release最终结果读取 verification/Package.json、verification/Release.json,与APP编译节点分别记录。

身份与恢复

  • 源码:/Volumes/备份/大鱼调色/大鱼调色;远程 https://dayu.media/git/dayu/dayu-color.git,main。
  • 正式:/Library/Plug-Ins/FxPlug/大鱼调色.app,主ID com.dayu.color、XPC com.dayu.color.XPC。
  • APP实际编译源码:06d531c443b0bb2f179022a4e64148394f5d0690。
  • APP公证:164abf2b-4e67-4504-b72a-04122da9e381 Accepted;团队B3W25FX5H5。
  • 固定构建缓存:/Users/mac/Library/Caches/CodexBuilds/com.dayu.color。
  • 模板唯一位置:/Users/mac/Movies/Motion Templates.localized/Effects.localized/大鱼调色/大鱼调色/大鱼调色.moef。
  • 无LFS/子模块;程序不依赖Color Finale安装、REA缓存或父“大鱼调色盘”。

正式PKG ../发行包/大鱼调色-1.5.0.pkg,14,380,104字节,SHA-256 3ecabc7a8bfd675b228a5f00016aa17a35b65b544055e57793ec3bff3d7e0294。PKG公证 05f849da-5567-4351-9556-742d17b95723 Accepted,20项展开验包通过;本轮未再次运行系统安装器。Release372 / 附件17已发布,草稿和正式链接均完整下载校验一致。发行标签 v1.5.0-film-mixer-20261102 对应 85b6590944c4fb64825cf45f61c5280d4ffaa824,远端独立恢复264文件、逐字节核对和full/strict fsck通过。详见 verification/Release.json、FilmMixerReleaseRecovery.json、ReleaseDraftDownload1.5.0.json。核验用下载副本、恢复clone及独立构建目录已清理;已知本产品根目录仅保留唯一正式APP,详见 verification/FilmMixerCleanup.json,不宣称全盘唯一。

本轮实现

通道混合器采用RGB三输出×三输入矩阵,含保持亮度、保持饱和度与混合。胶片含减色、晕光、辉光、颗粒、暗角,五页参数各自启停。两类工具沿用原启停、折叠、蒙版、数量标记、区域跟踪和相邻初始化层;工具类型由12追加到14,原索引不移动。

42个宿主参数只追加,旧参数ID、944字节GPU前缀及1104字节完整旧Uniform前缀保留。完整预设v5兼容v1–v4;读旧预设时新参数恢复中性。schema1尾层、schema2锚点、已有9000–9003载荷保留。新工具置于既有显示域/蜘蛛盘之后、历史尾层之前,不能因此推断UI中全部旧工具都按视觉顺序渲染。

减色与颗粒用既有sRGB编码边界,晕光/辉光/暗角在线性纹理上。减色是原SubSat归一化幂函数,活跃时限幅0–1。晕光为高斯散射后R/G通道加权归一化;辉光为稀疏预滤→向量Sobel→扩散→相加。颗粒使用PCG/Box-Muller、MPS扩散、精确有理帧和规范化全帧坐标;与原版CI内部切块的空间噪声排列不做全局逐像素等效承诺。暗角复用相同系统CIVignetteEffect。纯矩阵和减色支持Cube,活跃空间/时间效果及蒙版明确拒绝Cube。

原厂八种印片外观属于另外的ACES输出资源,本版五组处理未纳入这些外观。不能把F-Log输入菜单当作胶片外观,也不能将本工程接入域声称为原版任意ACES链等效。来源、证据ID与边界见研究记录。

验收与用户资料

  • 349项原生检查;四种尺寸64×48、63×47、1×17、17×1共184项原版组件对照通过。
  • FCP12.4正式版加载;用户234个既有参数、资产路径、蜘蛛盘和蒙版载荷逐项/逐字节保持。界面显示286个可信跟踪键,载荷共287键(含作者键)。
  • 新模块、五页胶片控制、独立混合器初始化、胶片椭圆蒙版、折叠数量1、删除/撤销/重做通过。
  • 1080p/25fps/4秒ProRes正式导出验证grainHold2:0/1、2/3、4/5帧分别相同,组间不同。
  • 960×540/25fps/4秒组合导出全部帧解码通过;三个项目FCPXML1.14原生回导严格校验与比较通过。
  • 正常退出冷重开,组合预设8987字节、颗粒预设8420字节前后均逐字节相同。

记录:verification/HostFilmMixer1.5.0.json、FilmMixerNative.json、FilmMixerReference.json、FilmMixerRecovery.json。私有完整预设与FCPXML只在本机 .../com.dayu.color/fcp-qa/,文件名前缀 film-mixer-。不写入Git、PKG或覆盖用户原素材。

源码入口

  • DYFilmTypes.h、DYFilmMath.h:状态/中性判断与共享数学。
  • DYFilmKernels.inc.h:原生Metal点处理、PCG、辉光预滤与Sobel;由DYGrade.metal包含,经tools/build_kernels.py构建。
  • DYFilmRender.inc.h:惰性缓冲、CI/MPS空间阶段、内存预算、混合及现有蒙版。
  • DYFilmTime.h、DYPlugIn.mm:冻结宿主帧长/起点,精确签名帧索引和1–5帧保持。
  • DYModel.mm / DYUniforms.h:只追加描述符、Uniform;DYInspector.mm五页分组和RGB三输出分组。
  • DYToolState.mm / DYToolRender.inc.h:新类型、独立初始化、相邻锚点、尾层和Cube限制。
  • tools/verify_film_reference.mm:本机原版只读CI/Metal对照,不参与产品运行。

按本机全局规则继续交付。tools/deliver.py持有产品锁,正式宿主完成后才输入complete;其自检输出现在会先保存诊断再判定,避免失败时丢失输出。首次预检曾在与恢复自检并行时退出1,旧工具未保留当次JSON;未替换旧版。随后串行349项、正式安装349项和独立恢复349项全部通过,不把未知原因写成已证实的程序缺陷。

上一阶段详细基线保留于1.4.3胶片接续原文,更早历史见历史交接。