Files
XCEngine/MVS/ui/README.md

88 lines
2.5 KiB
Markdown

# 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 的入口。