# 主题与 LUT 浏览库实现说明 五套主题、浏览器和预览由本工程的 `DYTheme`、`DYLUTLibrary`、`DYLUTBrowser`、`DYInspector` 与 `DYRenderer` 实现。相关 Color Finale 移植研究与来源边界见 [ALGORITHM_SOURCES.md](ALGORITHM_SOURCES.md)。本文件说明当前产品行为,历史静态观察完整保留在整理前提交中。 ## 主题 主题顺序为灰、蓝、紫、绿、橙,默认蓝。每套包含 17 个颜色槽,数值快照见 `ThemePalette.json`。色块 RGB 分别为 `(0.30,0.33,0.38)`、`(0.28,0.72,1)`、`(0.58,0.52,1)`、`(0.30,0.86,0.52)`、`(1,0.61,0.28)`。 整体底色使用槽1,分组底色使用槽3,标题胶囊渐变使用槽6/7,滑条轨道使用槽8/9,活动段使用槽10/11;标题、参数标签和版本分别使用槽14/15/16。灰色工具强调色为 `(0.72,0.77,0.84)`,蓝色为 `(0.22,0.67,1)`。主题保存到独立大鱼偏好域并通知其他实例;主题不属于可动画调色参数。 ## 用户库与浏览器 用户 LUT 库位于 `~/Movies/大鱼调色LUT/look LUTs`。支持递归发现 `.cube`、目录过滤、名称搜索、收藏、导入和 Finder 打开目录。顶层文件可归入未分类;隐藏项跳过,路径去重。导入保留源文件,重名时产生带数字后缀的副本。 浏览器采用 760×560 点布局,缩略图比例为16:9,大小默认96、范围70–255;目录和尺寸偏好独立保存。优先使用宿主窗口接口,必要时使用锚定弹出面板。单击应用所选 LUT,目录切换和预览生成不应意外写入调色参数。 ## 真实帧与方向 缩略图取当前素材经过输入转换后的源帧,再应用候选 LUT;解析和采样使用产品的 LUT 实现。没有源帧时显示合成色卡。分析帧保留物理行序,浏览显示根据 FxPlug 图像原点转换,避免上下翻转。 图库任务采用缓存、懒加载和失效处理。用户 LUT、收藏与偏好是本机用户资料,换机时需独立搬移;源码中仅包含合成验收 LUT 的生成脚本。 ## 验收 五主题、导入、目录与名称过滤、尺寸记忆、缩略图方向、单击应用、保存重开和 ProRes 导出见 `verification/HostThemeLUT.json`。当前分组展开与启用规则见 `verification/HostGroupFolding.json`。历史报告对应其记录的版本,不能将其范围自动扩展为所有素材、宿主与系统均已验证。