修复斜向自由拖拽视界时的卡顿/质量下降/错误绘制;预览曲线恢复抗锯齿;预览曲线不再闪烁

一、斜向拖拽退化的根因(纯水平拖拽测不出来)
平移的纵向分量 ShiftLaneRange 每帧都会小改被拖网格的 yMin/yMax,而网格幅值范围同时参与
「宽基底可用性」的几何指纹(SceneGeometryHash 原本含 yMin/yMax)与每个网格图层键的基
(LaneLayerKey 原本用全局 SceneContentHash):
  * 前者 → 每帧都判定宽基底不可用 → 退化成整幅重绘,且拖拽置 m_fastFrame=true → 关抗锯齿
    (绘制质量下降 + 卡顿);
  * 后者 → 一个网格的幅值变化让全部 5 个网格的图层作废并全部入队,而
    RenderPendingLaneRebuilds(1) 一帧只补 1 个 → 长期贴内容不一致的旧图层 = 错误绘制/断线。

二、修法
- SceneContentHash(includeStyles, includeDerived, includeLaneRange) 新增 includeLaneRange;
  SceneGeometryHash() = SceneContentHash(false, true, false) → 幅值范围不再参与
  「能不能走宽基底快路径」的判定。
- 新增逐网格 LaneLayerHash(laneIndex)(位图高度 + 该网格 yMin/yMax + 该网格各信号的
  visible/color/opacity/lineWidth/mode);LaneLayerKey(laneIndex) 的基由全局内容指纹改为它
  → 幅值变化只让那一个网格失效,其余网格保持 Ready。
- Paint 宽基底分支:RenderPendingLaneRebuilds(1) 从 BlitWideBuffer 之后移到
  RollWideBuffer() 之后、贴图之前 → 本帧预算内补好的网格本帧就可见(消除「比鼠标慢半拍」与断线)。

三、预览曲线抗锯齿
- PaintDerivedCurve 不再因 m_fastFrame 关闭抗锯齿(仅保留「陡峭段占比 > 1/8」的逃生口)。
  波形基底来自图层、永远是全质量抗锯齿;预览曲线是叠加层,交互期间关 AA 就会「比普通信号粗糙」。
  交互期间仍把顶点预算减半(低分辨率 → 松手恢复高分辨率)。

四、预览曲线闪烁
- AcquireNewestCurve(key, begin, end, spanBegin) 改为只按「信号 + 曲线种类」匹配(参数无关),
  并优先挑窗口覆盖 [begin,end] 的条目;拖参数滑块时先用上一帧的曲线顶替,后台按新参数算好后无缝替换,
  不再出现「消失一会儿又画出来」。

五、验证(全部离屏,不占用鼠标/键盘/屏幕)
- uitest 新增 [AH]:逐网格图层失效 / 斜向帧走宽基底快路径 / 参数连改 10 次 0 空白帧 /
  隔离抗锯齿断言(快帧混淆边缘像素 8149 vs 8404,旧实现该值为 2)→ 420/420 通过;
  make clean && make all 零警告。
- panperf:水平平移中位 6.17ms;斜向拖拽中位 9.16ms、p90 10.67ms、max 11.80ms,
  走宽基底快路径 40/40(修复前 0/40),像素差与水平基线同量级(仅已知的 ≤0.5px 整数像素残差)。
- layercheck:clobbers=0/24、pan frames wrong=0/4、居中图层 vs 整幅重绘逐像素 0 差异。
This commit is contained in:
DeepSeek V4.1 Flash committed 2026-10-12 14:22:14 +08:00
1 parent a30a6fcf4d
commit 0afa6360ae
3 files changed
+209 -29

No files matched your search

+79
View File
@@ -511,6 +511,8 @@ Documents/ 项目文档(含本文件)
| 2026-10-12 | DeepSeek-V4.1-Flash(**起源设备**) | **跨设备记忆合流**:把起源设备(本机)的详细工程记忆**并入本文件**(同一记忆文件,不再另建 `agent_mem_origin.md` 等旁支文件),新增 §11(跨设备协作须知)与 §12(起源设备详细记忆原文)。远端 `gitea/main` 已快进合并到本机(`7608e85` → `f97c4cf`,**16** 个提交)。本机 MinGW-w64 GCC 15.2.0 (UCRT) 下 `make release` 通过。 |
| 2026-10-12 | DeepSeek-V4.1-Flash(**起源设备**) | **修复「缩放后平移出现严重绘制错误/波形抖动/前台被拖慢」**:根因是后台图层线程会改写共享渲染状态(保存→改写→恢复`m_area`/`m_plotRect`/视界/网格矩形),与 UI 线程无锁的平移/命中测试相冲 → 视界被弹回、网格错位;叠加"全局锚点 + 逐网格内容"导致各网格时间错位。修法:**移除后台图层线程**(改为 UI 线程同步维护)、**逐网格独立锚点与滚动**(补细条用该图层自己的 `wideMin`)、跨度变化时同步 `RebuildWideBuffer()`。同时把「弱波增强」改名「**弱峰增强**」并改为 **0~200% 分段插值**(0% 完全不动 / 100% 到较温和一侧 / 200% 完全拉平;新 1.5 = 旧 0.5)。离屏验证:居中图层 vs 整幅重绘 **5 网格逐像素 0 差异**、平移帧对齐 ≤1px、24 次竞态检测 0 覆盖;测试套件 **380/380 通过**。 |
| 2026-10-12 | DeepSeek-V4.1-Flash(**起源设备**) | **修复"按住键拖拽平移时波形质量下降 / 断线 / 周期性卡顿"与"浮动面板互相覆盖时交互错位"**,并把弱峰增强改为**逐信号参数**。① 平移:`RollWideBuffer` 不再整块重画(只平移+补细条,内容过期/锚点过远只入队),新增 `RenderPendingLaneRebuilds(budget)`(**每帧最多重画 1 个网格**,其余下帧)+ `BlitWideBuffer` **局部贴图**(图层没覆盖的部分留空,不再整块跳过);"结算"整幅精确帧**仅限非拖拽且全部图层就绪**(消除拖拽中每两帧的整幅重绘/质量振荡)。实测 `VERY_BIG_DATA` 5 网格深放大平移:中位 **6.2ms**、max 7.6ms(无尖峰);按住键且视界停在边界时 **0.29ms/帧**。② 弱峰增强:`WeakPeakItem` 改为携带 `levelPercent(0–200)+iterations`,面板改为与均值滤波同构的**逐信号两个输入框**(删除网格级两滑块),哈希/快照/构建/预览全部改为逐信号。③ 浮动面板:新增 `m_panelOrder` 层序,**命中从最上层往下**、点击 `BringPanelToFront`、新面板置顶;修复"上层 ✕ / 标题栏被下层参数框抢走"。离屏测试 **388/388 通过**。 |
| 2026-10-12 | DeepSeek-V4.1-Flash(**起源设备**) | 弱峰增强的参数输入改回**逐信号滑块**(每信号两条轨道:增强等级 0–200% / 迭代次数 N),并让「迭代次数 N」**上限可就地编辑**:点击滑块右侧数值 → 整行变成输入框(`EditFilter::BYTE` 只收数字、空内容显示灰提示当前上限、`0`/超限/空 保持原值、下调后当前迭代次数自动被夹到新上限);上限进 `PanelSlotKey` 但不进 `SceneContentHash`(不影响波形重画)。离屏测试 **409/409 通过**。 |
| 2026-10-12 | DeepSeek-V4.1-Flash(**起源设备**) | **修复"斜向/不规则拖拽自由移动视界时的卡顿、掉帧与波形错误绘制"、"预览曲线不如普通信号细腻(无抗锯齿)"、"拖动参数滑块时预览曲线跳帧闪烁"**。① 根因:拖拽平移的**纵向分量**会逐帧小改被拖网格的 `yMin/yMax`,而**网格幅值范围同时参与「宽基底可用性」几何指纹与每个网格的图层键**,于是每帧都退化成整幅重绘(`m_fastFrame` 关抗锯齿)+ 5 个网格全部入队(一帧只补 1 个)→ 质量下降、卡顿、图层相互不一致(断线)。修法:`SceneContentHash` 新增 `includeLaneRange`(`SceneGeometryHash()` = `false,true,false`,幅值不进"能不能走快路径"的判定),幅值改由**逐网格** `LaneLayerHash(laneIndex)`(`LaneLayerKey` 的基)承担 → 只让真正变化的那个网格失效;并把 `RenderPendingLaneRebuilds(1)` **移到 `BlitWideBuffer` 之前**(本帧补好的网格本帧就可见)。② 预览曲线抗锯齿不再因交互(`m_fastFrame`)关闭(仅保留"陡峭段过多"这一条形同无声的逃生口)。③ `AcquireNewestCurve` 改为**只按「信号 + 曲线种类」匹配**(参数无关,优先挑覆盖所需区间的条目)→ 拖参数滑块时用上一帧的曲线顶替,后台算好再无缝替换,**不再闪烁/消失**。离屏验证:斜向拖拽 40/40 帧走宽基底快路径(中位 9.2ms,无尖峰),参数连改 10 次 **0 个空白帧**,抗锯齿回归断言(快帧混淆边缘像素 8149/8404);`uitest` **420/420 通过**、`panperf` PASS、`layercheck` 保持"0 次视界覆盖 / 平移对齐 ≤1px"。 |
---
@@ -2548,3 +2550,80 @@ Documents/ 项目文档(含本文件)
命中区之外 → 测试里按 `lround(X+W) - 1`;而**拖拽**可以超出(`UiSliderRatioFromX` 会夹到 1)。
- `make all` 零警告;`uitest` **409/409 通过**;`panperf` PASS;
`layercheck` 保持“居中图层逐像素 0 差异 / 平移对齐 ≤1px / 0 次视界覆盖”。
---
## 本轮(2026-10-12,起源设备):斜向自由移动视界退化 + 预览曲线抗锯齿 + 预览曲线闪烁
用户报告(原文要点):以 `VERY_BIG_DATA.CSV` 为例,全信号显示 + **时间轴方向选区放大**(主时间轴约 **2ms 一大格**)后,
用**鼠标中键/左键斜向拖拽**自由移动视界**仍然卡顿**,且"这种不规则的视界自由移动会导致性能问题和绘制波形质量下降、错误绘制";
同时"实验性功能的预览曲线显示质量不如普通信号,似乎没有抗锯齿";"拖动弱峰增强滑块时预览曲线**消失一会儿又画出来**(跳帧闪烁)"。
### A. 斜向拖拽的根因(为什么"纯水平"测不出来)
`ShiftLaneRange(lane, dy)`(拖拽的纵向分量 → 网格幅值平移)每帧都会修改该网格的 `visual.yMin/yMax`,而:
1. `SceneGeometryHash()` 原本 = `SceneContentHash(false)`,**包含每个网格的 `yMin/yMax`** → 幅值一变,"场景几何变了",
于是**每一帧都判定宽基底不可用** → 退化到整幅重绘,并因拖拽置 `m_fastFrame = true` → **整幅 + 关抗锯齿**(质量下降 + 卡顿)。
2. `LaneLayerKey(laneIndex)` 的基也是**全局** `SceneContentHash(true, false)` → 幅值一变,**5 个网格的图层全部作废**并全部入队;
而 `RenderPendingLaneRebuilds(1)` **一帧只补 1 个** → 一直贴的是内容不一致的旧图层 = **错误绘制/断线**;
并且该调用点在 `BlitWideBuffer` **之后**,本帧补好的网格要到下一帧才显示("波形比鼠标慢半拍")。
⚠️ 这解释了自动化盲区:**纯水平平移**不会改幅值,所以旧探针"看起来一切正常";只有"斜向/不规则"拖拽才暴露。
### B. 修法(三个指纹各司其职)
- `SceneContentHash(bool includeStyles, bool includeDerived, bool includeLaneRange = true)`:
新增 `includeLaneRange`;`SceneGeometryHash()` = `SceneContentHash(false, true, **false**)`
→ **幅值范围不再参与"能不能走宽基底快路径"的判定**(它只影响"画到哪里",不影响"几何结构")。
- 新增 **`LaneLayerHash(laneIndex)`**:单网格图层的内容指纹 = 位图高度 + 该网格 `yMin/yMax` + 该网格各信号的
`visible/color/opacity/lineWidth/mode`;`LaneLayerKey(laneIndex)` 的基由全局内容指纹改为它。
→ 幅值变化**只让那一个网格**的图层失效(其余网格保持 Ready,零复制)。
- `Paint()` 的宽基底分支里,`RenderPendingLaneRebuilds(1)` 从 `BlitWideBuffer` **之后**移到 `RollWideBuffer()` **之后、贴图之前**
→ 本帧预算内补好的网格**本帧**就可见(消除"慢半拍/断线")。
### C. 预览曲线抗锯齿(用户:"似乎没有过抗锯齿机制")
- `PaintDerivedCurve` 原本 `if (m_fastFrame || spiky) SetSmoothingMode(None)`。
波形**基底**来自图层,**永远**是全质量抗锯齿;预览曲线却在任何交互期间变成无抗锯齿 → 叠加在一起就是"预览比普通信号粗糙"。
- 改为 **`if (spiky)`**:只有"陡峭段占比 > 1/8"的形状(方波/编码器)才放弃抗锯齿(那种形态下**观感几乎无差别**,
而实测代价极大:2448 顶点 26~37ms vs 无抗锯齿 3.5ms)。预览曲线只是叠加层、可见区间很小,抗锯齿代价可以承受。
- 交互期间**仍然**把顶点预算减半(`budget / 2`,即"低分辨率 → 松手恢复高分辨率"),只是不再关抗锯齿。
### D. 预览曲线闪烁(拖参数滑块时消失一会儿)
`AcquireNewestCurve(key, spanBegin)` 原本要求 **`entry->key == key`(参数完全相同)**。
拖滑块时参数每帧都在变 → 上一帧的曲线"键不同" → 找不到任何可用的旧曲线 → `CurveSpanFor` 返回 `nullptr` →
本帧**无曲线可画**(消失),直到后台按新参数算完并发布(间隔一会儿又出现)= 用户看到的闪烁。
修法:`AcquireNewestCurve(key, begin, end, spanBegin)` **只按 `key.signal` / `key.kind` 匹配**(参数无关),
并**优先挑「窗口覆盖所需区间 `[begin,end]`」的条目**(覆盖不到才退化为"最新的")。旧曲线只是参数略旧,
按采样下标映射位置仍然完全正确 → 视觉上平滑过渡而非闪烁。
### E. 离屏验证(不占用鼠标/键盘/屏幕)
- `uitest` 新增 `[AH]`(斜向拖拽 + 预览曲线连续性 + 抗锯齿):
① `LaneLayerKey` 逐网格失效(改 1 号网格幅值 → 1 号键变、2 号键**不变**);
② "同时平移 + 改幅值"的一帧 `m_wideLastValid == true`(走宽基底快路径)、未动的网格保持 Ready;
③ 参数连改 10 次:最差派生像素 21013(预热 22629),**空白帧 0 / 10**;
④ **隔离抗锯齿断言**:把 `PaintDerivedCurve` 画到两张 `gd::Bitmap` 上(`m_fastFrame = false` / `true`),
统计"既不是背景也不是纯线色的**混淆边缘像素**"→ 普通帧 8158/8420、快帧 8149/8404(都远大于 1/10)
—— 这正是回归护栏:**旧实现快帧的混淆像素只有 2 个**(断言立刻失败)。
⚠️ 写这类隔离测试的两个坑:GDI+ `Bitmap` **不保证初始为黑**(要 `Graphics::Clear`);测试曲线要用
**网格自己的值域**(`yMin..yMax`)且只画几个周期,否则曲线"每段都陡峭"会踩到那条无抗锯齿的逃生口,测出来的不是真问题。
- `panperf`(同一深放大区间,5 网格,每帧 60px 水平 / 斜向 60px+3px):
* 水平平移 40 帧:中位 **6.17ms** / p90 7.13 / max 9.22;
* **斜向拖拽 40 帧:中位 9.16ms / p90 10.67 / max 11.80,走宽基底快路径 40/40**(修复前该路径 0/40);
* 与整幅重绘的像素差:斜向最差 79809,水平基线 77310~80919 —— **同一量级**,即只有那套已知的 ≤0.5px 整数像素残差,
不存在"质量下降"或"错误绘制"。
- `layercheck`:`clobbers=0/24`、`pan frames wrong=0/4`、居中图层 vs 整幅重绘逐像素 0 差异(未回归)。
- `make clean && make all` 零警告;`uitest` **420/420 通过**。
### F. 教训(写进 §11.2 硬约束)
1. **网格幅值范围(`yMin/yMax`)不得进入"几何/内容"指纹**(那会让"平移的纵向分量"每帧毁掉快路径);
它只属于**该网格自己的图层指纹**。
2. **图层指纹必须逐网格**:任何"一个网格的变化使全部网格作废"的全局指纹都会把"一帧只补 1 个"的预算变成永久不一致。
3. **待重画网格要在贴图之前补**,否则用户看到的是"比鼠标慢半拍"的旧像素。
4. **异步发布的派生曲线必须有"参数无关"的兜底**(按信号 + 种类取最新),否则拖参数滑块必然闪烁。
5. **交互优化只能降分辨率(顶点数),不能关抗锯齿**:基底图层永远是全质量抗锯齿,叠加层一旦关了就会"看着更粗糙"。