docs: sync editor viewport host docs

This commit is contained in:
2026-04-04 00:41:13 +08:00
parent 468dbfa7ac
commit 8abca3dec5
28 changed files with 2340 additions and 40 deletions

View File

@@ -0,0 +1,51 @@
# Application::OnResize / SaveProjectState
**命名空间**: `XCEngine::Editor`
**类型**: `methods`
**源文件**: `editor/src/Application.h`
## 签名
```cpp
void OnResize(int width, int height);
void SaveProjectState();
```
## 作用
分别处理宿主窗口尺寸变化,以及把当前 ImGui 会话状态持久化到当前项目。
## 当前实现行为
### `OnResize(width, height)`
- 当前只是直接转发到:
```cpp
m_windowRenderer.Resize(width, height);
```
- 也就是说,窗口尺寸变化目前由主窗口 renderer 自己处理 back buffer 重建。
### `SaveProjectState()`
- 当前只是调用:
```cpp
m_imguiSession.SaveSettings();
```
- 它负责把当前项目相关的 ImGui/dock 布局状态写回会话存储。
## 设计含义
- 这两个方法当前都是 thin forwarding API。
- 它们存在的价值主要是把宿主层对外暴露的职责收口在 `Application` 上,而不是让外部直接碰内部子系统。
## 相关文档
- [Application](Application.md)
- [Render](Render.md)
- [SwitchProject](SwitchProject.md)