Themes

主题与自定义

主题控制窗口、面板、按钮、调音台、效果窗口和电平桥等界面的颜色、字体与背景。主题以 .wjnskin 包或开发文件夹的形式放在主程序同级的 themes/ 目录。

切换主题

• 快捷栏或托盘的「主题」菜单列出可用主题，点击即可切换。
• 开发文件夹显示为 名称 (Dev)；选中 Dev 主题时，菜单会出现「刷新当前 Dev 主题」，修改 CSS 后用它重新加载。
• 默认主题由主程序同级的 wjn_default_theme.dll 提供，不能用主题包替换。
• 同一 ID 的开发文件夹优先于 .wjnskin 包；同名主题会附带作者或 ID 区分。

打开主题管理

「主题」菜单 →「管理主题…」，或全局设置中的「管理主题…」。

窗口有四个页签：主题与诊断、颜色与字体、背景、导出。

导入、预览、应用

1. 在「主题与诊断」页点「导入主题包」，选择 .wjnskin。
2. 校验通过后显示主题名称、作者、介绍、主页和诊断信息。
3. 「预览」临时应用候选的完整主题；「取消预览」恢复原主题。
4. 「应用」安装完整主题并保存选择；片段只叠加到当前完整主题。
5. 「打开作者主页」只在点击时打开链接。

片段（fragment）用于叠加到当前完整主题，不能单独作为完整主题预览。

颜色与字体

• 「颜色与字体」页列出可编辑的颜色 Token；选择后显示完整名称和当前值。
• 输入 #RRGGBB、rgb(...)、rgba(...) 或 transparent，点「应用颜色」。
• 修改立即生效，并按主题 ID 保存为用户覆盖；切换回该主题时会恢复。
• Token 按模块区分，格式为 --wjn-theme-<模块>-<角色>；调音台推子的颜色不会影响 Graphic EQ 的频段滑条。
• 全局字体支持导入 TTF/OTF；「恢复系统字体」把字体改回系统默认。

单条通道的自定义颜色属于通道数据，不是主题 Token。

背景

• 「模块区域」选择要调整的界面：接线盘、调音台、调音台总览、主调音台、监听调音台、辅助调音台、效果调音台、电平表桥。
• 「图片来源」可选继承接线盘、自定义图片或无图片。
• 尺寸模式：original、contain、cover、stretch；等比缩放 0.05–4。
• 平铺：no-repeat、repeat、repeat-x、repeat-y。
• 横向/纵向位置支持百分比或 px。
• 可调图片透明度、高斯模糊、组件透明度和上层覆盖。
• 上层覆盖时图片在控件上方、点击穿透；此模式忽略模糊和组件透明度，适合透明背景图片。
• 点「应用背景设置」生效。

导出

「导出」页可填写主题名称、作者、介绍和主页，然后：

• 「导出当前完整主题」：把当前解析后的完整外观导出为 .wjnskin。
• 「导出默认主题模板」：导出内置默认外观，作为修改起点。
• 「导出模块片段」：选择命名空间，只导出该模块的 Token 和图片资源；片段不带全局字体。

制作主题包

见 制作主题包。

常见问题

• 改了 Dev 主题的 CSS 没有生效？ 在主题菜单里选择「刷新当前 Dev 主题」；如果选中的是 .wjnskin 包，需要重新构建并导入。
• 导入主题包失败？ 在「主题与诊断」页查看诊断；常见原因是 meta.json 字段、CSS 规则或资源路径不符合契约。
• 主题能替换默认主题吗？ 不能；默认主题由 wjn_default_theme.dll 提供。
• 为什么调了主题，某条通道的颜色没变？ 通道自定义颜色属于通道数据，不是主题 Token。

参考

• 主题自定义（主仓库）
• 主题数据契约 v1
• 主题模板