# Application

**命名空间**: `XCEngine::Editor`

**类型**: `class (singleton)`

**源文件**: `editor/src/Application.h`

**描述**: 编辑器应用主入口，负责窗口渲染器、ImGui 后端、LayerStack 和 `EditorContext` 的初始化、渲染与关闭。

## 概述

`Application` 是当前编辑器应用真正的壳层对象。

它负责把几类本来分散的系统拼成一个可运行编辑器：

- Win32 宿主窗口句柄
- [Platform::D3D12WindowRenderer](../Platform/D3D12WindowRenderer/D3D12WindowRenderer.md)
- [UI::ImGuiSession](../UI/ImGuiSession/ImGuiSession.md)
- ImGui 平台/渲染后端桥
- `LayerStack`
- [Core::EditorContext](../Core/EditorContext/EditorContext.md)
- [Layers::EditorLayer](../Layers/EditorLayer/EditorLayer.md)

## 当前实现说明

- 采用单例入口 `Get()`。
- `Initialize(HWND)` 会安装崩溃过滤器、配置日志、初始化窗口渲染器、创建编辑器上下文、初始化 ImGui，并挂接 `EditorLayer`。
- `Shutdown()` 会按反向顺序关闭 layer、ImGui 和窗口渲染器。
- `Render()` 当前只是执行一帧编辑器 UI 渲染。
- `OnResize()` 会把尺寸变化转发给窗口渲染器。

## 关键公开接口

| 方法 | 作用 |
|------|------|
| `Get()` | 获取全局应用单例。 |
| `Initialize(HWND)` | 初始化编辑器应用。 |
| `Shutdown()` | 关闭编辑器应用。 |
| `Render()` | 绘制一帧编辑器。 |
| `OnResize(int, int)` | 处理窗口尺寸变化。 |
| `GetWindowHandle()` | 获取当前窗口句柄。 |
| `GetEditorContext()` | 获取当前编辑器上下文。 |

## 当前实现边界

- 目前窗口渲染路径绑定到 D3D12 窗口渲染器，不是抽象后端。
- `InitializeEditorContext()` 当前默认把项目路径设为可执行目录。
- `Render()` 当前只走 ImGui 帧，不承载独立游戏循环或模拟步进逻辑。

## 相关文档

- [Editor 模块](../Editor.md)
- [EditorContext](../Core/EditorContext/EditorContext.md)
- [EditorLayer](../Layers/EditorLayer/EditorLayer.md)
- [Win32EditorHost](../Platform/Win32EditorHost/Win32EditorHost.md)