Codex
74 lines
2.5 KiB
Markdown
74 lines
2.5 KiB
Markdown
# BUG-20260415-0005
|
||
|
||
> 适用场景：记录问题本身，不展开完整修复方案。修复内容写入对应的 Fix 文档。
|
||
|
||
## 基本信息
|
||
|
||
- ID: BUG-20260415-0005
|
||
- 标题: 局部重绘未补画上层兄弟导致遮挡错误
|
||
- 状态：已修复
|
||
- 严重性：S2
|
||
- 优先级：P1
|
||
- 模块: Window / Canvas / TabControl 局部重绘与合成
|
||
- 版本 / 分支: 当前工作区
|
||
- 环境: Windows + EasyX
|
||
- 发现人: 用户回归测试
|
||
- 关联 Fix ID：[可选]
|
||
- `Fix-BUG-20260415-0005`
|
||
|
||
## 问题描述
|
||
|
||
- 现象:
|
||
- 下层控件发生局部重绘后，位于其上方且与 coverage 相交的兄弟控件没有被补画回来。
|
||
- 表现为上层 `Canvas / Dialog / 页 / 页签按钮` 被“切掉”或被下层重新盖住。
|
||
- 影响范围:
|
||
- 顶层普通控件之间
|
||
- `Canvas` 直接子控件之间
|
||
- `TabControl` 页签按钮与页面之间
|
||
- 期望结果:
|
||
- 任意局部重绘提交后，父容器应按实际绘制顺序把 coverage 上方相交的兄弟重新合成回来。
|
||
- 实际结果:
|
||
- 仅 dirty root 或 dirty child 被重画，上层兄弟未恢复。
|
||
|
||
## 复现信息
|
||
|
||
- 前置条件：[可选]
|
||
- 使用 `KEY5` 测试场景
|
||
- 复现步骤:
|
||
|
||
1. 进入 `KEY5`
|
||
2. 触发下层控件局部重绘，例如 `Table` 翻页或相交子控件 hover / click
|
||
3. 观察上层相交兄弟区域
|
||
|
||
- 复现概率：高概率
|
||
- 最小复现 Demo：[可选]
|
||
- `KEY5` 中 `Table` 与顶层粉色浮层重叠场景
|
||
- 同父 `Canvas` 兄弟相交场景
|
||
- 证据：截图 / 日志 / 调用栈 / 录屏 / 断点观察
|
||
- 断点观察显示 dirty root 已提交，但上层 sibling 未重新执行 draw
|
||
|
||
## 初步分析
|
||
|
||
- 疑似位置:
|
||
- [`Window.cpp`](D:/programming/imGUI-easyX/imGui-easyX/Window.cpp)
|
||
- [`Canvas.cpp`](D:/programming/imGUI-easyX/imGui-easyX/Canvas.cpp)
|
||
- [`TabControl.cpp`](D:/programming/imGUI-easyX/imGui-easyX/TabControl.cpp)
|
||
- 触发条件:
|
||
- 局部重绘提交写入了下层像素，但没有做 overlay 兄弟补画
|
||
- 相关线索:
|
||
- 该问题不依赖“是否回贴背景快照”，直接重绘同样会破坏上层合成结果
|
||
- `Dialog` 之前之所以需要补画，本质上是同一类问题
|
||
- 最近相关改动：[可选]
|
||
- 第二阶段开始引入更严格的局部重绘与 overlay 收口后，问题被系统性暴露
|
||
|
||
## 跟踪信息
|
||
|
||
- 首次发现时间: 2026-04-15
|
||
- 最后更新时间: 2026-04-15
|
||
- 修复版本：[可选]
|
||
- 当前工作区
|
||
- 验证版本：[可选]
|
||
- 当前工作区
|
||
- 备注：[可选]
|
||
- 后续仍需继续关注 `Dialog` 旧 synthetic move 机制与新模型的统一。
|