fix(UI): 布局边界按尺寸自适应 + 修复拖滚动条的绘制残留与浮层层级
## 1. 边界描边按元素尺寸自适应(修复"小元素变成粗描边")
旧规则四角固定 3-4px:对 15px 的复选框来说包角占短边 20%,看起来就是一整圈粗边框。
新规则全部以**短边**为基准:
- 四边固定 1 设备像素;
- 包角粗细 = min(基础 4/3, 短边/10),再夹到 [1, 短边/4];
- 包角长度 = min(14, 短边/3),且不小于包角粗细;
- 短边 <= 12 只画四个 L 形角标记、**不画边**(一圈连续描边会让小方框显得"被框住");
- 短边 <= 5 完全不画(再画就盖住元素本身);
- 内缩只用于「层级 > 0 且短边 >= 10」,否则小元素会被缩没。
同时**删除文字标签**(含 UiDebugPaintStyle):黑底白字在小元素上必糊成一片,体积也省约 1.5KB。
## 2. 拖网格滚动条时的"大量绘制残留":三个独立成因
R1. PlotView::CollectDebugBoxes 读了 m_decorRects —— 那是**装饰层位图缓存**的登记矩形,
坐标处在位图/图层坐标系(带负 Y、超出绘图区),于是出现 (472,-27 1213x101) 这类
**横跨工具栏的幽灵巨框**。改为只用 LaneBadgeRect 与 m_legendHits(屏幕坐标)。
R2. Paint 的三条快路径(静态场景贴图 / 宽基底贴图 / 样式补丁)只重画**变化的部分**,
而调试边框是画在整个窗口上的叠加内容 ⇒ 上一帧的边框残留在未被重画的像素上,
直到松开鼠标走整幅重绘才消失。
新增 PlotView::SetForceFullRepaint(bool):开启调试叠加层时禁用全部快路径。
R3. 组件内元素可能落在自己地盘之外(滚出可视区的 lane.rect 的 Y 为负),不裁剪就画到
工具栏/标签栏上。box 增加 clip:宿主按组件 Area() 设置,Add() 跳过无交集、
绘制时与 clip 求交。
另外把 Render 的 fullChrome 并入 m_showLayoutBounds,装饰区也保证完整一帧。
## 3. 层级:排序 + 挖洞(修复二级菜单被下层边界覆盖)
- UiDebugBoxList::PushLayer() + 按 (layer, depth) 稳定排序:后收集的内容压住先收集的。
- 但仅靠排序不够:调试线画在所有内容之后,下层组件的线仍会显示在不透明菜单上面。
新增 AddOccluder():菜单/拾色器把本体登记为遮挡矩形,绘制**更低层**的 box 时用
Region::Exclude 挖洞。实测菜单区与子菜单区的琥珀/绿色像素均为 0。
- 浮层**不设** clip = 本体矩形:二级子菜单会展开到本体之外,设裁剪会把它整个裁掉。
## 4. 验证
- make release / make debug 零 error 零 warning;TargetCheck.exe 906,752 B(885.5 KiB < 900 KiB)。
- 新增 .preflight/lbresid(MF4-Record.MF4 / 283 网格 / 拖滚动条)**5/5**:
toolbar-unchanged-while-scrolling、repaint-same-state-is-identical、
toolbar-restored-by-full-repaint、residual-never-above-plot-area、later-layer-wins-over-earlier。
- 新增 .preflight/lbzorder **4/4**:菜单与二级子菜单区内下层颜色像素 = 0。
- 回归:.preflight/lbcheck 21/21、Tools/uicheck 69/69、
Tools/rendercheck「工具栏带以下」区域哈希 8/8 与上一轮逐一相同 + FUNC 7/7。
注:判断"是否有绘制残留"不能用"拖拽帧 vs 松开后一帧"——两者图层预热进度不同会产生
几十万像素的**合法**差异;正确判据是**同一状态连续两帧必须逐像素相同**。
## 5. 文档
Documents/UI_Refactor_Plan.md / UI_Refactor_Progress.md / UI_Refactor_Report.md 追加第八阶段;
Documents/agent_mem.md 同步变更日志与「2026-10-28 第十轮」硬约束与踩坑。
This commit is contained in:
1 parent
24706c906a
commit
57e12cfb27
14 files changed
+630
-191
No files matched your search
@@ -482,3 +482,41 @@ protected:
|
||||
* 「工具栏带以下」区域哈希与上一轮**逐一相同**(证明改动只落在工具栏带内);
|
||||
* `lbcheck` 21/21、`rendercheck` FUNC 7/7、`uicheck` 69/69;
|
||||
* 打开开关后:每行的复选框/色块/名称/GX 徽标/✕、每个网格的 GX 徽标与图例、每个浮层控件都有独立包角框。
|
||||
|
||||
---
|
||||
|
||||
# 第八阶段计划(2026-10-28 第十轮):边界观感自适应 + 残留与层级缺陷修复
|
||||
|
||||
> 用户反馈:① 包角对小元素来说太粗(小方框直接变成粗描边);② 不需要黑色底衬的文字标签;
|
||||
> ③ 加载 MF4-Record.MF4 全部信号独立网格后,按住左键拖动网格滚动条快速滚动会出现大量
|
||||
> 绘制残留(工具栏与网格区域都有),松开并移动鼠标才消失;④ 右键二级菜单上被下层元素的
|
||||
> 边界线覆盖,干扰观察菜单布局。
|
||||
|
||||
## 任务清单
|
||||
|
||||
| # | 任务 | 验证手段 |
|
||||
| --- | --- | --- |
|
||||
| P8-1 | 包角粗细/长度按矩形短边自适应;小方框只画角不画边;过小则不画 | 截图放大 3 倍核对 |
|
||||
| P8-2 | 删除文字标签(连同 `UiDebugPaintStyle`),降低体积与视觉噪声 | 编译 + 体积 |
|
||||
| P8-3 | 定位并修复「拖网格滚动条时的绘制残留」 | 新增离屏探针 `.preflight/lbresid` |
|
||||
| P8-4 | 修复 `PlotView` 误用 `m_decorRects`(位图坐标系)产生的跨工具栏幽灵框 | 同上(box 清单打印) |
|
||||
| P8-5 | 调试叠加层开启时强制绘图区整幅重绘(禁用三条快路径) | 同上(同状态两帧必须逐像素相同) |
|
||||
| P8-6 | box 增加 `clip`(组件地盘),组件内越界元素不再画到邻居上 | 同上(差异 bbox 不得越过绘图区上沿) |
|
||||
| P8-7 | 层级:`(layer, depth)` 双排序键 + 浮层 `occluder` 挖洞 | 新增探针 `.preflight/lbzorder`(4 条断言) |
|
||||
| P8-8 | 文档与共享记忆同步;`TargetCheck.exe` < 900 KiB | 构建 |
|
||||
|
||||
## 风险与对策
|
||||
|
||||
| 风险 | 对策 |
|
||||
| --- | --- |
|
||||
| 强制整幅重绘让调试模式变慢 | 只在开关打开时生效;关闭立即恢复快路径 |
|
||||
| `Region::Exclude` 影响其他绘制 | 只在 `Save/Restore` 内临时 `SetClip`,且仅在存在遮挡时才走该分支 |
|
||||
| 裁剪把紧贴边界的包角裁掉 | 裁剪用 `floor/ceil` 向外取整(宁可多一像素) |
|
||||
| 移除标签后难以辨认 box 归属 | 层级配色(青蓝/品红/琥珀/绿)+ 包角形状 |
|
||||
|
||||
## 完成判据
|
||||
|
||||
* 零 warning;`lbresid` 5/5、`lbzorder` 4/4、`lbcheck` 21/21、`uicheck` 69/69;
|
||||
* `rendercheck` 的「工具栏带以下」区域哈希与上一轮**逐一相同**、FUNC 7/7;
|
||||
* 拖动滚动条期间工具栏区域像素**完全不变**,且同状态两帧**逐像素相同**;
|
||||
* 菜单/二级子菜单区域内不出现下层组件的边界色。
|
||||
Reference in new issue
Block a user