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:
DeepSeek V4.1 Flash committed
1 parent
24706c906a
commit
57e12cfb27
14 files changed
+630
-191
No files matched your search
@@ -567,29 +567,24 @@ namespace jdi
|
||||
{
|
||||
UiComponent::CollectDebugBoxes(boxes);
|
||||
|
||||
// 层级 1：每个网格的波形区；层级 2：该网格的 GX 编号徽标与装饰层矩形。
|
||||
// 层级 1：每个网格的波形区；层级 2：该网格的 GX 编号徽标。
|
||||
// ⚠️ **绝不能读 `m_decorRects`**：那里存的是"装饰层位图缓存"的登记矩形，
|
||||
// 坐标处在**位图/图层坐标系**（会带负 Y、或超出绘图区），拿它当屏幕矩形会出现
|
||||
// 横跨工具栏与绘图区的巨型幽灵框（用户报告的"绘制残留"的直接原因）。
|
||||
// 需要装饰元素的屏幕几何时，请用 `m_legendHits`（屏幕坐标）或 `LaneBadgeRect`。
|
||||
for (std::size_t index = 0; index < m_lanes.size(); ++index)
|
||||
{
|
||||
const LaneVisual& lane = m_lanes[index];
|
||||
boxes.Add(lane.rect, 1, L"lane " + std::to_wstring(index + 1));
|
||||
boxes.Add(lane.rect, 1);
|
||||
|
||||
// GX 编号徽标：矩形由 `LaneBadgeRect` 统一给出（绘制与命中都用它）。
|
||||
boxes.Add(LaneBadgeRect(static_cast<int>(index)), 2, L"G");
|
||||
|
||||
// 装饰层矩形（图例托底 / “无信号” / “更多”）：绘制时已登记在 `m_decorRects`。
|
||||
for (const gd::RectF& decor : m_decorRects)
|
||||
{
|
||||
if (decor.Y >= lane.rect.Y && decor.Y < lane.rect.Y + lane.rect.Height)
|
||||
{
|
||||
boxes.Add(decor, 2);
|
||||
}
|
||||
}
|
||||
boxes.Add(LaneBadgeRect(static_cast<int>(index)), 2);
|
||||
}
|
||||
|
||||
// 层级 2/3：图例条目（托底 + 色块 + 文本），绘制时已登记在 `m_legendHits`。
|
||||
for (const LegendHit& hit : m_legendHits)
|
||||
{
|
||||
boxes.Add(hit.rect, 2, L"legend");
|
||||
boxes.Add(hit.rect, 2);
|
||||
boxes.Add(hit.swatch, 3);
|
||||
boxes.Add(hit.text, 3);
|
||||
}
|
||||
@@ -608,18 +603,18 @@ namespace jdi
|
||||
{
|
||||
continue;
|
||||
}
|
||||
boxes.Add(layout.panel, 2, L"panel");
|
||||
boxes.Add(layout.title, 3, L"title");
|
||||
boxes.Add(layout.close, 3, L"x");
|
||||
boxes.Add(layout.panel, 2);
|
||||
boxes.Add(layout.title, 3);
|
||||
boxes.Add(layout.close, 3);
|
||||
boxes.Add(layout.disclosure, 3);
|
||||
boxes.Add(layout.badge, 3, L"G");
|
||||
boxes.Add(layout.badge, 3);
|
||||
boxes.Add(layout.edit, 3);
|
||||
boxes.Add(layout.button, 3);
|
||||
boxes.Add(layout.content, 3, L"content");
|
||||
boxes.Add(layout.scrollTrack, 3, L"scroll");
|
||||
boxes.Add(layout.content, 3);
|
||||
boxes.Add(layout.scrollTrack, 3);
|
||||
boxes.Add(layout.scrollThumb, 4);
|
||||
boxes.Add(layout.opacityTrack, 3, L"track");
|
||||
boxes.Add(layout.opacityValue, 3, L"value");
|
||||
boxes.Add(layout.opacityTrack, 3);
|
||||
boxes.Add(layout.opacityValue, 3);
|
||||
boxes.Add(layout.showDelta, 3);
|
||||
boxes.Add(layout.showEnum, 3);
|
||||
|
||||
@@ -638,15 +633,15 @@ namespace jdi
|
||||
|
||||
for (const EdgePanelLayout::MarkerGroup& group : layout.markerGroups)
|
||||
{
|
||||
boxes.Add(group.header, 3, L"group");
|
||||
boxes.Add(group.header, 3);
|
||||
boxes.Add(group.tableHeader, 3);
|
||||
boxes.Add(group.triangle, 4);
|
||||
boxes.Add(group.close, 4, L"x");
|
||||
boxes.Add(group.close, 4);
|
||||
}
|
||||
for (const EdgePanelLayout::MarkerRow& row : layout.markerRows)
|
||||
{
|
||||
boxes.Add(row.rect, 4, L"marker");
|
||||
boxes.Add(row.close, 4, L"x");
|
||||
boxes.Add(row.rect, 4);
|
||||
boxes.Add(row.close, 4);
|
||||
}
|
||||
}
|
||||
}
|
||||
@@ -768,7 +763,9 @@ namespace jdi
|
||||
// 网格次序拖拽：静态场景缓存仍然有效，但各网格要按位移重新"摆放"。
|
||||
// 这里逐网格把缓存中的横向条带平移贴回（几十微秒），
|
||||
// 因此拖动百万级采样的网格时依然流畅，且被拖网格的波形随鼠标自由移动。
|
||||
if (m_dragMode == PlotDragMode::LANE_REORDER && m_laneDragFrom >= 0 && m_sceneValid)
|
||||
// ⚠️ `m_forceFullRepaint`（调试叠加层）下必须跳过：局部贴图会留下上一帧的边界。
|
||||
if (!m_forceFullRepaint && m_dragMode == PlotDragMode::LANE_REORDER && m_laneDragFrom >= 0 &&
|
||||
m_sceneValid)
|
||||
{
|
||||
PaintLaneReorder(g);
|
||||
paintOverlays();
|
||||
@@ -780,7 +777,7 @@ namespace jdi
|
||||
// 大文件下整幅重绘约 80ms，贴图约 1ms —— 鼠标悬停、拖拽选区这些
|
||||
// "只改一小块叠加层"的交互因此不再重绘波形。
|
||||
// 随鼠标变化的内容（悬停高亮、读数框、选区、光标、拖拽虚影、输入框）一律画在贴图之后。
|
||||
if (SceneCacheMatches() && BlitSceneCache(g))
|
||||
if (!m_forceFullRepaint && SceneCacheMatches() && BlitSceneCache(g))
|
||||
{
|
||||
// ⚠️ **顺手做一次"空闲预热"**：图层不存在（刚加载 / 网格数量变化）或仍是旧跨度时，
|
||||
// 在这里用既有预算机制**每帧至多补 1 个网格**。若不预热，用户第一次平移 / 选区放大
|
||||
@@ -804,7 +801,8 @@ namespace jdi
|
||||
// ⚠️ **不要求"正在拖拽"**：非拖拽的视界变化（键盘方向键 / 工具栏）同样走此快路径，
|
||||
// 避免该放大区间"整幅重绘约 124ms"的卡顿。
|
||||
bool wideUsable = false;
|
||||
if (HasDrawableContent() && m_sceneValid && m_sceneGeometryHash == SceneGeometryHash())
|
||||
if (!m_forceFullRepaint && HasDrawableContent() && m_sceneValid &&
|
||||
m_sceneGeometryHash == SceneGeometryHash())
|
||||
{
|
||||
std::vector<std::vector<SceneStyleEntry>> currentStyles;
|
||||
CollectSceneStyles(currentStyles);
|
||||
@@ -947,7 +945,7 @@ namespace jdi
|
||||
// 再写回缓存。（VERY_BIG_DATA 实测：整幅重绘 30ms+，单网格重画约 4ms。）
|
||||
{
|
||||
std::vector<int> patchLanes;
|
||||
if (FindStyleOnlyLanes(patchLanes) && BlitSceneCache(g))
|
||||
if (!m_forceFullRepaint && FindStyleOnlyLanes(patchLanes) && BlitSceneCache(g))
|
||||
{
|
||||
// ⚠️ 样式**正在连续变化**（拖透明度 / 粗细 / 拾色滑块）：这本身就是一种"交互中"。
|
||||
// 若不切换快速帧，本帧会用**抗锯齿**重画波形包络带 —— 实测单条网格的包络带
|
||||
|
||||
Reference in new issue
Block a user