文件
dayu-color/research/SpiderAndBalanceIntegration.md

2.4 KiB

蜘蛛盘和一级白平衡色轮的移植

参考仓库只读,来源节点及逐文件 SHA-256 在 SpiderAndBalanceSources.json;生产构建只使用当前仓库内的源码、图像与 Metal 资源。

蜘蛛盘

复用“大鱼调色盘”的可变网格、交互和 CPU/Metal 数学。新实例为 6×6(31 个节点),色相与饱和度点数可联动或独立选择 6、8、12、16、24。保留单点同列自由点联动、固定点仍可直接拖动、⌘ 多选、Shift 固定、框选、整环/整列选择、右键复位与键盘微调。

本项目的 AppKit 适配遵循原工程的手动内存管理,网格仍使用原始结构。中性网格在生产渲染中精确直通;变形网格在既有调色链后运行原始 dyVariableSpider 和 dyLimit,透明度按原预乘边界处理。眼睛和混合控制独立于折叠,Cube 导出复用相同路径。

网格、固定点、密度及联动状态保存在现有 DYAssetState 自定义参数中。预设 schema 3 增加 JSON 蜘蛛盘数据,旧预设恢复为中性新盘;旧模型和参数 ID 继续注册。主线程只写小型状态,渲染侧按 Metal device 缓存样本网格。

一级白平衡

复用“大鱼 CST”的色轮图像和交互换算:+104° 方位校正、拖动距离 /5、圆形强度约束、双击归零。一级色轮直接写原 BASIS 的方向与强度参数,取代可见的两根滑块;角度参数范围修正为 0–360°,旧存储数值保持原解释。原 BASIS 的强度平方后乘 4 换算不变。

色轮与蜘蛛盘每次拖动都由 FxUndoAPI 合并成一次宿主撤销;视图移除或释放时结束未完成动作。

面板与兼容

输入转换、工作空间、一级参数、输出转换合并为一个一级调色卡片。移除可见的四个旧旁路选项,一级眼睛统一启停;旧阶段开关和旁路参数仍保留注册,避免仅打开旧工程就改变画面。用户明确编辑 CST/色轮或复位时才清理旧旁路。

新实例与全部还原默认展开一级调色、蜘蛛盘校色仪、基础调整,其他模块折叠,所有眼睛开启。折叠状态仍由 InspectorToken schema 2 保存,与渲染状态分离。

验证分为原生数学/像素检查、AppKit 回调检查和正式 FCP 操作记录。数学覆盖见 verification/SpiderMath.json,原生集成见 verification/SpiderAndBalance.json;正式宿主记录单独保存,不以离屏回调代替用户界面验收。