39 lines
818 B
Markdown
39 lines
818 B
Markdown
# UI Overlay
|
|
|
|
## 职责
|
|
|
|
UI 模块负责局内 HUD、状态显示和调试面板。当前只有最小 overlay。
|
|
|
|
主要源码：
|
|
|
|
- `game/src/ui/game_ui_overlay.*`
|
|
|
|
## 当前能力
|
|
|
|
`GameUiOverlay` 继承引擎 `UIScene`，通过 `SceneManager` 进入 UI scene stack。
|
|
|
|
有字体时：
|
|
|
|
- 使用 `TextSprite` 显示游戏状态。
|
|
- 显示 debug 状态、battle zone、音频、存档、PVF、NPK、AudioDB 状态。
|
|
|
|
缺字体时：
|
|
|
|
- 使用 `Renderer::drawQuad` 画 fallback 色条。
|
|
- 不因字体缺失阻断 PC/Switch 启动。
|
|
|
|
## 资源
|
|
|
|
字体候选：
|
|
|
|
```text
|
|
assets/fonts/debug.ttf
|
|
assets/fonts/ui.ttf
|
|
```
|
|
|
|
## 下一步
|
|
|
|
- 增加血量、连击、联机状态等 gameplay HUD。
|
|
- 增加 debug 面板，替代部分 F 键调试。
|
|
- 确认 Switch 字体资源进入 RomFS 后再启用正式文字 UI。
|