文件
dayu-color/research/ColorFinaleMasksFollowup.md
T

7.7 KiB
原始文件 Blame 文件历史

Color Finale 蒙版与跟踪的本机复核(2026-11-01)

本轮针对用户报告的“层在最底部新增、蒙版控件太小、钢笔不可用”核对本机发行产物。目标为 ColorFinale 2.16.2(625)的 arm64 插件,完整文件 SHA-256 49121a6f5487060d322a59e7658166ab772e8a56f7dc1bcfa9d433a89436b30f,与此前归档研究一致。原程序始终只读,未执行或操作其 FCP 界面。静态观察不是运行行为验收,也不能据此声称整个原版功能已完整迁移。

这里只保存行为、接口、参数和 Evidence 索引,不保存原版反编译源码、二进制、图标或其他资源。新功能仍是本产品自己的源码与 Metal 实现,不依赖 Color Finale 安装。

钢笔状态与可迁移交互

本机静态观察 入口与 Evidence
选择 Bezier 新建模式后,首次点击建立可编辑/选中的零尺寸路径,交给新路径处理该点击,随后进入独立的路径编辑模式 FTShapeTrackerView::addShapeForEvent: 0x1000e2900,ev_6539e1080a6e0d9cf27d9cb3c26703110b8f50030981b18cc075356840849e08
新建与编辑路径是不同模式;离开路径编辑模式会尝试闭合当前路径 setShapeEditMode: 0x1000e1fcc,ev_0f9372e98efac18d8f666dcf137addc2ecdaffdfdb153f0a31b3ecfc2ba8b9ca
编辑态可向未闭合路径追加锚点,也有在曲线上插点的分支;放置后可拖出共线双柄 FTOnScreenBezierShape::mouseDown: 0x10009be0c,ev_2dd4ac418346bd4d15d05f8145bb2a547ab531d742b4e8edfb3314fc49fdde0a;FTShapeBezierControlPoint::controlPoint:mouseDragged: 0x10009d178,ev_ba0c6d39ae45e26b8ade69f41f6fb8da934c526a686e64be89690b762a11e585
未闭合且至少三个点才允许闭合;点击首锚点会闭合 FTOnScreenPathShape::closePath 0x100033ec8,ev_4c3864a55c7dc71ee02b67c4eed011dbe00a9d8072c275ff002607d22618c288;controlPoint:mouseDown: 0x10003429c,ev_2fc54b9d31f2ac894aae0b560fee33284a155fe6505697c0a83be1af0bc0a8ea
原版未闭合路径接收 Return 或 Esc 时均尝试闭合;Delete 删除选中锚点 FTOnScreenPathShape::keyDown: 0x1000345c8,ev_d3bea253005ee2007c110f15d6658e542de8f2075d40585897b875f9b517ec2b
画面工具栏有选择、路径编辑、矩形、椭圆、渐变边、B 样条、Bezier;预览按钮原生最小尺寸为30×22,另有8×8内边距 FTShapeTrackerControl::addToolbarButtons 0x10001ef7c,ev_ea178e24d10afea13fa74a0d70941648d1ca4c45005a1533df478c9212f6f9b7

大鱼本轮保留明确的“Esc取消草稿”行为,与原版“Esc尝试结束闭合”不同。不能把新实现描述为所有快捷键均完全相同。当前产品旧钢笔入口未携带绘制态,且通知会清除绘制态;即使菜单项存在,也不能证明进入了放点模式。修复应同时覆盖绘制态、首点/Return结束、删除、草稿预览、提交和取消,以及再次选择已有路径的编辑。

形状属性控制器将 feather、opacity、position、scale、rotation 绑定到对应作者属性,见 FTMaskShapeViewController::viewDidLoad 0x10007f3b0,Evidence ev_533595e2ddf4c96d5c82f3ce25c7ff44a3549f37d8b80e5b5b5a82360e283c77。完整检视器字号和运行时像素布局未取得充分静态证据;不能从符号名称推断其可读性。

跟踪差异与本轮改进

原版核心 FTAreaTracker::track:trackerState: 0x100035e40,Evidence ev_dcd7aa770925f63c8c14c968ae6b417fda78685c7be7fa739a78209957d40e2d。逐帧作者状态 Evidence ev_e798c4e6e032e085812f81831ecc16196bd3c2278bf634961379669ee1308f7e(0x100036cbc)。原版每帧接收完整图像、最多3840×2160转换为8位灰度,将 position/rotation/scale 按 effectTime 写入作者键,不是渲染时临时估计。当前大鱼已经有精确时间键、相邻帧参考、丢失停止和这些变换输出;这些并非本轮才补齐。

项目 原版静态观察 大鱼1.4.0(24)与本轮选择
区域 用形状点的凸包构造特征遮罩 原有实际多边形判断更贴合凹路径,但包围框和前置±0.5裁剪错误。本轮改为从实际路径顶点推导变换后搜索边界,保留实际多边形判断,修复默认框外钢笔纹理被裁掉的问题
特征 300点,quality0.03,最小距离10,blockSize3 原有180点、0.012相对阈值、按帧大小变化的间距、5×5邻域。本轮调整为300点、0.03、10像素、3×3;仍采用独立中心差分与2像素候选扫描,并不等同OpenCV检测器
角点精炼 cornerSubPix 半窗10,20次/0.03 原有无亚像素精炼。本轮用独立加权梯度交点迭代,半窗10、20次/0.03,限制发散并保留初始点回退;不是复制OpenCV内部实现
光流 LK21×21,maxLevel3即最多4级,30次/0.01;前后误差严格小于1 原有9×9、最多5级、20次。本轮CPU和Metal统一21×21、最多4级、30次/0.01;保留原有均值去除、RMSE及≤1.1像素前后检查,不声称数值全等
重检测 分析计数小于2或偶数时重检测并精炼 原有每5帧或少于60点补点。本轮每2帧或不足60时重选;新点少于12时保留仍可信旧点,后续仍须通过完整拟合/失效条件
拟合 estimateAffine2D RANSAC2000次、阈值3、confidence0.99、refine10 本轮保留确定性400次、1.6/1.5阈值、3次最小二乘、至少8点/52%内点与非线状分布检查。阈值不能无验证地照搬,否则可能把错误帧当作成功
输出/失效 原版持久化位置、旋转和独立XY缩放,失败节点不再继续 大鱼保持QR分解位置/旋转/独立XY缩放,丢失停止、置信度和每步缩放/旋转保护。它比已观察到的原版分支更保守,不含透视或剪切输出

独立检查 tools/verify_tool_tracking_followup.mm 使用已知仿射变换生成图像,分别运行CPU和真实Metal后端。默认创建框外的钢笔区域在旧提交 745aa1626e1df368290fbbd47a716ff3ce9ca630 检出0点、无法启动;新版本检出117点,12帧亚像素移动末帧误差约X0.0073/Y0.0323像素。另覆盖300点实际传输、旋转与非等比缩放、静止重检测、换景拒绝、平坦区域拒绝,以及1920×1080/3840×2160完整帧。18项通过;4K生成两帧及分析本机记录约CPU111ms/Metal89ms,不是所有素材的性能承诺。

“完整移植”的边界

本轮是可验证的独立重建与关键交互修复,不能宣称完整复制Color Finale蒙版系统。原版还观察到B样条、形状多选/编组、父蒙版、图像/人物/宿主外部蒙版、HSL取色增减与来源/模糊、发布蒙版/抠出、轨迹区域选择与按键区段编辑等体系;当前大鱼每工具六类蒙版不具备全部对应能力。FTMaskDetailViewController 的形状、HSL、图像、人物、FCP控制器方法库存见 Evidence ev_0497fc6415b6b210fea8a052adf0f93483af228b44063dffd2c76d93a990cef1。大鱼独立“亮度选区”不能据此称为已复刻原版某个独立Luma类;本次主插件范围没有取得该类的充分证据。

算法阈值及默认值对齐不是对真实视频的等价证明。本轮尚未取得原版与大鱼在同一真实视频、相同路径及分析范围下的完整轨迹对照,也未分析原版所有链接框架和动态形状UI。完整范围继续由差异清单追踪,不能把当前故障修复或合成检查通过替代这些开放项。

完整REA证据和恢复snapshot仅在本机研究缓存:/Users/mac/Library/Caches/CodexBuilds/ColorResearch/dayu-mask-followup-20261101/。当前REA目标已关闭,原产物未修改。Interface Builder decoder默认64文档首先遍历Sparkle,未覆盖后续蒙版nib;不能把该局限解释为蒙版UI不存在。新摘要保留此未知,不复制原版资源作为新产品界面。