84 lines
3.1 KiB
Markdown
84 lines
3.1 KiB
Markdown
|
# XCUI Subplan 05: ImGui Transition Backend
|
|||
|
|
|
|||
|
|
归档日期：
|
|||
|
|
- `2026-04-04`
|
|||
|
|
|
|||
|
|
状态：
|
|||
|
|
|
|||
|
|
- 已完成
|
|||
|
|
|
|||
|
|
本次实际完成内容：
|
|||
|
|
- 新增 XCUI 绘制数据契约：`UIColor`、`UIDrawCommandType`、`UIDrawCommand`、`UIDrawList`、`UIDrawData`
|
|||
|
|
- 新增 `ImGuiTransitionBackend` 过渡后端，支持 `FilledRect`、`RectOutline`、`Text`、`Image`、`PushClipRect`、`PopClipRect`
|
|||
|
|
- 新增最小 editor 接入样例 `XCUIDemoPanel`，用于在现有编辑器壳层中演示 XCUI draw data 到 ImGui draw call 的过渡链路
|
|||
|
|
- 将 demo panel 接入 editor workspace，并补齐 editor/tests 构建入口
|
|||
|
|
- 新增 Subplan-05 配套测试，覆盖 draw data 聚合与 backend flush 行为
|
|||
|
|
|
|||
|
|
本次涉及文件：
|
|||
|
|
- `editor/CMakeLists.txt`
|
|||
|
|
- `editor/src/Core/EditorWorkspace.h`
|
|||
|
|
- `editor/src/XCUIBackend/ImGuiTransitionBackend.h`
|
|||
|
|
- `editor/src/panels/XCUIDemoPanel.cpp`
|
|||
|
|
- `editor/src/panels/XCUIDemoPanel.h`
|
|||
|
|
- `engine/include/XCEngine/UI/DrawData.h`
|
|||
|
|
- `tests/editor/CMakeLists.txt`
|
|||
|
|
- `tests/editor/test_xcui_draw_data.cpp`
|
|||
|
|
- `tests/editor/test_xcui_imgui_transition_backend.cpp`
|
|||
|
|
|
|||
|
|
验证结果：
|
|||
|
|
- `cmake --build . --config Debug --target editor_tests -- /m:1 /p:CL_MPCount=1`
|
|||
|
|
- `ctest -C Debug -R "XCUIDrawDataTest|XCUIImGuiTransitionBackendTest" --output-on-failure`
|
|||
|
|
- 结果：`4/4` 通过
|
|||
|
|
- `cmake --build . --config Debug --target XCEditor -- /m:1 /p:UseMultiToolTask=false /p:CL_MPCount=1`
|
|||
|
|
- 结果：通过
|
|||
|
|
|
|||
|
|
提交记录：
|
|||
|
|
- `75ded6f` `Add XCUI ImGui transition backend MVP`
|
|||
|
|
|
|||
|
|
当前结论：
|
|||
|
|
- `Subplan-05` 的最小过渡后端已经可用，可以作为 XCUI 在 editor 中落地的第一层渲染适配桥
|
|||
|
|
- XCUI 逻辑层仍然不直接依赖 ImGui API，ImGui 仅存在于过渡 backend 和 editor 接入层
|
|||
|
|
- 后续 `Subplan-08`、`Subplan-09` 可以直接基于这套 draw data 和 transition backend 继续推进
|
|||
|
|
|
|||
|
|
原始 subplan 内容归档如下：
|
|||
|
|
|
|||
|
|
# Subplan 05：XCUI ImGui Transition Backend
|
|||
|
|
|
|||
|
|
目标：
|
|||
|
|
- 在过渡阶段，让 ImGui 只承担宿主窗口和 draw submission 容器的职责
|
|||
|
|
- 由 XCUI 自己生成 draw list，再交给 ImGui backend 落屏
|
|||
|
|
|
|||
|
|
负责人边界：
|
|||
|
|
- 负责 `editor/src/XCUIBackend/` 或等价新目录
|
|||
|
|
- 负责 XCUI draw primitive 到 ImGui draw call 的映射
|
|||
|
|
- 不负责 XCUI tree、布局、样式的内部规则
|
|||
|
|
|
|||
|
|
建议目录：
|
|||
|
|
- `editor/src/XCUIBackend/`
|
|||
|
|
- `editor/src/UI/` 中与 XCUI backend 直接相关的桥接代码
|
|||
|
|
- `tests/Editor` 中 backend 相关测试
|
|||
|
|
|
|||
|
|
前置依赖：
|
|||
|
|
- 需要 `Subplan-01` 给出稳定 draw data 和 frame submission 契约
|
|||
|
|
- 需要 `Subplan-03` 提供样式查询结果
|
|||
|
|
|
|||
|
|
现在就可以先做的内容：
|
|||
|
|
- 定义 `UIDrawList` / `UIDrawCommand` / `UIDrawText` / `UIDrawImage` / `UIDrawClip`
|
|||
|
|
- 先做矩形、边框、文字、图片四类 primitive
|
|||
|
|
- 设计 frame begin / submit / end 的 adapter 流程
|
|||
|
|
- 写一个最小 demo panel，用 XCUI draw list 通过 ImGui 显示
|
|||
|
|
|
|||
|
|
明确不做：
|
|||
|
|
- 不做 RHI native backend
|
|||
|
|
- 不做 docking 逻辑
|
|||
|
|
|
|||
|
|
交付物：
|
|||
|
|
- XCUI 到 ImGui 的过渡 backend
|
|||
|
|
- primitive 转换测试或快照测试
|
|||
|
|
- 最小 editor 接入样例
|
|||
|
|
|
|||
|
|
验收标准：
|
|||
|
|
- XCUI 逻辑层不直接依赖 ImGui API
|
|||
|
|
- ImGui 只出现在 backend 适配层
|
|||
|
|
- 可以渲染基础控件和文本
|