docs: organize Color Finale migration research and remove prior target descriptions from current tree

这个提交包含在:
mac 于 2026-10-31 16:16:47 +08:00 提交
1 父节点 29dc4d385c
当前提交 719229ddd8
24 个文件已更改
+1012 -3028

没有与搜索条件相匹配的文件

+12
查看文件
@@ -0,0 +1,12 @@
# Color Finale 移植资料快照
四份资料来自同系列“大鱼调色盘”工程,原文逐字节保留。提交与SHA-256见 [SOURCES.json](SOURCES.json),本仓库的适用范围见 [算法来源说明](../ALGORITHM_SOURCES.md)。
| 资料 | 本地快照 | 原工程固定版本 |
| --- | --- | --- |
| 研究记录 | [colorfinale.md](colorfinale.md) | [查看原文](https://dayu.media/git/dayu/dayu-colorplate/src/commit/4458dc0c0ae7f51046b8cfa4b19626e80f7cf6ca/research/colorfinale.md) |
| 颜色工具设计 | [colorfinale-color-tools-design.md](colorfinale-color-tools-design.md) | [查看原文](https://dayu.media/git/dayu/dayu-colorplate/src/commit/4458dc0c0ae7f51046b8cfa4b19626e80f7cf6ca/research/colorfinale-color-tools-design.md) |
| 迁移矩阵 | [colorfinale-2.0-matrix.md](colorfinale-2.0-matrix.md) | [查看原文](https://dayu.media/git/dayu/dayu-colorplate/src/commit/4458dc0c0ae7f51046b8cfa4b19626e80f7cf6ca/research/colorfinale-2.0-matrix.md) |
| 证据索引 | [colorfinale-index.json](evidence-index/colorfinale-index.json) | [查看原文](https://dayu.media/git/dayu/dayu-colorplate/src/commit/4458dc0c0ae7f51046b8cfa4b19626e80f7cf6ca/research/evidence-index/colorfinale-index.json) |
快照中的其他相对链接仍指向原工程的文件;使用上表固定版本可继续浏览其完整上下文。设计目标、独立实现与发行验收以各原文的范围说明为准。
+34
查看文件
@@ -0,0 +1,34 @@
{
"project": "大鱼调色盘",
"remote": "https://dayu.media/git/dayu/dayu-colorplate.git",
"commit": "4458dc0c0ae7f51046b8cfa4b19626e80f7cf6ca",
"verifiedRecordsMatchCommittedFiles": true,
"records": [
{
"sourcePath": "research/colorfinale.md",
"path": "research/color-finale/colorfinale.md",
"sha256": "f669841b2f0402543ad87522cf23fd17e3eced5ef481f5b0e1b0a489d6e2d70d",
"sourceURL": "https://dayu.media/git/dayu/dayu-colorplate/src/commit/4458dc0c0ae7f51046b8cfa4b19626e80f7cf6ca/research/colorfinale.md"
},
{
"sourcePath": "research/colorfinale-color-tools-design.md",
"path": "research/color-finale/colorfinale-color-tools-design.md",
"sha256": "0b5f75d50cf4427dd74c68e5612d15b8cf7748b63a99bf7101c2945663460d07",
"sourceURL": "https://dayu.media/git/dayu/dayu-colorplate/src/commit/4458dc0c0ae7f51046b8cfa4b19626e80f7cf6ca/research/colorfinale-color-tools-design.md"
},
{
"sourcePath": "research/colorfinale-2.0-matrix.md",
"path": "research/color-finale/colorfinale-2.0-matrix.md",
"sha256": "721d50ac0391b515747820632612d56aa34084251e3a347bf16911bdb3f3e7b0",
"sourceURL": "https://dayu.media/git/dayu/dayu-colorplate/src/commit/4458dc0c0ae7f51046b8cfa4b19626e80f7cf6ca/research/colorfinale-2.0-matrix.md"
},
{
"sourcePath": "research/evidence-index/colorfinale-index.json",
"path": "research/color-finale/evidence-index/colorfinale-index.json",
"sha256": "fecb1a8e2fa23d664acbc878cc91c9cf7c0dc646212197b0dd68e34a5d2b244a",
"sourceURL": "https://dayu.media/git/dayu/dayu-colorplate/src/commit/4458dc0c0ae7f51046b8cfa4b19626e80f7cf6ca/research/evidence-index/colorfinale-index.json"
}
],
"scope": "Related-product Color Finale migration research. These documents distinguish observations, independent implementations, planned work and unverified scope; copying the research does not establish a direct code port in this repository.",
"relativeLinkPolicy": "Archived documents retain their original bytes. Relative links inside them resolve against their sourceURL in the original repository."
}
@@ -0,0 +1,169 @@
# 大鱼调色盘 2.0:Color Finale 迁移对照
研究日期:2026-10-26(Asia/Shanghai)。这是功能目标和证据矩阵,**不是已实现清单或发行验收记录**。当前正式安装为大鱼调色盘 2.0.0(56),已完成图层/空间工具、外部输入、CMS、首轮五组胶片处理和Classic24色卡匹配;矩形真实拖动及窗口一次前置已有用户确认。具体范围见verification/release-2.0.0-build56.json。完整迁移尚未完成。
色卡56进度(2026-10-29):Classic24(2014年11月后)6×4参考、射影四角、三模式、CMS前置线性校正、schema19冻结状态和原生控件已接入并正式验收;实际FCP匹配RMS 0.03309→0.00398,一次Undo/Redo与冷重开2557字节一致。Video/Passport Video仍开放,不能视作本矩阵原厂色卡条目已全部完成。自动指针拖动没有确认参数变化,真实四角手势仍未确认;合同和证据见research/chart-matching-contract.md、verification/release-2.0.0-build56.json。
CMS开发进度:根schema16/CMS作者v2、实际源/目的ICC、CPU/Metal整帧、浮点主预览/图库/取色/导出约束已接通;根CMS控件1257项和实际HDR媒体导入37950项通过。正式34完成独立PQ/HLG取帧与FCP CMS撤销/重做;35修复说明换行并通过FCP冷重开,完整调色文件141187字节一致。见 `verification/cms-controls-media-development.json` 与正式35报告。HDR显示器EDR亮度及4K实时未认证。
运动/散景已在正式36验收:方向、光环宽度/强度/柔和度、RGB/HSL、各自参数保留、撤销/重做和冷重开逐字节一致。算法为独立实现,见research/motion-bokeh-contract.md;最大半径4K HSL散景约2.06秒,不承诺实时。
胶片55进度(2026-10-29):减色/晕光/辉光/暗角/颗粒的独立算法、根级控件、schema18归档、CPU/Metal、精确有理帧保持、Undo及FCP冷重开已验证;完整处理文件重开前后7108字节一致。没有原厂同名八种印片外观,色卡和其他工作流仍开放,详见 [胶片合同](film-processing-contract.md)。
## 对照版本与证据边界
本机 `/Applications/ColorFinale.app` 为 **2.16.2(625)**,主插件可执行文件 SHA-256:
`49121a6f5487060d322a59e7658166ab772e8a56f7dc1bcfa9d433a89436b30f`
本次重新计算的摘要与 [已有静态研究](colorfinale.md) 及 [证据索引](evidence-index/colorfinale-index.json) 一致。REA 当前没有打开的目标,无需重复全量分析。已有证据解释的是该发行包的结构,不等于实际 FCP 运行验收。
本次读取了 Color Finale 官方文档和官方界面截图。文档可能包含比本机版更新的功能;涉及 Tone/Chroma、Texture EQ 频段和 FCP 12 的行为需另做版本核验。未改动用户的 FCP 工程,未将专有资源、图标、LUT 或反编译源码复制到项目。
## 本轮优先迁移
| 能力 | 已证实的原产品语义 | 大鱼实现与验收目标 |
| --- | --- | --- |
| 真正的工具图层 | 顶部工具入口创建工具层;同类工具可多次添加;下旧上新,底至顶处理;可排序、启停、重命名、复制、删除 | 有序、稳定身份、独立参数;选择层不改变输出;禁用层是恒等;复制生成新身份;保存和撤销不串层 |
| 图层工具区 | 左侧层列表,主区域显示选中工具,底部为混合量、混合模式、蒙版和删除 | 所有精细工具集中在独立图层编辑器;明确“添加图层”和“编辑当前层”,避免切页意外创建层 |
| 图层蒙版 | 蒙版属于层;同层可有多个形状,以 Add/Subtract/Intersect 组合 | 层全部处理受蒙版约束,包括曲线、LUT、六色向量和蜘蛛盘;无蒙版时全画面生效 |
| 区域跟踪 | 每个节点保存轨迹;按宿主 effectTime 持久化归一化变换;前后跟踪与关键帧操作 | 冻结实例、层 ID、蒙版 ID、形状修订及参考帧;删除或改形后拒绝旧回调;倒序和随机时间输出一致 |
| 六色向量 | RGBCMY 独立 H/S/L;新版另有肤色向量及可调 Skin Target | 六区独立,灰阶不染色,色相首尾连续;肤色扩展单列;不能把全图 HSL 当作六色选择调整 |
| 检查器快捷 HSL | 此位置是大鱼的产品要求,不是对原版行为的断言 | 保留原基础调色和蜘蛛盘;快捷 HSL 直接可用,作用范围及与图层关系明确 |
| 持久 LUT 目录 | Preferences 登记目录并递归发现 `.cube`;图库支持当前片段 Live Preview | 同产品进程共享配置;目录可添加、移除、重定位;空目录、离线、权限和坏文件有不同提示 |
| 当前帧批量预览 | 缓存源帧,应用项目调整,再应用候选 LUT,最终作颜色/方向转换 | 每批冻结同一真实宿主帧及图层快照;旧任务失效;预览不写工程;点击才提交 |
| LUT 插入 | 图库双击或 Insert 新建 LUT 层;可叠加不同 LUT | 默认明确新建层;替换现有 LUT 是独立操作,候选预览不能叠加被替换的原 LUT |
来源:[图层编辑器](https://docs.colorfinale.com/docs/layers/)、[六色向量](https://docs.colorfinale.com/docs/layers/sixvectors/)、[蒙版](https://docs.colorfinale.com/docs/masks/masks/)、[区域跟踪](https://docs.colorfinale.com/docs/masks/tracking/)、[LUT 工作流](https://courses.colorfinale.com/blog/post/cf-lut-management-08-23)、[偏好设置](https://docs.colorfinale.com/docs/preferences/)。
## 完整功能差距登记
以下能力不能因为本轮五个重点完成就自动标记为“全部迁移”。没有相应实现和验证时保持未验收。
| 领域 | 官方能力 | 依据 |
| --- | --- | --- |
| 色轮 | Lift/Gamma/Gain、RGB 滑块、各区亮度与饱和度、分界范围、CDL 导入导出 | [Color Wheels](https://docs.colorfinale.com/docs/layers/wheels/) |
| RGB/Luma 曲线 | Master+RGB、Luma+RGB、Luma Preserving、取色建点、S 曲线捷径 | [Curves](https://docs.colorfinale.com/docs/layers/curves/) |
| 六色与肤色 | 六个标准色区及第七肤色向量,H/S/L、肤色中心、Extended 饱和度模式 | [Six Vectors](https://docs.colorfinale.com/docs/layers/sixvectors/) |
| HSL 曲线 | 按色相改变色相/饱和度/亮度,按亮度或饱和度调饱和度;单曲线旁路及不同插值形式 | [HSL Curves](https://docs.colorfinale.com/docs/layers/hsl/) |
| 滤镜 | Box/Gaussian/Disc 模糊和锐化,RGB/HSL 分通道 | [Filter](https://docs.colorfinale.com/docs/layers/filter-layer/) |
| 通道路由与混合 | RGB 路由、直接常量/颜色、通道混合、系数归一化、通道反相 | [Shuffle](https://docs.colorfinale.com/docs/layers/shuffle-layer/) |
| 相机矩阵 | RGB 基色独立色相与饱和度,保持整体白平衡 | [Camera Matrix](https://docs.colorfinale.com/docs/layers/camera-matrix/) |
| Log 色轮 | 阴影/中间调/高光/Offset;范围分界;位于 Log 转换前处理 | [Log Wheels](https://docs.colorfinale.com/docs/layers/log-wheels/) |
| 色调映射 | 最多 11 点 HSLA 渐变、不同亮度来源、取色和预设 | [Color Atlas](https://docs.colorfinale.com/docs/layers/color-atlas/) |
| 纹理均衡 | 当前文档列六个尺度频段,基于多尺度模糊分解 | [Texture EQ](https://docs.colorfinale.com/docs/layers/texture-eq/) |
| LUT 强度扩展 | 最新文档包含 Tone 和 Chroma 独立强度;本机版对应性尚未逐项核验 | [LUTs](https://docs.colorfinale.com/docs/layers/luts/) |
| 图层组 | 多选建组、折叠、混合组与独立层;组默认 Pass-through | [Groups](https://docs.colorfinale.com/docs/layers/groups/)、[Blend Modes](https://docs.colorfinale.com/docs/layers/blend/) |
| 形状种类 | 矩形、椭圆、折线、B 样条、Bezier、渐变边缘、图像蒙版 | [Masks](https://docs.colorfinale.com/docs/masks/masks/) |
| 内外调色 | 组的父蒙版供多层共用,单层可反转父蒙版 | [Parent Masks](https://docs.colorfinale.com/docs/masks/parent/) |
| 形状组 | 形状多选编组、整体移动、组级 Add/Subtract/Intersect | [Grouping Masks](https://docs.colorfinale.com/docs/masks/grouping-mask-shapes/) |
| HSL 蒙版 | 选色范围/衰减、取色增减、输入输出阶、模糊、源阶段选择 | [HSL Mask](https://docs.colorfinale.com/docs/masks/hsl-mask/) |
| 人物与外部蒙版 | 人物分割、FCP 外部蒙版接入,四种蒙版显示方式 | [Person Mask](https://docs.colorfinale.com/docs/masks/person-mask/)、[External Masks](https://docs.colorfinale.com/docs/masks/external-mask/)、[Display Modes](https://docs.colorfinale.com/docs/masks/fourmaskdisplaymode/) |
| 蒙版发布与抠出 | 从图层或组发布蒙版,在外层检查器选择 Mask Output / Cutout,将结果用于时间线合成 | [官方2.9工作流](https://colorfinale.com/blog/post/cf-2-9-masks-09-24);准确组合与alpha语义待本机发行代码核对 |
| 色彩管理 | Assume Video/Log、ACES、相机输入变换、输出变换、工作空间 | [Color Management](https://docs.colorfinale.com/docs/inspector/cms/) |
| 色卡匹配 | ColorChecker Video/Passport,四角定位、自动匹配和色卡预设 | [Color Chart](https://docs.colorfinale.com/docs/inspector/chart/) |
| 胶片模拟 | 减色、晕光、辉光、暗角、颗粒;部分 Film Look 位于 ACES 链路 | [Film Emulation](https://docs.colorfinale.com/docs/inspector/film-emulation/) |
| LUT 导出 | 将可用纯颜色处理及已有 LUT 合成为 `.cube`;空间蒙版不可烘焙进 LUT | [Export as LUT](https://docs.colorfinale.com/docs/inspector/export-as-lut/) |
| 其他工作流 | 调色预设、跨片段组同步、图像分析、硬件控制面板 | [完整文档目录](https://docs.colorfinale.com/docs/) |
## 界面观察与独立设计
官方 [总览截图](https://docs.colorfinale.com/docs/overview/overview.png) 显示检查器一级调整和独立浮动图层面板并存。浮动面板是横向布局:顶部工具图标、左侧层栈、右侧大面积当前工具、左下层混合和蒙版入口。总览截图标示原版 2.15.0,不作为本机 2.16.2 运行证据。
官方 [六色向量截图](https://docs.colorfinale.com/docs/layers/sixvectors/images/sixvectors.png) 中,七枚颜色按钮横排,下方仅显示当前颜色的 H/S/L 三条滑块;肤色多一条 Target。右侧为可编辑数值,底部为整体和当前向量复位。
大鱼可借鉴信息层级、选择反馈和直接编辑,但不复制原图标或专有素材。清晰标注“全局快速调节”与“当前层”,比让外层控件随选层暗中改变含义更容易判断。本项目最终采用哪种绑定,以实现记录为准。
## 尚未确认的数学与运行事项
- 六色/肤色选择的确切权重、带宽和亮度公式未由公开资料确定,独立实现需自身数值与实际画面验收。
- 旧静态跟踪证据观察到仿射拟合及位置/旋转/双轴缩放输出,不能因此宣称有透视、逐节点形变或遮挡重识别。
- 官网 2025 年介绍 Texture EQ 为五个频段,当前文档为六个;两者应按版本区分。[旧说明](https://colorfinale.com/blog/post/cf-6-vectors-06-25)
- 官方 HSL 页面中“Sat vs Luma”标题与正文轴描述存在命名混淆;大鱼 UI 应使用明确的“亮度 → 饱和度”名称,不照抄含混标签。
- 原版区域跟踪的具体失败恢复、图库插入位置、原版完整运行交互尚未实际比较。不能将官方文字与已有静态分析合并声称运行验收通过。
## 关键验收
1. 两层分别处理天空和建筑;切层、复制、重排、启停、撤销、保存重开后参数与蒙版归属正确。
2. LUT/曲线/六色向量在蒙版外保持该层输入,蒙版中羽化和混合量连续;alpha 不被空间遮罩误裁。
3. 跟踪时重排或切层不改变目标;删除目标或改形后拒绝过期结果;取消保留可信段。
4. LUT 登记一次后重开可见;递归去重且不跟随目录符号链接;失败目录和坏文件可见,不删除工程中已应用的采样数据。
5. 快速切片段、移动播放头、换目标层后,整批卡片最终来自同一当前快照;点击结果与预览的位置、强度一致。
6. 六色条和连续色相环验证区域隔离、灰阶安全及首尾连续;旧 schema 归档保持原有输出和轨迹。
## 2026-10-26 第二阶段实现进度(尚待正式宿主验收)
- 已接入:Pass-through 图层组、8 种叶子混合、父蒙版内部/外部、HSL 五条曲线及线性/平滑过点插值、RGB Master/Luma/Luma-preserving 自由曲线、相机矩阵、四区 Log 调节、独立 ASC CDL 与 CC/CCC 导入导出、最多 11 点颜色映射、原生调色文件、持久预设及 17³、33³、65³ LUT 导出。
- 工具算法为独立实现。B 样条近似、取色创建曲线点、原三色轮的完整 CDL 对应、自动相机输入判定仍未覆盖。
- 组只实现 Pass-through;8 种混合用于叶子层,未声称实现所有 Color Finale 组混合模式。颜色映射的渐变显示是空间输出,明确拒绝导出成 3D LUT。
- 更多蒙版形状、HSL 与亮度键、人物或外部蒙版、手动形状动画、空间滤镜、纹理、色彩管理、胶片模拟、色卡、硬件及跨片段同步仍是开放项。
## 2026-10-26 蒙版与羽化进度
构建23已经正式验收类型蒙版、精确时间关键帧、颜色源阶段与手动/自动轨迹合并;构建24已公证安装内/外羽化双轮廓。主体宽高与羽化拖动独立,保留旧向内效果,轨迹合并保留非几何动画。布局修正版25已公证,待宿主退出后安装;最终冷重开未完成。报告及确切限制见HANDOFF.md,完整目标仍未完成。空间工具、人物/外部蒙版、色彩管理及其他上表未验收项继续保留。
## 2026-10-26 空间工具源码进度(未正式安装)
`d31b3551ca55f787605279f821c163cf3411cb75` 已接入空间滤镜(均值/高斯/圆盘/锐化柔化)、六频段纹理、逐蒙版独立模糊及可操作图层控件。CPU/Metal完整帧、schema8与原生文件、异步取消和图库预览已联通,独立远程恢复186个文件并重编译通过728项面板测试。实际正式APP/FCP验收仍待完成,不能从源码测试推定正式效果或实时性能。Motion/Bokeh、人物/外部蒙版、色彩管理、胶片、色卡及其它未覆盖细项继续保留。
## 2026-10-26 帧蒙版开发基础(未接产品界面)
`1772fd65aac5d9e13b140c82a42705a8faaacbfa` 增加共享标量帧绑定及独立帧Vision人物提供者。CPU/Metal蒙版与父组组合、9次真实人物推理、乱序/同时间换图、均衡/高质量、内存与取消和远程197文件恢复已验证。没有复用Color Finale模型;没有把执行模块当作完整人物功能。作者归档、工作空间/宿主输入适配、人物选择与轮廓细化UI、外部image well/模板和正式验收仍为开放项。见HANDOFF.md和research/colorfinale-frame-mask-design.md。
## 人物帧来源进入真实渲染的开发检查点
`b0f3d5f2563aae51fc4573c95ab629634f9b1cbd` 完成人物/外部来源schema9、精确强度动画、运行计划6与逐帧解析。人物已接CPU/Metal位图、宿主纹理和取色;使用来源RGB配置转换分析图像,保留原调色图像。6次实际人物推理、两种图像原点、透明度、失败原子性及734项离屏面板检查通过;远端独立恢复206文件和重新编译测试通过。仍未开放人物添加/质量菜单,外部输入还未接FxPlug调度,轮廓/实例细化、预览与LUT共用全幅人物分析及正式发布验证仍未完成。颜色转换仅服务人物分析,不等于CMS/ACES迁移完成。
## 2026-10-26 人物控件和 LUT 分析复用开发节点
`7b3f0ad97321b7801fe19032edd92ad05a7a56d0` 已实现人物添加、质量、公共色阶/模糊/强度动画,隐藏无关的几何和纹理跟踪,修复同名蒙版选择及延迟编辑隔离。LUT批次对完整可用面板源按不同请求分析一次并共享原始覆盖度;真实人物图库换帧/应用、807项离屏面板检查、CPU/Metal蒙版显示及212文件远端重建通过。正式24和待装25未变。面板仍是8位缩略图,主预览与图库尚未共用一次分析;人物实例/轮廓/细节细化、外部输入、四种显示模式及正式界面性能/无障碍验收仍开放,不能称人物功能完整迁移。证据见 `verification/person-mask-ui-development.json`。
## 2026-10-26 人物轮廓/细化独立模块
`64a8f56d233d003bb4ab20766c70b18aa78267eb` 完成独立欧氏轮廓、细节与柔和度CPU/Metal模块,提供人物/轮廓/组合及内/中/外位置。修复50%边界浮点分类和软内部覆盖保留问题,177个GPU案例含4K与CPU一致、默认逐位恒等;独立远端224文件恢复和重编译通过。当前仍未接入作者归档、运行计划、产品面板和正式版本,三种处理模式不替代四种显示模式;该条继续标记开发中。
## 2026-10-26 人物细化接入产品源码
人物/仅轮廓/人物加轮廓、内/中/外位置、宽度/细节/柔和度已接入schema10、计划7、原生面板及CPU/Metal完整帧。三种处理模式与四种蒙版显示模式分开;后者继续开放。人物推理请求32字节不变,LUT批次复用原始分析;旧缺省保持恒等,外部源不能误用人物细化。离屏归档、真实人物宿主纹理、父组、边缘重采样、撤销和延迟编辑验证见 `verification/person-refinement-integration-development.json`。正式24和待装25仍不变,人物实例、外部输入、完整CMS/ACES、胶片/色卡及正式界面/性能/无障碍验收继续开放。
## 2026-10-26 四种蒙版显示进入产品源码
`69fc3712f2322155b10c4ebbe3af3f72bcda2b8b` 已接入结果/输入/输入与蒙版/合成蒙版。实际图层入口、同层组合和父组内部/外部覆盖经独立像素参考及CPU/Metal核对;真实人物细化、精确时间、异步旧结果拒绝和原生下拉菜单已接通。显示方式只在窗口内生效,不写入工程、撤销或LUT;旧输出蒙版标记保持兼容。此节点补齐上节的显示模式源码,正式界面与宿主验收仍开放。详见 `research/mask-display-contract.md` 和 `verification/mask-display-development.json`。
## 2026-10-26 主预览与 LUT 共享人物分析
`c281e39a1d6ffbc3b86d18b8783f8e8fc81d072e` 将同一窗口当前精确帧的原始人物覆盖度共享给主预览、蒙版检查和图库。并发请求共用同一覆盖度对象,部分质量命中保留已有结果,颜色/轮廓编辑复用;换源、换时间及同时间上游变化隔离,取消与失败不污染其他消费者。面板仍采用RGBA8缩略图,完整HDR/全分辨率取帧和正式播放性能仍待完成。证据见 `verification/preview-sharing-development.json`。
## 2026-10-26 外部图像调度与配对快照
`a57576e3bc353f641fbd864fe0d9fa35228fb466` 已接入固定ID4图像槽、EffectClip/Parameter双路调度、冻结时间映射、独立坐标与原点、Alpha/Luma实际GPU渲染,以及主预览和LUT共享的自有外部快照。输入顺序、错帧、缺失、父组、代理范围、宿主纹理变更及精确配对已通过离屏测试;真实插件回调以模拟宿主元数据验证,不能替代FCP验收。远端248文件恢复、两目标Release链接、Address/UB与Metal验证通过。接收模板、添加/通道控件、外部轮廓、实际Drop Zone时间与保存重开仍开放;正式24及冻结25未变。见 `external-input-contract.md` 和 `../verification/external-input-development.json`。
## 外部作者与原生接收模板开发(未正式安装)
`576add796cf9daa8b74271a83f2b96d7ec3d7adc` 补齐图层/组外部蒙版入口、Alpha/Luma、轮廓位置/宽度/细节/柔和度,schema11和计划9;精确强度动画保持,矩形/椭圆羽化外框与区域跟踪回归通过。独立接收模板连接固定ID4,普通模板不变;未来正式APP安装两个缺失模板,保留用户修改。1,026项面板、19,128项输入/实际GPU、144组人物/外部细化、15项模板结构及259文件远程恢复通过,详见配套verification报告。实际FCP接收、空来源、变速、保存重开、正式UI/性能未验收;本轮不把静态模板或离屏测试视为完整外部功能交付。
## 迁移范围校正:人物实例与蒙版发布
2026-10-26重新核对:`colorfinale-frame-mask-design.md`中单独人物实例是“第二阶段可评估”的大鱼扩展设想,官方Person Mask当前说明只证明显著人物整体识别、质量和边缘细化。尚未找到单独人物选择是本机2.16.2功能的充分证据;它保留为可选评估项,不作为已证实Color Finale功能缺口。此结论不把缺失证据当作原版不支持的证明,也不减少用户原定的完整迁移范围。
反而已有明确但此前矩阵漏列的功能是“Publish Mask / Mask Output / Cutout”:官方2.9文章展示图层或组蒙版输出,用于把文字放在人物后面等时间线合成。大鱼现有maskView黑白输出、临时四种检查视图、外部输入三者都不能单独证明这一持久发布流程已完成;该项新增为必需迁移和验收项,正在核对本机发布目标及alpha行为。当前完整目标继续进行。
### 发布蒙版与抠出开发接入(2026-10-26)
`bbb4f00bc45170eab1312c6b39989a37f98c02ea` 已实现schema12的唯一图层/组目标与独立输出模式、CPU/Metal节点后发布、真实alpha、外层检查器和图层按钮、透明棋盘格以及归档/撤销/预设/LUT限制。组强度同步插值straight RGB与alpha,旧未发布结果保持。432组独立数值用例(220740断言)最大浮点差8.94069672e-8、8位差0;离屏面板1086项、真实插件回调夹具48项、解析14项通过。详见 `research/published-mask-contract.md`。正式安装、宿主叠层/冷重开及视觉验收仍开放。
原版静态证据确认发布时序和own mask,并发现其组结果后置蒙版、发布重新取样阶段与当前大鱼规则仍有差别。逐子层父蒙版与完整组混合继续列为待升级,不能因发布功能落地而勾选全等。人物已核实路径为整体分割,单人实例选择保留可选扩展。原版证据和限制见 `research/colorfinale-published-mask-design.md`。
### 组内外双链与混合开发接入(2026-10-26)
`b38bc7739f1605e81e0596e4ea942e3b4c7b8ff5` 已实现schema13/计划11的新式组:两链独立从入口开始、直属父蒙版外部路由、组混合和straight RGBA强度、最后按蒙版预乘合成。旧文件仍走旧式逐层覆盖,兼容切换可撤销;嵌套混合版本、空间工具、入口取色、临时监看、发布、LUT候选和导出接入统一流程。54场景/33231断言、1096面板及15解析测试通过,独立远端恢复281文件、两目标Release链接通过,未正式安装。原版证据及独立产品规则见 `colorfinale-group-rendering-v21.md`、`group-compositing-contract.md`。
当前组仅开放既有0–8共9模式,普通层保持8模式旧算法。底层27模式有真实Core Image独立oracle,但两例Luminosity极低alpha差异、Add的扩展alpha链、叶层版本迁移和工作空间转换尚未全部接入,不能勾选“全部混合完成”。原版真实菜单是组23项、普通层22项;四个非分离颜色枚举未出现在该菜单,不将它们当作已证实菜单必需项。正式UI/键盘/VoiceOver/宿主重开/性能、CMS/ACES、胶片/色卡、Motion/Bokeh和其它矩阵细项仍开放。
### 完整混合模式开发与正式25验收(2026-10-26)
schema14/计划12已接入26种叶层、27种组模式及版本化预乘中间链,使用系统CI真实过滤器,不以旧近似数学冒充扩展alpha一致。叶层Add设alpha1、组Add保留扩展alpha;强度和蒙版各自处理,旧节点保留原算法。84完整场景和1160面板断言通过,极端数值安全及4K动态预算修复已验证,尚未正式安装。正式25仅是羽化/布局阶段:FCP冷重开文件逐字节一致,椭圆/旋转矩形实际外框拖动与撤销重做通过,生成副本已清理。完整迁移余项仍按矩阵保持开放。
@@ -0,0 +1,147 @@
# 后续颜色工具的独立实现设计
日期:2026-10-26(Asia/Shanghai)。这是下一阶段工程设计,不是已实现清单,也不表示与 Color Finale 逐像素等价。本文件只新增设计文档;没有修改颜色源码、宿主工程或界面。
审阅基线:`19b3d80039875d09b46f4418e6cfdddf0b0d036a`。审阅时 `Core/DYColorMath.h` 的 SHA-256 为 `4ce03351e3b93b94971e15f8b68d4448c98d8bd5308580595980ef399e5ad7aa`。功能来源和本机版本边界继续见 [迁移矩阵](colorfinale-2.0-matrix.md)。
## 1. 已有实现与需要保留的约束
当前 `DYGrade` 为 1032 字节,前 808 字节是旧参数 ABI;新增 224 字节为快捷 HSL、七个向量、RGB 曲线和通道矩阵。当前五点 `curve` 分别作用于 R/G/B,是 Master RGB 语义,不是真正的单独亮度曲线。RGB 曲线随后处理各通道。当前实际顺序是:
`曝光/白平衡 → lift/gain/midtone → 黑白点/对比/阴影高光/伽马 → Master RGB 曲线 → 各 RGB 曲线 → 饱和度 → 蜘蛛盘 → 快捷 HSL/向量 → 通道混合 → LUT → 局部处理/图层蒙版与混合`。
这条链已承载保存的用户画面。增加新工具时不得重新排列旧链、把现有曲线改解释为 Luma、把现有三色轮改解释为 CDL,或因图层的显示类型改变旧参数的意义。旧参数的默认旁路、alpha、CPU/Metal 共用数学和保存重开行为继续作为回归基线。
## 2. 参数、归档与渲染计划
建议冻结 `DYGrade` 的 1032 字节布局。可变节点和新增模式另存为 `DYAdvancedColorState`,以可安全归档的命名字段编码,挂在每个 `DYSettings` 的可选 `advancedColor` 键下;归档 schema 升为 5。不要把大数组、枚举或可变数量控制点继续追加进现有按整块 float 插值的区域。
| 项目 | 建议布局与默认值 |
| --- | --- |
| `DYAdvancedColorState` | `version=1`、`kind`、`enabled=false`,一个与 kind 匹配的工具状态;空值为严格恒等 |
| 工具身份 | `hsl_curves`、`log_wheels`、`camera_matrix`、`cdl`、`color_atlas`、`rgb_curves_v2`;复用外层稳定 layer ID |
| 曲线作者数据 | 每条曲线独立 ID、enabled、interpolation、domain、点列表;每点稳定 ID、x/y、左右切线或手柄;每条最多 32 点 |
| CPU/Metal 渲染头 | 显式 `uint32_t version, kind, flags, payloadIndex`;参数、曲线采样表与节点各自有长度校验;不要持久化平台指针、`BOOL` 或 `simd_float3` padding |
| 时间采样 | 固定标量仅在同工具版本间插值;曲线、节点数量、模式为离散快照,或仅在稳定点 ID 完全匹配时插值;禁止将枚举当 float 混合 |
| 颜色上下文 | 记录工作 RGB、传递函数/Log 编码、参考白、是否已经过输入变换;未知信息明确为 unknown,不能从画面观感猜测 |
新建高级工具层把原 `DYGrade` 留在恒等值,先走旧 grade,再执行该层高级算子,再接现有 LUT、局部处理、蒙版与层混合。已有层没有高级块,输出保持原样。高级工具排列由图层栈显式决定;不在后台把 Log 色轮、矩阵或 CDL 自动移动到别处。若同层保留旧参数和高级块,工具区需说明该内部顺序。RGB 曲线 v2 是独立新算子;旧 5 点曲线不被隐式搬移。
迁移要求:
1. 808 字节:先 `dyDefaultGrade()`,只拷贝 808 字节,再执行原迁移;新增颜色参数和高级块为恒等。1032 字节:完整保留原值,高级块为空。未知长度必须报错或明确保留原数据,不能按较短长度猜测结构。
2. schema 5 仍存 1032 字节 grade 和独立高级块。解码类表、深拷贝、相等比较、撤销、渲染快照、宿主证据读取、恢复工具同时更新。
3. 新读者遇到未知但启用的高级工具版本要拒绝静默丢弃。旧已发行程序不会因为新 writer 增加一个版本字段就自动学会拒绝;因此只承诺旧→新迁移,不承诺新文件可被旧程序正确打开。恢复说明标明最低版本。
4. 旧 808 与现有 1032 的真实归档、带 LUT/钢笔/轨迹的文档都建立画面对照。新格式保存再重开、随机时间、CPU 与 Metal 必须分别验证。
## 3. HSL 曲线
**官方证据。** 文档列出按色相调色相、饱和度、亮度,以及按亮度或饱和度调饱和度的五条曲线;支持独立旁路、取色加点及不同插值。正文中 Sat vs Luma 的横轴实际描述为亮度,大鱼应直接标成“亮度 → 饱和度”。公开页没有给出精确颜色转换、区间外推和样条系数。[官方 HSL Curves](https://docs.colorfinale.com/docs/layers/hsl/)
**建议参数。** `DYHSLCurvesState` 包含五个 `DYCurveState`、`extendedSaturation=false`、`mathVersion=1`。坐标和输出单位如下:
| 曲线 | x | y 与中性值 | 建议初始界限 |
| --- | --- | --- | --- |
| 色相 → 色相 | 周期 hue,0–1 turns | hue 位移,0 | ±0.5 turns |
| 色相 → 饱和度 | 周期 hue | 饱和度倍率,1 | 0–4 |
| 色相 → 亮度 | 周期 hue | 曝光位移 EV,0 | −4 至 +4 EV |
| 亮度 → 饱和度 | 层输入的归一化代码亮度 | 饱和度倍率,1 | 0–4 |
| 饱和度 → 饱和度 | 层输入的选定饱和度定义 | 饱和度倍率,1 | 0–4 |
上述 EV、倍率和界限是大鱼的独立选择,不是对 Color Finale 数值刻度的断言。工具名中的亮度不复用当前快捷 HSL 的 lightness 字段;两者的数学语义不同。
**建议评估。** 从该算子的同一输入一次性取 hue、saturation、亮度 Y。五条曲线全部以这些原始坐标取值,避免前一条曲线移动后一条的选择区域。色相位移后合成颜色,三个饱和度倍率相乘;在亮度为零的色差子空间缩放色差。最终目标亮度为 `Y × 2^EV(hue)`,通过下节的亮度恢复函数恢复。近中性像素用平滑色度权重抑制色相选择噪声;精确灰色只响应亮度型处理,不凭无定义 hue 生成染色。扩展模式保留额外色度,不在中间强制裁到 SDR;最终有限范围沿用现有渲染策略。
饱和度轴必须有固定定义并随 `mathVersion` 保存,建议第一版沿用当前 HSL 工具使用的归一化颜色基础;亮度轴明确采用当前工作空间的代码亮度。不要按每帧直方图自动拉伸坐标,否则随机跳帧和图库预览会改变结果。对超出 0–1 的亮度/饱和度选择坐标使用端点值,RGB 输出仍可超范围。
**曲线表示。** 提供线性、平滑逼近、平滑过点三种明确模式。平滑逼近可独立用三次 B 样条(de Boor),平滑过点可用受限 Hermite/Bezier。它们不是同一个算法的三个名称。x 必须严格递增,Bezier 手柄 x 不跨邻点;周期曲线使用首尾共享约束和虚拟邻点,保证接缝值与斜率连续。作者点原样保存,编辑后后台烘焙 4097 个 float 样本,CPU/Metal 共用相同表和插值。不能把采样表作为唯一可编辑文件。若误差门限未达到,再增加分辨率或改为分段系数。
**验收。** 连续色相环跨红色接缝;原始色相选择的顺序独立性;全部曲线旁路与中性值严格恒等;色相区间外不变;黑白端去饱和渐变平滑;B 样条不过点与过点模式确实不同;重排/删除点后无重复 x、NaN 或越界。查表与双精度直接求值对照,目标归一化误差 ≤2e−4,并以视觉渐变检查条带。CPU/Metal 允许最后量化误差不超过 1 个 8-bit 色阶,alpha 必须逐位保留。
## 4. RGB 曲线模式
**官方证据。** Master + RGB 对各 RGB 值共同套主曲线;Luma + RGB 的主曲线针对亮度;Luma Preserving 在调整 RGB 曲线时保持亮度。还支持取色建点及 S 曲线快捷操作。公开说明没有给出保持亮度的确切公式或 HDR 边界处理。[官方 Curves](https://docs.colorfinale.com/docs/layers/curves/)
**建议参数。** `DYRGBCurvesState { version, enabled, mode, master, red, green, blue }`。mode 为 `masterRGB / lumaRGB / lumaPreserving`。每条最多 32 点;默认 `(0,0),(1,1)`。所有通道拥有各自旁路状态;原 `curve[5]` 与 `rgbCurve[3][5]` 保留原模式和旧插值。
令 `Y(c)=dot(w,c)`,w 为当前工作空间亮度权重。定义独立辅助函数 `setLuma(c,target)`:当原 Y 大于正 epsilon 且 target 非负时按 `target/Y` 等比缩放 RGB;其余情况采用 `c + (target−Y)·1`,避免黑色、负值和除零引起色相翻转。此回退边界应连续化并版本固定;它是工程选择,不是原产品公式。
| 模式 | 明确处理顺序 |
| --- | --- |
| Master RGB | `m_k=Master(c_k)`,再 `out_k=RGB_k(m_k)` |
| Luma RGB | `target=Master(Y(c))`,`m=setLuma(c,target)`,再逐通道 RGB 曲线 |
| Luma Preserving | 同上得到 RGB 曲线结果 q,最后 `out=setLuma(q,target)` |
对黑/负亮度的 `setLuma` 建议最终实现采用有界平滑过渡,而不是在 epsilon 处硬切。要先确定此过渡再固定 mathVersion。曲线的区间外推第一版可采用端点斜率且限制极端斜率;旧五点曲线继续原端点偏移外推。取色只在当前冻结源帧和该层输入上建点,不能从已经过该层输出的屏幕颜色反复反馈。
**验收。** 同一 S 曲线在 Master RGB 与 Luma 模式具有可解释差异;Luma Preserving 改红曲线后 `dot(w,out)` 保持目标亮度;灰阶、接近黑色、负通道、HDR、同 x 重复点、极陡曲线都保持有限输出;旧归档仍调用旧五点路径。S 曲线快捷操作只建立普通可编辑点,没有额外隐形对比度参数。
## 5. Log 色轮
**官方证据。** 原工具有阴影、中间调、高光及 Offset,带亮度控制和范围分界;推荐位于 Log 转视频空间的层之前,并保持传入 Log 状态。文档没有公布具体区域权重或相机编码公式。[官方 Log Wheels](https://docs.colorfinale.com/docs/layers/log-wheels/)
**建议参数。** `DYLogWheelsState`:四组 `chroma[3]` 和 `brightness`,全部默认 0;`shadowEnd`、`shadowSoftness`、`highlightStart`、`highlightSoftness`;`domain=encodedLog`;独立 mathVersion。参数单位是输入 Log 的代码值偏移,不标作 EV。初始范围可取阴影过渡 `[0.20,0.40]`、高光过渡 `[0.60,0.80]`,但这些只是产品初始值,不代表任何相机标准。
在层输入的代码亮度 Y 上构造 `ws=1−smoothstep(s0,s1,Y)`、`wh=smoothstep(h0,h1,Y)`、`wm=1−ws−wh`,要求 `s0<s1≤h0<h1`。边界编辑自动保持最小间隔,令权重非负且总和 1。每个色轮的色差向量减去其加权亮度分量;最终:
`out = input + offsetChroma + offsetBrightness·1 + Σ weight_region × (regionChroma + regionBrightness·1)`。
四个色轮的二维位置与 RGB 数值是同一参数的两种编辑方式,不能保存两套可能不同步的真值。输入范围外仍使用端区权重,但不裁剪 RGB。中性参数直接返回输入。
当前宿主请求的是 gamma-video 图像;如果宿主或上游相机 LUT 已把素材转换成视频空间,新增一个叫 Log 的色轮不能恢复原始 Log。应把“输入保持 Log”的上下文条件接入色彩管理和层顺序,支持用户明确指定已有输入编码,不自动检测或偷偷反转换。先完成该前提,才报告 Log 工作流可用。可验证的初版是对明确声明的 Log 代码值做上述算子,不声称具备相机自动识别。
**验收。** 灰阶 ramp 显示三个区间的局部响应;分界处无阶跃;Offset 对全范围一致;保持 Log 输入、先色轮后 Log→709 LUT 与反向顺序确实不同且可撤销;导出随机帧不依赖播放顺序。用真实指定 Log 素材对照前,不以 SDR 画面“看起来正常”代替验收。
## 6. 相机矩阵
**官方证据。** 文档说明可独立调整 R/G/B 基色的 hue/saturation,并保持整体白平衡。它没有给出矩阵构建方式,也没有说明等于某家相机的 IDT 或校准矩阵。[官方 Camera Matrix](https://docs.colorfinale.com/docs/layers/camera-matrix/)
**建议参数。** `DYCameraMatrixState { enabled, hueTurns[3]={0}, saturation[3]={1}, preserveNeutral=true, mathVersion=1 }`。建议 hue 初始可编辑范围 ±1/6 turns,saturation 0–2;这些与当前九系数 `channelMixer` 是独立工具。保存控件值,在构建渲染计划时生成 3×3 矩阵,不在每个像素重新计算三角函数。
一个可验证的独立构造:令 `1=(1,1,1)^T`、`w^T·1=1`,e_i 是 R/G/B 基向量。先将每个基色分成 `w_i·1` 与零亮度色差 `q_i=e_i−w_i·1`。在与 w 正交的平面中旋转 q_i,再乘对应饱和度,得到候选列 `A_i=w_i·1+s_i·Rotate(q_i,2πh_i)`。旋转可用绕单位 w 轴的 Rodrigues 公式。最后施加投影:
`M = A + (1−A·1)·w^T`。
这个构造满足 `M·1=1`,因此所有中性灰保持;也满足 `w^T·M=w^T`,保持所选代码亮度。默认 A 和 M 均为单位阵。白平衡保持需要对其他基色作补偿,所以“独立控件”不表示其他 RGB 数值永远不变。矩阵可输出负值,不在算子内部硬裁色域;该边界由后续显示/输出处理承担。
此公式是大鱼设计推导,未从 Color Finale 反编译所得。矩阵的工作域、亮度权重及是否保持亮度须版本固定;后续接入不同 RGB 工作空间时,不能继续无条件使用 Rec.709 系数。
**验收。** 对随机允许参数验证 `M·1=1` 和 `w^T·M=w^T`;灰阶 −2…16 保持;单个主色控件变化方向稳定;默认严格恒等;CPU/Metal 矩阵排列一致;处理负输入和高亮不产生 NaN。不能把这些数学通过项说成相机色彩科学已校准。
## 7. CDL 交换
**官方证据。** Color Finale 色轮提供单个片段/色轮的 CDL 导入导出,交换 slope、offset、power、saturation。公开页没有承诺把整条时间线或任意工具堆栈压成一个 CDL。[官方 Color Wheels](https://docs.colorfinale.com/docs/layers/wheels/)
采用明确的独立 `DYCDLState { slope[3]={1}, offset[3]={0}, power[3]={1}, saturation=1, style, id, description }`。标准前向与不裁剪前向是不同 style;不能依据数值是否中性擅自改变 style。[ACES CLF 的 ASC_CDL 定义](https://docs.acescentral.com/clf/specification/#asc_cdl) 和 [OpenColorIO CDLTransform](https://opencolorio.readthedocs.io/en/stable/api/transforms.html#cdltransform) 可作为实现/对照依据。
标准前向按通道 `q=clamp(input×slope+offset,0,1)^power`,再以 Rec.709 权重得到 Y,输出 `clamp(Y+saturation×(q−Y),0,1)`。NoClamp 省略两处 clamp,且对 SOP 的负中间值跳过 power。slope≥0、power>0、saturation≥0,输入必须为有限数。标准 clamp 模式即使数值默认也会裁超范围值,因此不能把它优化成对 HDR 的无条件恒等;NoClamp 的默认值才可直接旁路。
第一版导入 `.cc`,以及从 `.ccc` 中选择一个明确 ID;若支持 `.cdl` 则解析其中的条目结构,不能仅按扩展名选择第一个 XML 节点。保存 ID/描述与十个数值,使用足够有效位数输出。禁用外部 XML 实体/网络解析,拒绝重复必须字段、非有限值和非法数量。参数读入不写入原文件。NoClamp style 若目标文件格式无法表达,导出界面明确其互操作限制,不用注释伪装标准字段。
当前三色轮并非直接的 CDL 数据。在其他工具全中性、没有不兼容范围饱和度、LUT、混合或蒙版时,单通道的代数近似可整理为:`slope=(1−lift)×(1+gain)`,`offset=lift×(1+gain)`,`power=1/(1+midtone)`。这只是当前公式的特定条件转换,仍须数值验证并检查非负 slope 等合法性。默认优先新增真正 CDL 工具层,精确保存交换参数。不能把任意调色结果压成十个数并声称无损。
**验收。** 用公开 CDL/CLF 的固定数值案例和独立 OCIO CPU 参考比较;SDR、负值、>1 输入、power=1、零 slope、零饱和度、非法 power 分别覆盖;导入→导出→再导入十个参数稳定;Unicode 描述和多 ID 选择正确;没有颜色管理上下文时不声称跨应用显示外观必然一致。旧三色轮转换另设输出误差检查,不与直接 CDL 往返混为一项。
## 8. Color Atlas 色调渐变映射
**官方证据。** 原工具最多 11 个 HSLA 渐变点,按 Rec.709 亮度、单个 R/G/B 通道或 CIE L* 选取渐变;包含结果、亮度图、渐变输出及取色/本地预设。公开页没有给出渐变插值色彩空间。[官方 Color Atlas](https://docs.colorfinale.com/docs/layers/color-atlas/)
**建议参数。** `DYColorAtlasState` 包含 `points[2…11]`、`tonalSource`、`outputMode`、`interpolation=RGBPremultiplied` 和 mathVersion。每点存稳定 ID、position、hueTurns、saturation、lightness、alpha。position 单调,端点固定 0/1,重复位置明确拒绝或作为同一次编辑替换;不让排序随机决定结果。默认两点 alpha=0,使新层恒等,这是大鱼的产品选择。
**建议评估。** 先从该层输入计算 tonal coordinate,范围外夹到端点。HSLA 只作为点颜色的编辑表示;第一版在当前明确工作 RGB 中对预乘色和 alpha 线性插值:`P=lerp(a0·RGB0,a1·RGB1,t)`、`A=lerp(a0,a1,t)`,结果为 `input×(1−A)+P`。这样完全透明的点不会污染相邻颜色。点 alpha 控制颜色覆盖量,仍保留素材的 alpha;之后还要乘图层蒙版/混合量,不能重复把素材 alpha 当点 alpha。原版是否采用同一插值仍未知。
Rec.709 代码亮度与 CIE L* 不可共用一个未经转换的 dot。L* 要先按已知传递函数得到线性 RGB,转到 XYZ 的相对 Y/Y_n,再按 CIE 分段立方根计算并除以 100。参考白与传递函数未知时,该模式应显示需要明确颜色空间,不能把 gamma RGB 直接代入公式。[W3C 颜色转换参考](https://www.w3.org/TR/css-color-4/#color-conversion-code)
`Result` 是正常映射;`Tonal Map` 输出所选坐标的灰阶;`Gradient` 按画面水平 x 展示渐变。这三个若作为输出模式保存,必须在宿主输出中一致生效。Gradient 依赖空间坐标,不可作为纯 RGB 变换烘焙进 3D LUT;工具区只看渐变的辅助视图则另设编辑状态,不改正式输出模式。5×5 取样应来自冻结的该层输入帧,记录所选色值后才提交一次撤销。
预设保存点、模式和版本,不保存路径依赖或偷用原版预设。预设缩略图的颜色上下文和当前图像结果分别标明。重命名/删除只针对用户当前选择的本产品预设。
**验收。** 单点插入、删除、重排、复制后的 ID;0/1 alpha、透明饱和色邻点的无色边;纯灰 ramp 的映射;R/G/B 不同输入源的差异;L*=0/100 与标准灰值;11 点上限;预设重开;三个输出模式、图层蒙版和素材 alpha 正确组合。
## 9. 实施顺序与完成门槛
建议先做高级工具归档/渲染快照,再做 CDL 与相机矩阵两个易获得确定参考的算子;随后 RGB 曲线 v2、HSL 曲线、Color Atlas;Log 色轮在输入域和转换顺序清晰后接入。工具在完整图层栈中的顺序由用户决定,以上仅是开发顺序。
每个算子至少有三类证据:数学性质或独立参考、CPU/Metal 数值一致、正式宿主实际画面与保存撤销。最小跨工具案例为:Log 色轮 → 输入转换 LUT → 相机矩阵 → RGB 曲线 → HSL 曲线 → Color Atlas;分别改变顺序、混合量、图层蒙版和 alpha,验证预览与最终结果共享同一快照。
必须保留的旧格式回归是:schema1/2/3 的 808 字节状态,以及 schema4 的 1032 字节状态,在新高级块为空时完全沿用旧数学。仅增加按钮、序列化字段或静态测试不能计为对应工具已完成。官方未公开的数学只可报告为独立实现;本机 Color Finale 2.16.2 的实际界面、刻度和输出仍需另行对照,不能由本设计补写成已经观察到的事实。
+96
查看文件
@@ -0,0 +1,96 @@
# ColorFinale 2.16.2 (625) 分析
分析日期:2026-10-25。目标是以可重复行为和算法结构为依据独立实现新插件;原程序保持只读。本报告只保存事实、接口与推断,不包含其二进制、预设/LUT/图标、可复用的反编译源码。
## 已核实身份与结构
- 外层 APP:`/Applications/ColorFinale.app`,Bundle ID `com.colorfinale.app`。
- FxPlug:`Contents/PlugIns/ColorFinale.pluginkit`,ID `com.colorfinale.ColorFinaleFxPlug`。
- 主插件可执行文件 SHA-256:`49121a6f5487060d322a59e7658166ab772e8a56f7dc1bcfa9d433a89436b30f`。
- Ghidra 12.1.4 对 arm64 片进行完整默认静态分析;这是静态观察,不代表在 FCP 中实际运行。
- 主插件管理 AppKit 自定义窗口、LUT 画廊、图层和跟踪;链接自带 `RenderingEngine`、`GradeKit`、`StepsKit`、`ColorFinaleUtils` 与 OpenCV。OpenCV 为产品自带依赖,不能把该二进制复制成新产品依赖。
## 局部跟踪:已观察到的算法链
核心函数:`FTAreaTracker::track:trackerState:`,地址 `0x100035e40`,Evidence `ev_dcd7aa770925f63c8c14c968ae6b417fda78685c7be7fa739a78209957d40e2d`。
1. 从形状点集的 convex hull 建立 8-bit 特征选取遮罩(fillPoly),特征限定在被跟踪形状区域。
2. `goodFeaturesToTrack`:最多 300 点,qualityLevel 0.03,minDistance 10,blockSize 3,不使用 Harris,k 0.04。
3. `cornerSubPix` 精炼:10×10 半窗,20 次/0.03 终止条件。
4. 对相邻灰度帧做前向和反向 `calcOpticalFlowPyrLK`:21×21 窗口,maxLevel=3,30 次/0.01 终止条件,minEigThreshold=0.0001。
5. 保留光流成功且前后向误差严格小于 1 像素的点。有效点少于 4 则返回失败,不继续制造位置。
6. 观察到另一组基于 `max(width,height) × 0.01` 位移阈值的点筛选;当大位移点超过有效点一半时偏向该组。其产品意图尚未运行证实,可能用于优先运动主体。
7. `estimateAffine2D`,method=8(OpenCV RANSAC 常量),reprojection threshold=3,maxIters=2000,confidence=0.99,refineIters=10。空矩阵失败。
8. 分解得到平移、旋转和 X/Y 缩放,围绕当前形状中心更新点集和状态。虽然拟合 full affine,持久化形状输出为位置/旋转/双轴缩放,未观察到透视单应矩阵输出。
9. 条件分支显示会周期性重新选取特征;精确刷新策略需运行比对后再定,不把它当作已验收功能。
逐帧入口:`FTAreaTracker::trackFrame:inScene:`,`0x100036cbc`,Evidence `ev_9131db4f8dcde696cbeb6659e1da62aa76fbdbd4329f22ab8695d32b57890b68`。
- 必须收到完整一帧后才分析。输入转 IOSurface,maxSize 为 3840×2160,再转灰度 OpenCV Mat。
- 每个跟踪节点单独保存状态;无有效节点则结束。
- 每帧把结果写入节点的 `position`、`rotation`、`scale` 动画属性;位置除以分析图像宽高归一化,时间使用 effectTime。
- 说明正确实现需要持久化按时间的轨迹,不能仅在实时渲染回调保留上一帧状态,否则非顺序渲染/导出会出错。
分析对接:`FTAreaTrackerAnalyzer::effectAnalysis:analyzeFrame:session:error:`,`0x10005b47c`,Evidence `ev_1dd68409d431d9e81875b6032a81dd89f7f237ea5501d3db1d7ca92ba32e6323`。
- 适配宿主 effectAnalysis 回调,按 session 色彩空间和 effectTime 建立 frame tile;先收集 tiles,再在完整帧上调用 tracker。
- 有取消、越过片段范围、无效图像、分析结束状态;不能把失败继续当跟踪成功。
交互模式:`FTAreaTrackerController::setTrackerModeForSession:from:to:`,Evidence `ev_a455d8cd5a459e3f95e5a5c7ca4d8837481d31266ae1ee51901bc7091a3e8fac` 根据起止时间和一帧时长区分前向/后向连续跟踪及单帧步进。`FTShapeTrackerControl::trackForwardFrame:`,Evidence `ev_a3edfabaaaeb8ab7545ded0b4d392e65e39062180c60d2262363a35d9a88e803` 显示有选中形状才跟踪;自动跟踪进行时阻止再次启动。
## LUT 批量预览:已观察到的渲染与缓存
`FTLUTGalleryItem::processFrameTile:context:`,`0x1000d0b28`,Evidence `ev_f502284708e116a00f22144b4489ab51665c389f92f577e33801100da6b62af5`:
- 每个 gallery item 通过 LUT 标识从 CubeManager 请求 `previewMode` 数据。
- 建立独立 CubeFx,使用 item 的预览工作色彩空间,渲染到输入 frame tile。
- 画廊与实际 LUT 强度控件应共用解析和渲染链,避免预览与最终效果不同。
`FTAssetGalleryImageCache::renderPreviewImageForAsset:`,`0x1000f9c0c`,Evidence `ev_fe5a0a660188eb8f7be89bbc46b3e496be9b38f84643ef283339ad20c8090d5f`:
1. 获取并缓存 sourceFrame。
2. 获取当前项目 scene/adjustments。
3. 先应用工程已有调整。
4. 再应用每个待预览 LUT/asset。
5. 转输出色彩空间、处理方向,再建立 NSImage。
6. source 或渲染无效返回失败,不以空白图冒充已生成结果。
`FTAssetGalleryImageCache::fetchSourceFrame`,`0x1000f9fdc`,Evidence `ev_7c9c47eb6708f3d7003cffc1c1de8b01aeb083c59961d67d52b77dc4eac7da16`:支持 live 当前片段帧,以及用户指定默认图片。静态图片明确使用 sRGB。live 模式通过宿主 action session 请求片段帧。
`FTAssetGalleryImageCache::init`,Evidence `ev_8ffc0ac45b90bfb4aee21319d4e4627b726416957325c92b4c77be938c745e82`:NSCache 的 totalCostLimit=0x20000000(512 MiB);另有 `FTPriorityOperationQueue`,非 LIFO,QoS 0x19。`generateImageForAsset:`,Evidence `ev_65fcaf5901400eb9a82486bd4fc18775a32e404f7731b943c6ee3ffd997b1d69` 将工作封装 NSBlockOperation 投入队列。`cacheKeyForAsset:` 使用 live 状态和 asset renderKey(Exact key format 未恢复)。
LUT 元数据/图库搜索 Evidence `ev_52ed9e7aff017b889468b9b0f901f73a44e6fa7a5de8a45825ed5f913b6c7689`;图库方法显示最近使用、按组/文件夹、搜索过滤、选择预览色彩空间、注册文件夹、检测失效路径及重新链接。当前版本具体支持的 LUT 文件格式、插值方法和 domain 边界尚未进入 RenderingEngine/GradeKit 定点分析,不能据名称宣称支持。
## 自定义 UI:结构证据与独立设计
- AppKit 的 FTColorCorrectionWindowController 及 FTRemoteColorCorrectionWindowController 提供独立自定义窗口;后者背景使用 white≈0.122、alpha=1。Evidence `ev_590a46e741638ab2be5dd0da9f0c739a3d82f87e8a181d0546d64731adc081de`。
- FTColorCorrectionViewController 持有图层控制器、当前工具 viewHost,可切 Curves、Telecine/Color Wheels、Six Vectors、Cube、HSL Curves、Mask、Filter、Camera Matrix、Log Wheels;有添加层/组、LUT层、undo/redo、mask选择等入口。Evidence `ev_1631c9fca7d9780ee93449341856f7816ff1a31a2051e1dac93bbed07291bc84`。这是结构观察,未做屏幕布局验收。
- 局部形状控制器有 opacity、feather、position、scale、rotation 控件;ShapeTrackerTimeline 支持按时间选择、关键帧和区域绘制、单帧/连续跟踪。Evidence `ev_511921a9b7511facedd4f9ddf5e6cee2680de4c55dbf726a0d4f2a3b05d1cd14` 和 `ev_3cdbe7c6cd89c47105df02ef6c0019377646eca014c758b21a988d70b9164b8b`。
建议新 UI 保留暗色浮动窗口、工具切换、清晰图层栈和图像直接编辑:左侧图层/局部区域,中间画面与可拖拽形状,右侧调色/蜘蛛盘/LUT画廊/跟踪页;底部当前时间、关键帧、前后跟踪与取消。颜色、图标、布局和文案重新设计,不复制原产品资源。是否采用左右三栏属于新产品设计选择,不是 ColorFinale 运行观测。
## 对新工程的实现建议与验收边界
- 采用自行构建的官方 OpenCV 或独立实现特征+LK+RANSAC;不链接 ColorFinale 内置 framework。跟踪算子与 FxPlug/UI 分层,先用给定航拍跑完整轨迹,再把相同轨迹作为宿主分析结果保存。
- 持久化每个局部节点的初始区域、时间/矩阵/置信度/失效状态。渲染只按当前时间采样已烘焙轨迹。支持前后向重算、取消、失效手动校正和再次继续。
- 最小局部形状先做旋转椭圆、矩形/圆角矩形与多边形,含羽化/反相/透明度;不要把“整个画面自动平移”宣称为局部跟踪。
- LUT 初版用公开 .cube 规范独立解析;DOMAINS、1D/3D、强度、越界政策写清楚并做数值测试。预览以当前帧为共同输入,缓存需包含帧ID/调整快照/色彩空间/LUT内容摘要和尺寸,滚动时取消过时任务。
- 航拍验收至少选清晰静态建筑和一处边界区域,覆盖运动、旋转/缩放、遮挡或低纹理;输出叠加跟踪轮廓的连续片段并检查尾帧漂移。只在几帧上画标记不能证明整段跟踪成功。
- 仍未完成:ColorFinale 实际运行 UI 对照、LUT 插值内核、遮罩合成数学、在给定 DJI 素材上的原产品基准轨迹。新插件的行为验收不应冒充与原算法逐像素等价。
## 本地完整证据
完整 REA Evidence bundle 与 snapshot 含反编译中间产物,仅保存在本机研究缓存,不进入源码仓库:
- `/Users/mac/Library/Caches/CodexBuilds/ColorResearch/colorfinale-rea-evidence-20261025.json`(22 records)
- `/Users/mac/Library/Caches/CodexBuilds/ColorResearch/colorfinale-rea-snapshot-20261025.json`
本报告中的观测可依上述 SHA、函数地址和证据 ID 重做。REA 会话已关闭。
## 宿主接入的补充定点证据
文件选择入口取得 self.view.window 并调用 beginSheetModalForWindow。新面板采用宿主附属面板,修复独立 begin 调用在远程窗口中的焦点问题。
RenderTrigger 参数 201 为 NSUUID 自定义参数,标志 0x3(HIDDEN、NOT_ANIMATABLE),没有 DONT_SAVE;通知参数 200 的 0x13 另含 DONT_SAVE。201 位于顶层通知参数之后,原生模板并不显式保存它。捕获对象按插件实例持有期望时间及会话令牌,渲染时从源图像取帧并回主线程交给面板。
依据是只读创建函数与帧捕获调用链。本机追加记录为 ColorResearch/colorfinale-rendertrigger-facts.json、colorfinale-file-dialog-evidence-20261026.json、colorfinale-frame-capture-evidence-20261026.json;文件名后缀沿用采集名称。新插件独立实现隐藏 NSUUID 刷新通知与实例内会话标记,最终 FCP 首次打开、当前帧刷新和重开已实际通过。
@@ -0,0 +1,422 @@
{
"date": "2026-10-25",
"scope": "ColorFinale 2.16.2(625) static arm64 analysis",
"full_evidence_local_only": "/Users/mac/Library/Caches/CodexBuilds/ColorResearch/colorfinale-rea-evidence-20261025.json",
"limitations": [
"Static observation does not establish runtime behavior or exact source equivalence.",
"This compact index intentionally omits proprietary disassembly and decompiler pseudocode."
],
"records": [
{
"key": "0x100035e40",
"evidence_id": "ev_dcd7aa770925f63c8c14c968ae6b417fda78685c7be7fa739a78209957d40e2d",
"operation": "analyze_function",
"parameters": {
"procedure": "0x100035e40"
},
"subject": {
"name": "ColorFinale",
"digest": {
"sha256": "49121a6f5487060d322a59e7658166ab772e8a56f7dc1bcfa9d433a89436b30f"
},
"local_path": "/Applications/ColorFinale.app/Contents/PlugIns/ColorFinale.pluginkit/Contents/MacOS/ColorFinale",
"format": "mach-o-universal",
"architecture": "arm64"
},
"confidence": "observed",
"authority": "shipped-artifact"
},
{
"key": "0x100036cbc",
"evidence_id": "ev_9131db4f8dcde696cbeb6659e1da62aa76fbdbd4329f22ab8695d32b57890b68",
"operation": "analyze_function",
"parameters": {
"procedure": "0x100036cbc"
},
"subject": {
"name": "ColorFinale",
"digest": {
"sha256": "49121a6f5487060d322a59e7658166ab772e8a56f7dc1bcfa9d433a89436b30f"
},
"local_path": "/Applications/ColorFinale.app/Contents/PlugIns/ColorFinale.pluginkit/Contents/MacOS/ColorFinale",
"format": "mach-o-universal",
"architecture": "arm64"
},
"confidence": "observed",
"authority": "shipped-artifact"
},
{
"key": "0x100037334",
"evidence_id": "ev_25164340a58fb486f874b3a4d0396413aeb35dd07b78c80303d750ee2a795eed",
"operation": "analyze_function",
"parameters": {
"procedure": "0x100037334"
},
"subject": {
"name": "ColorFinale",
"digest": {
"sha256": "49121a6f5487060d322a59e7658166ab772e8a56f7dc1bcfa9d433a89436b30f"
},
"local_path": "/Applications/ColorFinale.app/Contents/PlugIns/ColorFinale.pluginkit/Contents/MacOS/ColorFinale",
"format": "mach-o-universal",
"architecture": "arm64"
},
"confidence": "observed",
"authority": "shipped-artifact"
},
{
"key": "0x10005b47c",
"evidence_id": "ev_1dd68409d431d9e81875b6032a81dd89f7f237ea5501d3db1d7ca92ba32e6323",
"operation": "analyze_function",
"parameters": {
"procedure": "0x10005b47c"
},
"subject": {
"name": "ColorFinale",
"digest": {
"sha256": "49121a6f5487060d322a59e7658166ab772e8a56f7dc1bcfa9d433a89436b30f"
},
"local_path": "/Applications/ColorFinale.app/Contents/PlugIns/ColorFinale.pluginkit/Contents/MacOS/ColorFinale",
"format": "mach-o-universal",
"architecture": "arm64"
},
"confidence": "observed",
"authority": "shipped-artifact"
},
{
"key": "0x1000d0b28",
"evidence_id": "ev_f502284708e116a00f22144b4489ab51665c389f92f577e33801100da6b62af5",
"operation": "analyze_function",
"parameters": {
"procedure": "0x1000d0b28"
},
"subject": {
"name": "ColorFinale",
"digest": {
"sha256": "49121a6f5487060d322a59e7658166ab772e8a56f7dc1bcfa9d433a89436b30f"
},
"local_path": "/Applications/ColorFinale.app/Contents/PlugIns/ColorFinale.pluginkit/Contents/MacOS/ColorFinale",
"format": "mach-o-universal",
"architecture": "arm64"
},
"confidence": "observed",
"authority": "shipped-artifact"
},
{
"key": "0x1000f9800",
"evidence_id": "ev_65678a6c0f431360264b375b867ee99dd57c3baf21c77a3a4d3343e2eb604277",
"operation": "analyze_function",
"parameters": {
"procedure": "0x1000f9800"
},
"subject": {
"name": "ColorFinale",
"digest": {
"sha256": "49121a6f5487060d322a59e7658166ab772e8a56f7dc1bcfa9d433a89436b30f"
},
"local_path": "/Applications/ColorFinale.app/Contents/PlugIns/ColorFinale.pluginkit/Contents/MacOS/ColorFinale",
"format": "mach-o-universal",
"architecture": "arm64"
},
"confidence": "observed",
"authority": "shipped-artifact"
},
{
"key": "0x1000f9c0c",
"evidence_id": "ev_fe5a0a660188eb8f7be89bbc46b3e496be9b38f84643ef283339ad20c8090d5f",
"operation": "analyze_function",
"parameters": {
"procedure": "0x1000f9c0c"
},
"subject": {
"name": "ColorFinale",
"digest": {
"sha256": "49121a6f5487060d322a59e7658166ab772e8a56f7dc1bcfa9d433a89436b30f"
},
"local_path": "/Applications/ColorFinale.app/Contents/PlugIns/ColorFinale.pluginkit/Contents/MacOS/ColorFinale",
"format": "mach-o-universal",
"architecture": "arm64"
},
"confidence": "observed",
"authority": "shipped-artifact"
},
{
"key": "0x1000f9fdc",
"evidence_id": "ev_7c9c47eb6708f3d7003cffc1c1de8b01aeb083c59961d67d52b77dc4eac7da16",
"operation": "analyze_function",
"parameters": {
"procedure": "0x1000f9fdc"
},
"subject": {
"name": "ColorFinale",
"digest": {
"sha256": "49121a6f5487060d322a59e7658166ab772e8a56f7dc1bcfa9d433a89436b30f"
},
"local_path": "/Applications/ColorFinale.app/Contents/PlugIns/ColorFinale.pluginkit/Contents/MacOS/ColorFinale",
"format": "mach-o-universal",
"architecture": "arm64"
},
"confidence": "observed",
"authority": "shipped-artifact"
},
{
"key": "0x1000f9938",
"evidence_id": "ev_65fcaf5901400eb9a82486bd4fc18775a32e404f7731b943c6ee3ffd997b1d69",
"operation": "analyze_function",
"parameters": {
"procedure": "0x1000f9938"
},
"subject": {
"name": "ColorFinale",
"digest": {
"sha256": "49121a6f5487060d322a59e7658166ab772e8a56f7dc1bcfa9d433a89436b30f"
},
"local_path": "/Applications/ColorFinale.app/Contents/PlugIns/ColorFinale.pluginkit/Contents/MacOS/ColorFinale",
"format": "mach-o-universal",
"architecture": "arm64"
},
"confidence": "observed",
"authority": "shipped-artifact"
},
{
"key": "0x1000f9390",
"evidence_id": "ev_8ffc0ac45b90bfb4aee21319d4e4627b726416957325c92b4c77be938c745e82",
"operation": "analyze_function",
"parameters": {
"procedure": "0x1000f9390"
},
"subject": {
"name": "ColorFinale",
"digest": {
"sha256": "49121a6f5487060d322a59e7658166ab772e8a56f7dc1bcfa9d433a89436b30f"
},
"local_path": "/Applications/ColorFinale.app/Contents/PlugIns/ColorFinale.pluginkit/Contents/MacOS/ColorFinale",
"format": "mach-o-universal",
"architecture": "arm64"
},
"confidence": "observed",
"authority": "shipped-artifact"
},
{
"key": "0x100059c40",
"evidence_id": "ev_a455d8cd5a459e3f95e5a5c7ca4d8837481d31266ae1ee51901bc7091a3e8fac",
"operation": "analyze_function",
"parameters": {
"procedure": "0x100059c40"
},
"subject": {
"name": "ColorFinale",
"digest": {
"sha256": "49121a6f5487060d322a59e7658166ab772e8a56f7dc1bcfa9d433a89436b30f"
},
"local_path": "/Applications/ColorFinale.app/Contents/PlugIns/ColorFinale.pluginkit/Contents/MacOS/ColorFinale",
"format": "mach-o-universal",
"architecture": "arm64"
},
"confidence": "observed",
"authority": "shipped-artifact"
},
{
"key": "0x100022194",
"evidence_id": "ev_a3edfabaaaeb8ab7545ded0b4d392e65e39062180c60d2262363a35d9a88e803",
"operation": "analyze_function",
"parameters": {
"procedure": "0x100022194"
},
"subject": {
"name": "ColorFinale",
"digest": {
"sha256": "49121a6f5487060d322a59e7658166ab772e8a56f7dc1bcfa9d433a89436b30f"
},
"local_path": "/Applications/ColorFinale.app/Contents/PlugIns/ColorFinale.pluginkit/Contents/MacOS/ColorFinale",
"format": "mach-o-universal",
"architecture": "arm64"
},
"confidence": "observed",
"authority": "shipped-artifact"
},
{
"key": "0x10012bd10",
"evidence_id": "ev_6b1b786733d22da9b5a67b16b8d2bcea1432d1352e0f86bccf01894b36e973a9",
"operation": "analyze_function",
"parameters": {
"procedure": "0x10012bd10"
},
"subject": {
"name": "ColorFinale",
"digest": {
"sha256": "49121a6f5487060d322a59e7658166ab772e8a56f7dc1bcfa9d433a89436b30f"
},
"local_path": "/Applications/ColorFinale.app/Contents/PlugIns/ColorFinale.pluginkit/Contents/MacOS/ColorFinale",
"format": "mach-o-universal",
"architecture": "arm64"
},
"confidence": "observed",
"authority": "shipped-artifact"
},
{
"key": "0x1000a36d8",
"evidence_id": "ev_d50e89c3f20e92c5211af1eb1946a5515da3cd4b2fd37c35a10545d8bd2e544b",
"operation": "analyze_function",
"parameters": {
"procedure": "0x1000a36d8"
},
"subject": {
"name": "ColorFinale",
"digest": {
"sha256": "49121a6f5487060d322a59e7658166ab772e8a56f7dc1bcfa9d433a89436b30f"
},
"local_path": "/Applications/ColorFinale.app/Contents/PlugIns/ColorFinale.pluginkit/Contents/MacOS/ColorFinale",
"format": "mach-o-universal",
"architecture": "arm64"
},
"confidence": "observed",
"authority": "shipped-artifact"
},
{
"key": "0x10010aa0c",
"evidence_id": "ev_590a46e741638ab2be5dd0da9f0c739a3d82f87e8a181d0546d64731adc081de",
"operation": "analyze_function",
"parameters": {
"procedure": "0x10010aa0c"
},
"subject": {
"name": "ColorFinale",
"digest": {
"sha256": "49121a6f5487060d322a59e7658166ab772e8a56f7dc1bcfa9d433a89436b30f"
},
"local_path": "/Applications/ColorFinale.app/Contents/PlugIns/ColorFinale.pluginkit/Contents/MacOS/ColorFinale",
"format": "mach-o-universal",
"architecture": "arm64"
},
"confidence": "observed",
"authority": "shipped-artifact"
},
{
"key": "cflut",
"evidence_id": "ev_52ed9e7aff017b889468b9b0f901f73a44e6fa7a5de8a45825ed5f913b6c7689",
"operation": "search_procedures",
"parameters": {
"pattern": "FTAssetGalleryImageCache|FTLUTGallery|FTLUTManager|FTLUTList",
"mode": "regex",
"case_sensitive": false
},
"subject": {
"name": "ColorFinale",
"digest": {
"sha256": "49121a6f5487060d322a59e7658166ab772e8a56f7dc1bcfa9d433a89436b30f"
},
"local_path": "/Applications/ColorFinale.app/Contents/PlugIns/ColorFinale.pluginkit/Contents/MacOS/ColorFinale",
"format": "mach-o-universal",
"architecture": "arm64"
},
"confidence": "observed",
"authority": "shipped-artifact"
},
{
"key": "cfui",
"evidence_id": "ev_3cdbe7c6cd89c47105df02ef6c0019377646eca014c758b21a988d70b9164b8b",
"operation": "search_procedures",
"parameters": {
"pattern": "FTColorCorrectionPanel|FTShapeTracker|FTAssetGalleryViewController::viewDidLoad|FTAssetGalleryImageCache::init",
"mode": "regex",
"case_sensitive": false
},
"subject": {
"name": "ColorFinale",
"digest": {
"sha256": "49121a6f5487060d322a59e7658166ab772e8a56f7dc1bcfa9d433a89436b30f"
},
"local_path": "/Applications/ColorFinale.app/Contents/PlugIns/ColorFinale.pluginkit/Contents/MacOS/ColorFinale",
"format": "mach-o-universal",
"architecture": "arm64"
},
"confidence": "observed",
"authority": "shipped-artifact"
},
{
"key": "ui",
"evidence_id": "ev_ae6bbce355d8eae5aae27866d61d5a1628370d7c6694701517f459f6c0e37910",
"operation": "search_procedures",
"parameters": {
"pattern": "FT.*(Panel|WindowController|Inspector).*::(viewDidLoad|windowDidLoad|init|show|make|load)",
"mode": "regex",
"case_sensitive": false
},
"subject": {
"name": "ColorFinale",
"digest": {
"sha256": "49121a6f5487060d322a59e7658166ab772e8a56f7dc1bcfa9d433a89436b30f"
},
"local_path": "/Applications/ColorFinale.app/Contents/PlugIns/ColorFinale.pluginkit/Contents/MacOS/ColorFinale",
"format": "mach-o-universal",
"architecture": "arm64"
},
"confidence": "observed",
"authority": "shipped-artifact"
},
{
"key": "trackmode",
"evidence_id": "ev_b6979fd3eed28bfc381f93bedb578647444c2b213a44a3d2fbf1ac51b0a355ff",
"operation": "search_procedures",
"parameters": {
"pattern": "setTrackerModeForSession",
"mode": "literal",
"case_sensitive": false
},
"subject": {
"name": "ColorFinale",
"digest": {
"sha256": "49121a6f5487060d322a59e7658166ab772e8a56f7dc1bcfa9d433a89436b30f"
},
"local_path": "/Applications/ColorFinale.app/Contents/PlugIns/ColorFinale.pluginkit/Contents/MacOS/ColorFinale",
"format": "mach-o-universal",
"architecture": "arm64"
},
"confidence": "observed",
"authority": "shipped-artifact"
},
{
"key": "cfccvc",
"evidence_id": "ev_1631c9fca7d9780ee93449341856f7816ff1a31a2051e1dac93bbed07291bc84",
"operation": "search_procedures",
"parameters": {
"pattern": "FTColorCorrectionViewController",
"mode": "literal",
"case_sensitive": false
},
"subject": {
"name": "ColorFinale",
"digest": {
"sha256": "49121a6f5487060d322a59e7658166ab772e8a56f7dc1bcfa9d433a89436b30f"
},
"local_path": "/Applications/ColorFinale.app/Contents/PlugIns/ColorFinale.pluginkit/Contents/MacOS/ColorFinale",
"format": "mach-o-universal",
"architecture": "arm64"
},
"confidence": "observed",
"authority": "shipped-artifact"
},
{
"key": "cflayermask",
"evidence_id": "ev_511921a9b7511facedd4f9ddf5e6cee2680de4c55dbf726a0d4f2a3b05d1cd14",
"operation": "search_procedures",
"parameters": {
"pattern": "FTLayersViewModel|FTMaskShapeViewController",
"mode": "regex",
"case_sensitive": false
},
"subject": {
"name": "ColorFinale",
"digest": {
"sha256": "49121a6f5487060d322a59e7658166ab772e8a56f7dc1bcfa9d433a89436b30f"
},
"local_path": "/Applications/ColorFinale.app/Contents/PlugIns/ColorFinale.pluginkit/Contents/MacOS/ColorFinale",
"format": "mach-o-universal",
"architecture": "arm64"
},
"confidence": "observed",
"authority": "shipped-artifact"
}
]
}