动画主菜单 - 日出山脉

动态主菜单 — 雾山之晨

将《剑士》的静态主菜单转变为充满生机的动态场景。本模组将默认背景替换为高品质、平滑循环的动画，展现晨光突破雾霭山峦的壮丽景象。

与简单的视频叠加或UI技巧不同，这个动画由原生DirectX 11挂钩驱动，使游戏能够以零性能损失的方式实时显示动画纹理。

✨ 该模组的功能

• 将静态主菜单背景替换为全动态1080p动画序列
• 使用 原生 DirectX 11 挂钩（非覆盖层，非着色器修改）
• 使用自身内部计时器运行 — 不影响游戏帧率
• 优化的 DDS 纹理帧，实现快速加载和低显存占用（约 90MB）
• 专为《Kenshi》菜单布局设计的平滑无缝循环
• 兼容 所有版本的 Kenshi（Steam、GOG、独立版）
• 完全独立——不需要RE_Kenshi或其他任何模组框架

? 兼容性说明

此模组专为标准16：9分辨率设计。若使用以下配置，可能无法正确显示：

• 超宽显示器（21:9、32:9、48:9）
• 低于1920×1080的分辨率
• 自定义UI缩放
• 使用非标准宽高比的窗口模式

该模组仍将运行，但动画可能会显得拉伸或被裁剪。

安装

1. 下载 主文件。
2. 将压缩包内容解压到你的 Kenshi 主文件夹（包含 kenshi_x64.exe 的文件夹）。
3. 启动游戏——动画菜单将自动加载。

无需配置。

? Steam Workshop 用户注意

如果你已订阅了此模组的Steam版本，你仅需：

“Kenshi动画菜单补丁（仅限补丁部分）”（位于可选文件部分）

本补丁包含所需的 .asi 和 .dll 文件，Steam 无法承载这些文件。

? 附加说明

• 该动画是预先渲染的，并专门针对《kenshi》的菜单流程进行了优化。
• DirectX挂钩轻量且独立 —— 它不会修改游戏文件或影响游戏玩法。
• 可与任何其他Mods安全地同时使用，包括UI界面重制（只要这些Mods不替换菜单背景贴图）。

(中文) 工作原理（技术细节）

与更改游戏数据的标准Kenshi模组不同，本模组作为C++插件直接注入游戏的渲染管线中运行。

1. DirectX 11 Hooking： 该模组使用ASI加载器（version.dll）将自定义代码注入到kenshi_x64.exe中。它挂钩到游戏用于将纹理发送到GPU的DirectX 11函数PSSetShaderResources。
2. 智能检测算法： 该模组不再替换特定文件路径，而是实时分析屏幕上绘制的每一张纹理。其通过过滤算法，基于以下特征区分主菜单背景与UI按钮及字体：
   • 宽高比： 搜索宽屏图像（16:9）。
   • 尺寸： 忽略小图标（<1000像素）。
   • 纹理类型： 忽略“二的幂次”纹理（例如 1024x1024、2048x2048），肯希使用这些纹理作为UI图集。这可以防止动画意外出现在按钮上。
3. 帧注入： 一旦识别出背景纹理，该模组就会截获渲染调用，并用动画序列的当前帧替换静态图像。
4. 性能：
   • 零CPU负载： 所有240帧都预先加载到显存中，为压缩的DDS纹理。游戏过程中CPU不解码图像。
   • 独立计时器： 该动画使用自身内部的高精度计时器运行，保持稳定的帧率，不受游戏帧率影响。
5. 通用路径查找： 该代码会自动扫描本地mods文件夹和Steam创意工坊目录，以查找动画文件，确保与所有游戏版本兼容。