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

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

+9 -18
查看文件
@@ -1,26 +1,17 @@
# LumiGrade → 大鱼调色
# 大鱼调色:实现与范围
参考:/Library/Plug-Ins/FxPlug/LumiGrade.app,3.0 build56,主ID com.quliang.LumiGrade。
XPC universal SHA256 33c273d6a58314f5068959fcda911d741884a1937077b41a969a990dd40d0b6d;用于静态分析的arm64切片SHA c04e911e449e888eb0d8c10f7bcf2b6bc2c4153b9ba86c1952ddf210c96c5e97。
本工程提供原生 Wrapper / XPC / FxPlug 4 结构,使用 944 字节、102 字段的 CPU/GPU 状态,Metal 调色、全帧白场统计和 LUT 导出。
## 已确认与实现
支持 17 种相机输入转换、自选 3D Cube、白平衡、光影、局部增强、鲜艳度、饱和度、独立肤色保护;最多五层风格 LUT;主/R/G/B 单调 Hermite 曲线;8 色与自定义 HSL;四区色轮;三原色、RGB/单通道色阶、黑白混色和三向色彩平衡。自动调色、自动白平衡、复制时分析、系统吸管、预设和 33³ Cube 导出均接入原生参数。
- 原生Wrapper/XPC/FxPlug4,944字节102字段GPU状态,Metal滤镜、全帧白场统计、LUT导出。
- 输入17种相机曲线、可自选3D Cube;白平衡、曝光/对比度/高光/阴影/白/黑、纹理/清晰度/去雾、鲜艳/饱和、独立肤色保护。
- 最多五层顺序风格LUT;主/R/G/B可加删点的单调Hermite曲线;8色+自定义RGB选区HSL;阴影/中间调/高光/全局色轮及明亮度、混合、平衡;三原色、RGB/单通道色阶、黑白混色、三向色彩平衡。
- 自动调色与自动白平衡、复制时自动分析、系统白平衡/自定义色吸管、预设保存加载、33³Cube导出。
- 所有调色浮点均由FxPlug原生参数保存,控件按宿主action读写;实例通知以manager对象隔离。资产独立secure coding,渲染状态使用带版本不可变plist。
Color Finale 移植研究资料、相关工程和各算法来源分别见 [ALGORITHM_SOURCES.md](ALGORITHM_SOURCES.md)。Camera Raw 数据采用 Compositor 的 MIT 许可数据与组合实现;GPU 指令图输入、模块范围和改动见 `tools/kernels/PROVENANCE.json`。正式构建使用仓库内源码和必要资源。
## 证据
浮点参数由 FxPlug 保存,控件按宿主 action 读写,实例通知按 manager 隔离。LUT 路径状态使用 secure coding,渲染状态采用带版本的不可变 plist。所有分组展开即启用、折叠即停用并隐藏参数;新实例与全部还原仅展开基础调节。旧实例按保存的启用状态显示。
LumiGrade-analysis.json包含REA/Ghidra返回的20条证据及分析限制;关键CPU行为与地址见ColorTableNotes.md,GPU来源见tools/kernels/PROVENANCE.json及README。CameraRaw数据与MIT的Compositor源码逐字节一致,原许可保留在正式资源中。17张输入LUT由指定参考应用的一次性提取生成,原始和压缩数据SHA见Resources/InputLUTs/manifest.json。构建不依赖原厂应用。
界面使用大鱼品牌。基础组汇集白平衡、光影、鲜艳度和饱和度;HSL、色阶和色彩平衡按通道切换。主题偏好和用户 LUT 使用独立大鱼目录与偏好域。浏览器支持菜单、文件选择、缩略图、导入、目录与名称过滤及尺寸记忆;实现说明见 [ThemeLUT-analysis.md](ThemeLUT-analysis.md)。
35项GPU检查与5,342,405个分量对照通过;CPU查表、83项自动分析边界、73项完整模型/IOSurface/Metal/LUT与预览方向集成分别验证。正式安装及宿主结果见verification。
GPU 数学、CPU 查表、自动分析和真实 Metal/IOSurface 集成分别验证;当前正式版本通过 82 项原生集成检查。FCP 分组展开、数值保留及保存重开见 `verification/HostGroupFolding.json`,主题/LUT 与历史导出结果见 `verification/HostThemeLUT.json`。
## 适配与边界
自动分析使用 320×180 样本,在输入转换后统计;GPU 半精度、缩略采样与图像重采样存在数值边界。局部增强和全帧统计需要完整源帧,超大图受 GPU 纹理与内存限制。Cube 保存逐像素颜色,空间纹理、清晰度和逐画面分析无法完整写入 3D LUT。
重建的是调色行为与可编辑控件,界面保留大鱼标识,并按原版收紧工具栏、主题色块、标题胶囊、参数行与分组;白平衡/光影/鲜艳度/饱和度合入基础组,HSL、色阶和色彩平衡按通道切换显示。肤色保护维持独立数学旁路,设置单独折叠。未接原厂许可、售后或联网服务。吸管使用系统取色器,未复用原厂Viewer OSC。五套主题按原版完整17色和控件用途恢复,偏好使用独立大鱼域并跨实例同步。风格 LUT 可用菜单、文件选择或缩略图浏览器;浏览器按原版760×560、16:9缩略图、70–255尺寸范围及目录/尺寸记忆实现,另支持安全导入、搜索和懒加载。原版用户LUT内容未复制,产品库在 ~/Movies/大鱼调色LUT/look LUTs。主题和浏览库的静态证据见 ThemeLUT-analysis.md。
自动分析同为320×180 RGB8,转换前后量化并先应用输入LUT;Metal双线性缩图与原CoreGraphics缩图可能在边缘产生微小差异。原GPU使用half纹理和输出;32位宿主也遵循这一原精度边界。局部增强/全帧统计需要完整源帧,超大图受GPU纹理/内存限制。Cube仅保存逐像素颜色,无法承载邻域纹理、清晰度或逐画面分析。
有限状态对照不等于对所有参数/GPU/素材的穷尽证明。自定义LUT绝对路径随预设保存,跨机器需搬移用户LUT并重新选择;用户媒体与预设不在源码备份范围内。
有限状态对照不构成所有参数、GPU、素材或宿主的穷尽验证。自定义 LUT 绝对路径随预设保存,跨机器需搬移文件并重新选择;用户媒体和个人预设需独立备份。