# Legacy UI Prototype

`mvs/ui/` 是仓库里保留的早期 ImGui + D3D12 编辑器原型。它主要用于保留原始 UI 骨架、交互想法和历史实现参考，不是当前 XCEngine 的正式 editor 主线。

当前正式 editor 在：

- [editor/README.md](D:\Xuanchi\Main\XCEngine\editor\README.md)

当前正式构建入口在仓库根目录：

- [README.md](D:\Xuanchi\Main\XCEngine\README.md)
- [AGENT.md](D:\Xuanchi\Main\XCEngine\AGENT.md)

## 当前状态

这个模块仍然可以单独构建，但它有几个需要明确的事实：

- 顶层 `CMakeLists.txt` 当前并不会纳入 `mvs/ui/`
- 它使用独立的 `mvs/ui/CMakeLists.txt`
- target 名称仍然是历史遗留的 `XCVolumeRendererUI2`
- 它不是当前 `editor/` 目录下那套 `ViewportHostService + Rendering + Project.xcproject + ScriptAssemblies` 架构
- 它不代表当前仓库的真实 editor 能力边界

因此：

- 想用当前引擎编辑器，请进入 `editor/`
- 想研究早期 UI 原型、旧面板布局和最初的 ImGui 宿主结构，可以看这里

## 这个目录里有什么

```text
mvs/ui/
├── CMakeLists.txt
├── README.md
├── src/
│   ├── Core/
│   ├── Managers/
│   ├── panels/
│   ├── Application.cpp
│   ├── Application.h
│   ├── Theme.cpp
│   ├── Theme.h
│   └── main.cpp
├── build/                         # 历史本地构建输出
└── bin/                           # 历史可执行文件输出
```

主要内容是：

- 早期 `Application` / `Theme` 实现
- 基础 `Hierarchy / Scene / Game / Inspector / Project / Console` 面板骨架
- 旧版 `SceneManager / ProjectManager / LogSystem`

## 单独构建方式

如果你只是想启动这个原型，可以单独进入该目录配置：

```bash
cmake -S mvs/ui -B mvs/ui/build -A x64
cmake --build mvs/ui/build --config Release
```

输出可执行文件通常位于：

```bash
.\mvs\ui\bin\Release\XCVolumeRendererUI2.exe
```

## 与当前正式 editor 的区别

当前正式 editor 具备而这个原型没有正式接入的能力包括：

- `engine/Rendering` 主链驱动的 scene/game viewport
- `ViewportHostService`
- object-id picking 与 outline
- `Project.xcproject`
- `Assets + .meta + Library`
- `project/Library/ScriptAssemblies`
- `ScriptComponent` Inspector 与脚本类发现

所以这个目录更适合被理解为：

- 历史设计参考
- 原型实现存档
- 某些 UI 想法的对照样本

而不是当前 XCEngine editor 的入口。