fix(UI): 边界框不再内缩 + 文本获得几何身份 + 补全漏项 + 描边提速 32%
## 1. 取消内缩(这是"边框不清晰"的主因)
第九轮为"父子矩形共边不叠粗"给 depth > 0 的 box 加了 1px 内缩。结果 GX 徽标
(30x17 逻辑像素的胶囊,圆角 = 高的一半,外接矩形正好等于 LaneBadgeRect)内缩 1px 后
框比形状小一圈 ⇒ 左右尖端与上下圆弧全部落在框外。
现行规则:**框 = 可见形状的外接矩形,绝不内缩**。父子共边时让"后画的覆盖"即可,
这本来就是正确的图层语义。层级 > 0 只影响配色,不再影响几何。
## 2. 文本第一次有了几何身份(唯一出口回报,不逐处登记)
文本是本项目唯一"没有几何身份"的元素:65 处绘制点各自现算 gd::RectF、画完即弃。
逐处补登记必漏,因此在唯一出口回报一次:
PaintUtil 新增
class UiTextRectSink { virtual void OnTextRect(const gd::RectF&) = 0; };
void UiSetTextRectSink(UiTextRectSink*); // 开关关闭时为 nullptr
void UiSetTextRectOffset(float dx, float dy); // 离屏位图渲染的坐标换算
UiTextRectSink* UiGetTextRectSink();
DrawUiText() / UiTextAtClipped() 画完后按对齐方式 + 实测宽高把布局矩形**收窄成墨迹矩形**
再回报。UiDebugBoxList 直接继承该接口,宿主只需 UiSetTextRectSink(&m_debugBoxes) 一句。
开关关闭时只是一次空指针判断,正常绘制零影响。
## 3. 缓存命中的行也要有文本框
面板的行是"先画进位图再贴回",命中缓存的帧**根本不调用 UiText** ⇒ 文本框第二帧起消失。
做法:行渲染时用本地 RowTextCollector 收集(位图坐标)→ 连同位图存进
RowBitmapCache::textRects → 贴图时按 (originX, originY) 回放。
⚠️ **必须无条件收集**:只在"外层有收集器"时收集会导致"关调试时滚过列表 → 打开调试 →
命中缓存 → 永远没有文本框"。
## 4. 补齐 PlotView 漏项(全部读现成成员)
m_timeAxisRect / m_scrollBarRect / BackToTopRect() / m_cursorSpanRect /
m_cursorLabelRects / EditFieldRect()
## 5. 描边提速:图元 12 → 8
微基准结论:图元数量是唯一瓶颈(每次 FillRectangle ≈1µs)。
旧实现把每条边拆成"中段 1px + 两端各一段加粗"= 12 次;新实现 = 4 条 1px 边 + 4 个自适应角块。
实测 paintBoxes 5.892ms → 4.028ms(-32%),观感几乎一致(角仍是两条粗边的交点)。
⚠️ 不要改写成 GraphicsPath/FillPath(单次约 20µs,比 12 段还慢);
GDI PolyPolygon 一次画 5688 个矩形要 114ms,更不能用。
## 6. 关闭开关时清空容器(释放内存,避免误读)
## 7. 验证
- make release / make debug 零 error 零 warning;TargetCheck.exe 909,824 B(888.5 KiB < 900 KiB)。
- 新增探针 .preflight/lbcovr 7/7:box-time-axis / box-plot-scrollbar / box-back-to-top /
box-gx-badge-matches-pill(容差 0.5px)/ text-boxes-collected(89 个)/
row-text-boxes-from-cached-rows / boxes-cleared-when-off。
- 回归:lbcheck 21/21、lbresid 5/5、lbzorder 4/4、uicheck 69/69。
- rendercheck:8 个场景的整帧与区域哈希与上一轮**逐一相同** + FUNC 7/7
(证明调试功能对正常绘制零影响)。
- 帧耗时分解(MF4 / 283 网格):base 9.06ms、仅强制整帧 6.66ms、完整调试 11.35ms;
collect 0.082ms、paintBoxes 4.028ms(上一轮 5.892ms)。
## 8. 文档
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
57e12cfb27
commit
aa4925a2b7
14 files changed
+635
-107
No files matched your search
@@ -520,3 +520,37 @@ protected:
|
||||
* `rendercheck` 的「工具栏带以下」区域哈希与上一轮**逐一相同**、FUNC 7/7;
|
||||
* 拖动滚动条期间工具栏区域像素**完全不变**,且同状态两帧**逐像素相同**;
|
||||
* 菜单/二级子菜单区域内不出现下层组件的边界色。
|
||||
|
||||
---
|
||||
|
||||
# 第九阶段计划(2026-10-28 第十一轮):把"边界"这件事从补丁改成机制
|
||||
|
||||
> 背景:第十轮结论是"三个性质不同的问题"——① `inset` 破坏 '框 = 可见形状外接矩形';
|
||||
> ② 元素清单不完整(几何没有枚举出口);③ 描边图元太多。本轮把三者一起解决。
|
||||
|
||||
## 任务清单
|
||||
|
||||
| # | 任务 | 验证手段 |
|
||||
| --- | --- | --- |
|
||||
| P9-1 | **取消内缩**:框必须与可见形状外接矩形重合(修 GX 胶囊圆弧落在框外) | 探针断言 box 与 `LaneBadgeRect` 重合(容差 0.5px) |
|
||||
| P9-2 | **文本获得几何身份**:`PaintUtil` 增加 `UiTextRectSink`,在绘制的**唯一出口**回报墨迹矩形 | 覆盖 60+ 调用点,无需逐处修改 |
|
||||
| P9-3 | 离屏位图(面板行缓存)中的文本按**位图原点**回放,缓存命中也能显示文本框 | 探针 `row-text-boxes-from-cached-rows` |
|
||||
| P9-4 | 补齐 `PlotView` 漏项:时间轴 / 网格滚动条 / 回到最上方 / 光标标签 / 差值标签 / 内联输入框 | 探针 4 条 box 断言 |
|
||||
| P9-5 | 描边图元 12 → 8(4 边 + 4 角块),耗时 5.9ms → 4.0ms | 微基准 + 帧耗时分解 |
|
||||
| P9-6 | 关闭开关时清空容器(释放内存,避免误读) | 探针 `boxes-cleared-when-off` |
|
||||
| P9-7 | 文档 + 共享记忆;`TargetCheck.exe` < 900 KiB | 构建 |
|
||||
|
||||
## 关键设计决定
|
||||
|
||||
* **文本不做"逐处登记"**:全仓 65 处文本绘制点手写登记必漏。改为在 `UiText`/
|
||||
`UiTextClipped`/`UiTextAtClipped` 的公共出口 `ReportTextRect()` 里回报一次,
|
||||
代价是开关关闭时一次判空。
|
||||
* **缓存命中也要有文本框**:行位图渲染时用一个本地收集器把矩形存进 `RowBitmapCache`,
|
||||
贴图时按原点偏移回放;否则第二帧起文本框全部消失。
|
||||
* **不内缩**:重叠时"后画的覆盖"就是正确语义,内缩是错误取舍。
|
||||
|
||||
## 完成判据
|
||||
|
||||
* 零 warning;四个探针全绿(21 + 5 + 4 + 7)、`uicheck` 69/69;
|
||||
* `rendercheck` 8 个场景的整帧与区域哈希与上一轮**逐一相同**(调试功能不能影响正常绘制);
|
||||
* 打开开关后:文本有橙色墨迹框、GX 胶囊被框住、时间轴/滚动条/回到最上方均有框。
|
||||
Reference in new issue
Block a user