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
@@ -171,6 +171,59 @@ namespace jdi
|
||||
void UiTextClipped(gd::Graphics& g, const std::wstring& text, HFONT font, const gd::RectF& rect,
|
||||
std::uint32_t argb, TextAlign align, const gd::RectF& clipRect);
|
||||
|
||||
/**
|
||||
* @brief 文本几何收集器(调试用「显示布局边界」)。
|
||||
*
|
||||
* 文本是本项目里**唯一**没有几何身份的绘制元素:`UiText` / `UiTextClipped` /
|
||||
* `UiTextAtClipped` 每次都在调用点现算一个矩形、画完即弃,全仓有 60+ 处这样的调用点。
|
||||
* 与其在 60 处逐个补登记(必漏),不如在**绘制唯一出口**里回报一次。
|
||||
*
|
||||
* ⚠️ 只在调试开关打开时才被安装(见 `UiSetTextRectSink`),平时为空指针、
|
||||
* 一次判空即返回,对正常绘制零影响。
|
||||
*/
|
||||
class UiTextRectSink
|
||||
{
|
||||
public:
|
||||
virtual ~UiTextRectSink() = default;
|
||||
|
||||
/**
|
||||
* @brief 回报一段文本**实际占用**的矩形(已按对齐方式与实测宽度收窄)。
|
||||
* @param [IN] rect 文本墨迹矩形(客户区坐标)。
|
||||
*/
|
||||
virtual void OnTextRect(const gd::RectF& rect) = 0;
|
||||
};
|
||||
|
||||
/**
|
||||
* @brief 安装 / 卸载文本几何收集器(nullptr = 卸载)。
|
||||
*
|
||||
* 单线程 UI 绘制 ⇒ 用文件级静态指针即可,不需要加锁。
|
||||
*
|
||||
* @param [IN] sink 收集器(允许为空)。
|
||||
*/
|
||||
void UiSetTextRectSink(UiTextRectSink* sink);
|
||||
|
||||
/**
|
||||
* @brief 取当前安装的文本几何收集器(`nullptr` = 未安装)。
|
||||
*
|
||||
* 供"先画进离屏位图再贴回"的组件使用:它需要暂存自己的文本框,
|
||||
* 并在贴图时按原点偏移回放给外层收集器。
|
||||
*
|
||||
* @return 当前收集器(可能为空)。
|
||||
*/
|
||||
UiTextRectSink* UiGetTextRectSink();
|
||||
|
||||
/**
|
||||
* @brief 设置文本矩形的坐标偏移(默认 `(0, 0)`)。
|
||||
*
|
||||
* 有些组件把内容先画进**离屏位图**再贴回(`SignalPanel` 的行位图缓存),
|
||||
* 此时回报的矩形处在位图坐标系 —— 传一位图原点偏移即可换算回屏幕坐标,
|
||||
* 调试层才能把框画在对的位置。
|
||||
*
|
||||
* @param [IN] dx 横坐标偏移。
|
||||
* @param [IN] dy 纵坐标偏移。
|
||||
*/
|
||||
void UiSetTextRectOffset(float dx, float dy);
|
||||
|
||||
/**
|
||||
* @brief 测量单行文本的像素宽度(无需 GDI+ 上下文,可在布局阶段调用)。
|
||||
* @param [IN] font 字体句柄。
|
||||
@@ -179,6 +232,14 @@ namespace jdi
|
||||
*/
|
||||
float UiMeasureTextWidth(HFONT font, const std::wstring& text);
|
||||
|
||||
/**
|
||||
* @brief 测量单行文本的字符单元高度(垂直居中口径与 `UiText` 一致)。
|
||||
* @param [IN] font 字体句柄。
|
||||
* @param [IN] text 文本内容。
|
||||
* @return 字符单元高度。
|
||||
*/
|
||||
float UiMeasureTextHeight(HFONT font, const std::wstring& text);
|
||||
|
||||
/**
|
||||
* @brief 在指定裁剪矩形内以显式起点绘制一段文本(使用 GDI ExtTextOut 裁剪)。
|
||||
*
|
||||
|
||||
Reference in new issue
Block a user