修复自适应/首帧卡顿回归 + 派生信号烘值 + 图例交互与托底重做
一、性能（详见 agent_mem §9.19） - AutoRangeLaneToView：把 DataSet::Style(ref) 从逐采样循环里提出来（远端新增的「调整」 功能让它每个采样点解析两次，实测 147ms 劣化到 1200ms），并在「视界覆盖整条信号且 无任何数值变换」时直接取信号已缓存的 min/max（O(1)）。工具栏「Y 轴自适应」在全视图下 1200ms → 0.02ms，结果与逐点扫描逐位一致；有变换时仍逐点套用与绘制相同的变换。 - 新增 WarmLaneLayersStep()：加载后宽基底图层从未分配，用户第一次平移/选区放大时 Paint 会在那一帧同步重建全部网格图层（首帧 64.3ms）。现在改为在「命中静态场景缓存」 （视界未变、非拖拽）时用既有预算机制每帧至多补 1 个网格，把整批重建摊到静止帧； 选区放大首帧 64.3ms → 13.0ms。 二、派生信号 - 「构建为新信号」把源信号的「调整」变换（系数 → 绝对值 → 垂直镜像 → Y 偏移，以及 水平镜像=数据反序）烘进派生采样值，新信号样式一律保持默认（不再是"继承的指纹"）； 仅时间轴偏移 offsetTime 因派生信号与源信号共用同一个文件时间轴仍需继承。 三、交互 - 网格 GX 拖拽让位判据改为「鼠标指针」：指针越过相邻网格的中心水平线即让位并出现吸附 提示（原先按"被拖网格的中心"，要求把整个网格拖过去一格才吸附）。 - GX 徽标悬停高亮：徽标本体在装饰缓存里被冻结，高亮改为贴图之后的叠加层，并新增 m_hoverBadge 状态驱动重绘/取消；QueryCursor 在徽标上返回 IDC_HAND —— 与左侧信号列表 里同一个 GX 徽标一致。 - 修复「中键平移过视界之后图例悬停/点击/双击改名全部失效」：整幅重绘路径会清空 m_legendHits，而装饰缓存命中时 PaintLaneLegend 提前 return 导致永不重建。现在把该函数 拆成「几何 → 命中/装饰矩形 → 绘制」三段，任何路径都先重建命中矩形。 四、绘制 - 每个信号图例单独加圆角托底（配色/圆角风格与 GX 徽标一致）；装饰矩形改为逐块 （徽标一块 + 每个条目一块 + 每个 Y 轴胶囊一块），不再覆盖整条图例带；每块托底先用 不透明底色铺满「外接整数像素再外扩 1px」的矩形再画圆角 —— 消除「GX/图例周边旧波形 像素残留」（逐像素验证：装饰矩形内 0 差异）。 - 图例悬停高亮改为不透明托底并在其上重绘色块与文字（否则不透明托底会把图例内容盖住）， 同时保留对应信号的曲线光晕；Y 轴刻度胶囊补不透明外接底色，消除同类残留。 验证：离屏 Application harness（窗口 SW_HIDE + 直接注入鼠标消息 + 从后备缓冲区截图， 不占用鼠标/键盘/屏幕）40/40 通过；zoomcheck 新增 mode 20-26 量化；make release 零警告。
This commit is contained in:
DeepSeek V4.1 Flash committed
1 parent
940b8e67e6
commit
7c32eca004
4 files changed
+590
-183
No files matched your search
@@ -681,6 +681,126 @@ GDI+ 抗锯齿逐段扫描这些**近竖直、满幅**的边，代价爆炸（
|
||||
|
||||
---
|
||||
|
||||
### 9.19 远端「调整」功能带来的性能回归 + 首帧卡顿根治 + 图例交互/托底重做（本轮）
|
||||
|
||||
> 接手背景：远端（`c334390`…`940b8e6`）新增了样式区「调整」（系数/绝对值/镜像/偏移）与
|
||||
> 标题栏内存占用等。本轮先**逐项量化**再修，全部离屏验证（不占用鼠标/键盘/屏幕）。
|
||||
|
||||
#### 一、性能回归：`AutoRangeLaneToView` 把 `Style(ref)` 放进了逐采样循环（**8 倍**）
|
||||
|
||||
- **症状**：加载 `VERY_BIG_DATA.CSV` 并显示全部信号后，**点一下工具栏「Y 轴自适应」开关**就卡顿
|
||||
很久；从局部放大状态 `FitAll` 回全局同样卡。
|
||||
- **量化**（新增 `.preflight/perf/zoomcheck` mode 21/23）：
|
||||
- `SetAllLanesAutoFitToSelection(true,true)`（全视图、5 个网格）：**修复前 1200ms → 修复后 0.02ms**；
|
||||
旧提交（`20b9084`）为 **147ms** —— 即远端把这一步劣化了约 8 倍。
|
||||
- `AutoRangeLaneToView(0)`（单网格、全视图）：**修复前 ≈240ms → 修复后 0.012ms**，且结果与
|
||||
「逐采样扫描」的参考值**逐位一致**（`match=1`）。
|
||||
- **根因**：远端为支持「调整」变换，把 `m_dataSet->Style(ref)` **写在了逐采样循环体里**（还写了两次）——
|
||||
`Style()` 每次都要解析文件/信号下标；2580 万 × 5 次 × 2 = 亿级解析调用。
|
||||
- **修法（显示效果零变化）**：
|
||||
1. **把样式指针提到循环外**（`resolvedStyle`），并预计算 `mirrored` / `transform` 两个布尔。
|
||||
2. **整段自适应走 O(1)**：`timeMonotonic && begin==0 && end==count && !mirrored && !transform &&
|
||||
finiteCount>0` 时直接取信号**已缓存的 `minValue/maxValue`**（与 `ComputeStats` 同源，
|
||||
因此结果与逐点扫描完全一致）。
|
||||
3. 无变换时走**紧凑循环**（无逐点分支，便于向量化）；有变换/水平镜像时逐点套用与绘制相同的变换。
|
||||
- ⚠️ 有「调整」变换时仍必须逐点扫描（158ms/单网格，全视图）——这是变换语义的固有代价。
|
||||
|
||||
#### 二、首帧卡顿根治：**空闲预热「每网格信号图层」**
|
||||
|
||||
- **复现与量化**（`zoomcheck` mode 22，`VERY_BIG_DATA` 5 网格，同一负载下 A/B）：
|
||||
加载 → 静止 → 第一次「选区放大」的**首帧**：旧提交 **64.3ms**、本轮修复前 **54ms**。
|
||||
- **根因**：加载后画面走的是「静态场景缓存贴图」，**宽基底图层从未被分配**；用户第一次平移/缩放时
|
||||
`Paint` 里 `if (!LayersAllocated()) RebuildWideBuffer();` 会在**那一帧同步重建全部 5 个网格图层**
|
||||
（实测整帧 = 5 个图层同步重建 + 占位拉伸）。逐项拆解（mode 25/26）：
|
||||
占位 `StretchBlt`（HALFTONE）×5 ≈16ms、装饰层命中缓存仅 0.4ms、**其余全是整批图层重建**。
|
||||
- **修法**：新增 `PlotView::WarmLaneLayersStep()`，在**命中静态场景缓存**的那条快路径里调用
|
||||
（⇒ 本帧视图与缓存同源、**视界没有变化**、且**不在拖拽中**）：
|
||||
- 图层数组与网格数量不符时先对齐（多余图层 `ReleaseLaneLayer` 后 `resize`）；
|
||||
- 用既有预算机制 `RollWideBuffer()` + `RenderPendingLaneRebuilds(1)` **每帧至多补 1 个网格**，
|
||||
队列非空时 `PostMessage(kMessagePlotDerivedReady)` 让宿主再送一帧，直到补齐。
|
||||
- ⇒ 整批重建的代价被**摊到若干静止帧**上，**任何交互帧都不再承担它**。
|
||||
- **效果**（同一负载，mode 22）：首帧 **64.3ms → 13.0ms**（≈5 倍）；`zoomcheck` mode 0 逐步缩放
|
||||
f1 也同步下降。图层数一旦就绪，后续交互全程走"占位拉伸 + 每帧补 1 个网格"。
|
||||
- ⚠️ 预热只在**视界不变**时推进，因此不会在用户拖动时做无用功；视界一变，宽基底路径自己按预算补。
|
||||
|
||||
#### 三、派生信号：把「调整」**烘进数据**，不再继承指纹
|
||||
|
||||
- **用户要求原文**："重建出来的新信号原本不经过调整就已经是预览状态的样子，而不是继承指纹"。
|
||||
- **旧行为**（`fc77b02`）：把源信号的 `gain/absolute/mirrorVideo/mirrorHorizontal/offsetY/offsetTime`
|
||||
复制给新信号的 `SignalStyle` —— 新信号只是"套了一层同样的调整"，数据本身没变，
|
||||
「调整」面板里还莫名带着一整套参数。
|
||||
- **新行为**（`Application::BuildDerivedSignal`）：
|
||||
1. 快照源信号样式；
|
||||
2. 滤波结果算完后，**逐点套用 `ApplyDrawTransform`**（系数 → 绝对值 → 垂直镜像 → Y 偏移）写回采样值；
|
||||
3. **水平镜像 = 数据反序**：把派生采样数组整体反转（`ApplyDrawTransform` 是逐点函数，
|
||||
"先变换再反转"与"先反转再变换"等价）；
|
||||
4. 新信号样式一律**保持默认**（`gain=1 / absolute=false / 两个镜像=false / offsetY=0`）。
|
||||
- ⚠️ **唯一例外：时间轴偏移 `offsetTime` 仍由样式携带**——它改变的是"绘制在哪个时刻"，
|
||||
而派生信号与源信号**共用同一个文件时间轴**，无法把时间平移烘进采样数据；
|
||||
若不继承，新信号会相对预览整体横向错位。已在该函数注释中写明。
|
||||
- 验证（本轮 `verify` harness）：`derived.values[i] == ApplyDrawTransform(tf, float(source[count-1-i]))`
|
||||
逐点一致；新样式各项均为默认；`offsetTime` 保留。
|
||||
|
||||
#### 四、网格 GX 拖拽让位阈值 + 徽标悬停
|
||||
|
||||
- **让位判据改为「鼠标指针」**（`LaneDragTargetAt`）：`index = floor((mouseY - firstTop)/laneHeight + 0.5)`。
|
||||
- 旧判据用"**被拖网格的中心**"，等价于要求把整个网格拖过去一格才吸附（用户报告"要拖到另一个网格
|
||||
的位置附近才有吸附提示"）。新判据下**只有两个网格时，鼠标越过 G1 的中心水平线，G1 立刻让位并
|
||||
出现吸附提示**；任意网格数下都成立（进入相邻网格的上半即让位）。
|
||||
- **GX 徽标悬停提示**：徽标本体画在静态场景 / 装饰缓存里（被冻结），因此悬停高亮必须是**叠加层**
|
||||
——新增状态 `m_hoverBadge`（`OnMouseMove` 里更新、`OnMouseLeave` 里清零，因为鼠标在同一网格的
|
||||
徽标范围内移动时 `m_hoverLane` 不变），`PaintLegendHighlight` 在贴图之后**重画徽标**
|
||||
（不透明底色铺满外接矩形 + `accentSoft` 圆角底 + `accent` 描边 + `textStrong` 文字），
|
||||
与左侧信号列表里同一个 GX 徽标的悬停效果完全一致；`QueryCursor` 在徽标上返回 `IDC_HAND`。
|
||||
|
||||
#### 五、图例：命中矩形在装饰缓存路径下**必须重建**（悬停/点选失效的真因）
|
||||
|
||||
- **症状**：一旦用中键平移过视界，网格图例的**悬停高亮 / 点击选中 / 双击改名全部失效**。
|
||||
- **根因**：`m_legendHits` 只在**整幅重绘**路径开头被 `clear()`，随后靠 `PaintLaneLegend` 重新填充；
|
||||
而装饰缓存命中时 `PaintLaneLegend` **提前 return**（跳过绘制）→ 命中矩形列表**被清空且永不重建**。
|
||||
中键平移后必然出现一次"装饰缓存有效的整幅重绘"（结算帧），于是图例从此点不动。
|
||||
- **修法（结构性）**：把 `PaintLaneLegend` 拆成「**几何 → 命中/装饰矩形 → 绘制**」三段：
|
||||
- 先用**唯一来源**算出"放得下的条目"及其托底矩形（命中矩形 == 托底矩形，看到的与点得到的严格一致）；
|
||||
- **无论是否命中装饰缓存都重建 `m_legendHits` 与 `m_decorRects`**，之后才 `if (m_useDecorCache) return;`；
|
||||
- 绘制段只负责画像素。
|
||||
|
||||
#### 六、图例托底 + 消除「旧波形像素残留」
|
||||
|
||||
- **症状**：中键把密集波形区域推过左上角 GX 编号/图例区域后再移开，**GX/图例周边残留旧波形像素**。
|
||||
- **根因**：远端 `c334390` 去掉了图例的整块不透明托底后，装饰缓存捕获的那**一条大矩形**
|
||||
里包含了**它下面的波形像素**（波形会透出），而装饰指纹 `SceneDecorHash()` 不含视界 ⇒
|
||||
平移贴回时把旧视界的波形一起贴了回来。
|
||||
- **修法**：
|
||||
1. **每个图例条目各自一块圆角托底**（`kLegendPlateRadius = 4`），风格与 GX 徽标一致
|
||||
（`cardBg` 底 + `border` 描边；选中态用 `selection` 底 + `accent` 描边）；
|
||||
2. **装饰矩形改为逐块**（徽标一块 + 每个条目一块 + 每个 Y 轴胶囊一块），
|
||||
**不再覆盖整条图例带** —— 中间的波形像素因此完全不进缓存；
|
||||
3. 每块托底先用**不透明底色铺满其"外接整数像素再外扩 1px"的矩形**再画圆角：
|
||||
否则圆角之外那几个像素仍是波形，会被烘进缓存（`CaptureDecorCache` 的边界由 `floor/ceil` 得出，
|
||||
必须完全落在不透明填充内）。Y 轴胶囊同理。
|
||||
4. 悬停高亮（随鼠标变化）画在**贴图之后**：不透明 `accentSoft` 圆角矩形 + `accent` 描边，
|
||||
并**在原托底上重绘色块与文字**（`LegendHit` 现在记录色块矩形/文本矩形/颜色/已省略文本）——
|
||||
不透明托底若只画底色会把图例内容整块盖住（只剩一个空色块）。
|
||||
悬停时**同时**画对应信号的曲线光晕（`PaintSignalHaloFor`）。
|
||||
- **实测**（`verify` harness）：把"宽基底快路径的实时帧"与"同一视界从零重绘的装饰"逐像素比较，
|
||||
**全部装饰矩形内差异 = 0**（`decor ghost check: total=0 worst=0 rects=23`）——
|
||||
直接证明缓存像素与时间视界无关、不会残留旧波形。
|
||||
|
||||
#### 七、验证工具（本轮新增，均在 `.preflight/` 下，不入库）
|
||||
|
||||
- `.preflight/perf/verify_main.cpp`（`build.ps1 -Main verify_main.cpp -Out verify.exe`）：
|
||||
**离屏 Application harness**（`Initialize(GetModuleHandleW(nullptr), SW_HIDE)` + 直接注入鼠标消息 +
|
||||
从 `m_backDc` 截图），**40 项检查全部通过**，覆盖：自适应正确性（恒等/变换/镜像、与逐点扫描逐位一致）、
|
||||
派生信号烘值与样式默认、拖拽让位阈值（鼠标越过中线即让位）、平移后图例命中与可点选、
|
||||
装饰矩形不覆盖整条图例带、图例悬停有可见高亮、GX 徽标悬停有可见高亮且离开后清除、
|
||||
**装饰矩形内 0 像素残留**。还会导出 `verify_legend.png` / `verify_legend_hover.png` 供目视核对。
|
||||
- `.preflight/perf/zoomcheck_main.cpp` 新增 mode：20（FitAll from deep zoom）、21（全局 Y 轴自适应开关）、
|
||||
22（选区放大首帧 + 图层的空闲预热进度）、23（自适应**正确性**与耗时）、24（带着色自适应 FitAll）、
|
||||
25（首帧拆解）、26（占位拉伸 HALFTONE vs COLORONCOLOR 与装饰重绘耗时）。
|
||||
- 旧版本 A/B 基线用 `git worktree add --detach ..\jdi_old 20b9084` 建立。
|
||||
|
||||
---
|
||||
|
||||
## 10. 变更日志（本文件维护记录）
|
||||
|
||||
| 日期 | 设备/模型 | 摘要 |
|
||||
@@ -712,6 +832,7 @@ GDI+ 抗锯齿逐段扫描这些**近竖直、满幅**的边，代价爆炸（
|
||||
| 2026-10-12 | DeepSeek-V4.1-Flash（**另一台设备**） | **修复「垂直中键拖拽后再平移，网格内容纵向跳变 / 绘制错误」**（详见 §9.16）：根因是 `RenderLaneLayerRegion` 结束时**无条件**把 `layer.anchorYMax` 重置为"当前 `yMax`"—— 对整块重画 / 纵向补条成立，但**横向补细条（只改一条竖带、其余像素仍在原锚点）**不成立。纵向拖动以 `kLayerRollQuantum=16px` 量化，停下时图层会残留 `<16px` 的纵向偏移且 `anchorYMax != 当前 yMax`；第一次水平微移就把该偏移**静默清零**（`vOffset→0`）而像素未动 → 整个网格波形纵向错位（最多 15px）。修法：`RenderLaneLayerRegion` 新增形参 `anchorYMax`，内部以它作幅值映射基准（`yMin = anchorYMax - laneSpan`）渲染并写回 `layer.anchorYMax`；横向补条传 `layer.anchorYMax`（保持不变），整块重画/纵向补条传当前（或滚动后）`yMax`。`vOffset==0` 时新旧逻辑完全等价。验证：新增离屏探针 `.preflight/perf/pancheck`（窗口 `SW_HIDE` + 注入消息 + 读图层内部 `anchorYMax`/`vOffset` + 持按钮帧 vs 释放后整幅帧的纵向互相关）：修复前 A 场景 `dy=+15px`（lane0 差异 39245），修复后 **`dy=0`**（差异 1220，仅已知列相位残差）；对照/中间网格/长距水平/斜向/松开重按共 7 个场景在缩放 0/8/26 步下全部 `dy=0`（中间网格 `+1px` 为整像素量化残差）；`make clean && make all` 零警告。 |
|
||||
| 2026-10-13 | DeepSeek-V4.1-Flash（**另一台设备**） | **交互流畅性三项修复**（详见 §9.17）：① **光标不再跟随视界**——删除 `ClampCursorsAfterPan()` 及其在平移路径（中键/左键拖拽、Shift+滚轮、方向键）的三处调用，视图变化时光标时间位置**完全不变**（可滑出视口），`ClampCursorToView()` 只在拖拽光标时使用（mode 14：平移 20 帧后 `CursorTime` 不变且 `offViewport=1`）。② **缩放首帧不再卡顿**——根因是跨度变化时 `Paint` 会**同步重建全部 5 个网格图层**（实测 70~80ms）+ 随后整幅结算（40ms）＝单次缩放 ~110ms 卡顿；修法：`BlitWideBuffer` 对跨度过期的图层改用**旧像素 `StretchBlt` 拉伸占位**（不再跳过导致空白）、`Paint` 只在"图层数量不符"时同步重建（新增 `LayersAllocated()`）、`RenderPendingLaneRebuilds` 允许按新跨度重建、且**只在视界稳定后**才花预算精细重绘（`viewStopped` 门控）；实测首帧 **70~80ms → ~10ms**。保留"结算"帧（实测宽基底路径与整幅重绘有 17 万+ 像素列相位差，非同源）。③ **超大信号拖预览滑块**——量化发现开销**不在绘制**（`PaintLaneDerivedOverlays` 仅 0.375ms），而在"参数每帧变化"触发的**整条信号**（2576 万采样）预览重算调度；新增 `kHugeSignalPreviewSamples=4000000`，超大信号拖拽期间不再每帧排队重算（15.0→13.7ms，**剩余 ~8ms 根因未完全定位**）。验证：`pancheck` 7 场景全 `dy=0`、`zoomcheck` mode 0/13/14、`make clean && make all` 零警告。 |
|
||||
| 2026-10-13 | DeepSeek-V4.1-Flash（**另一台设备**） | **深放大中键拖拽卡顿（根因＝GDI+ 抗锯齿"满幅锯齿"病态）+ 横向补条裁剪 + 并行网格图层（B/C，详见 §9.18）**。① **B 拆解**：该视界（`[10.2719,10.2831]s`）下 `RollWideBuffer` 补条重绘 **13.08ms**，其余 ≤0.8ms —— 瓶颈全在补条重绘。② **补条裁剪**：横向补条只覆盖窄竖带，却按整条宽窗口构建/描边整段折线；改为按条带 x 范围裁剪采样区间（旁路折线缓存），`RollWideBuffer` **13.08ms → 1.73ms**，拖拽整帧 13~24ms → ~3ms，且**逐像素 0 差异**。③ **病态根因**：拖拽超出预渲染余量时走整块重画，**整宽单网格渲染 655ms** —— 同 4481 点 `DrawLines` 实测 **AA 694ms / 无 AA 29ms（23 倍）**（编码器方波在 1~2 采样/像素形成每列整幅跳变的锯齿，原实现此时既不走包络也不关 AA）；修法：**包络带阈值从 2 采样/像素降到 1**，并扩展"梳状（关 AA）"判据（多数列列内跨幅 >0.5×网格高 / 相邻列整幅跳变）——**几何一字未改**；整宽渲染 **655→47.7ms**、补条 6.9→2.4ms、拖拽 200 帧 **avg 4.5 / max 5.8ms / 0 帧 >8ms**。④ **C（用户解除多线程限制）**：实现 `RebuildLaneLayersParallel` —— 每线程一个**隔离 `PlotView`**（自有 `m_workerTab`/`m_area`/`m_plotRect`/`m_lanes`）渲染不同网格，主线程 join 后按真实下标重算 key；并行 vs 顺序**逐像素 0 差异**；⚠️ 踩坑：`BuildLaneVisuals` 在 `m_tab==nullptr` 时清空 `m_lanes`，故**必须给 worker 一个非空的自有 tab**。**诚实结论：并行仅 1.03x**（同机 4 线程 CPU 真并行 3.98x → GDI+ 光栅化被串行化），故**并行对光栅化无收益**，仍保持"视界停后每帧补 1 个网格"。验证：`dragperf` mode 0/1/3/5/6/8/9、`pancheck` 全 `dy=0`、`zoomcheck` 无回归、`make clean && make all` 零警告。 |
|
||||
| 2026-10-14 | DeepSeek-V4.1-Flash | **修复远端「调整」功能引入的性能回归 + 根治首帧卡顿 + 图例交互/托底重做（详见 §9.19）**。① **8 倍回归**：远端把 `DataSet::Style(ref)` 写进了 `AutoRangeLaneToView` 的逐采样循环（亿级解析调用）→ 工具栏「Y 轴自适应」在全视图下 **1200ms**（旧提交 147ms）；修法：样式指针提循环外 + **整段自适应取已缓存 min/max（O(1)，结果逐位一致）** + 无变换走紧凑循环 → **0.02ms**。② **首帧卡顿根治**：加载后宽基底图层从未分配，用户第一次平移/缩放时 `Paint` 在那一帧**同步重建全部 5 个网格图层**（首帧 **64.3 → 13.0ms**）；修法：新增 `WarmLaneLayersStep()`，在**命中静态场景缓存**（视界未变、非拖拽）时用预算机制**每帧至多补 1 个网格**，把整批重建摊到静止帧。③ **派生信号把「调整」烘进数据**（不再继承样式指纹），仅 `offsetTime` 因共用文件时间轴仍需继承。④ **GX 拖拽让位判据改为鼠标指针**（鼠标越过相邻网格中心水平线即让位），并给 GX 徽标加悬停高亮（叠加层 + `IDC_HAND`，与信号列表 GX 徽标一致）。⑤ **图例命中矩形在装饰缓存路径下必须重建**（原先命中缓存时提前 return → `m_legendHits` 被清空且不重建 → 中键平移后图例悬停/点选全失效）。⑥ **每个图例条目加圆角托底 + 装饰矩形改为逐块 + 托底不透明铺满外接矩形** → 消除「GX/图例周边旧波形像素残留」（逐像素验证装饰矩形内 **0 差异**）；悬停高亮为不透明托底并**重绘色块与文字**（否则内容被盖住）。验证：离屏 Application harness **40/40 通过**，`zoomcheck` mode 20–26 量化，`make release` 零警告。 |
|
||||
|
||||
---
|
||||
|
||||
@@ -756,6 +877,22 @@ GDI+ 抗锯齿逐段扫描这些**近竖直、满幅**的边，代价爆炸（
|
||||
14. ⚠️ **多线程限制已解禁（2026-10-13），但必须"隔离状态"**：波形渲染可以多线程 —— 前提是每个线程用**自有的渲染上下文**（自有 `m_tab`/`m_area`/`m_plotRect`/`m_lanes`/DC），绝不共享可变渲染状态（见第 5 条的安全姿势）。已落地的并行只有：派生曲线线程池（`m_curveWorkers`）与并行网格图层渲染（`m_layerWorkers`）。⚠️ 实测**光栅化并行无收益**（GDI+ 串行化），所以并行只在"整批重建"这类本来就要一次画完的地方用。任何"移动 / 释放采样"的操作前必须 `PauseDerivedAsync()`。
|
||||
15. MinGW 的 `swprintf` 按 C99：宽格式串里的 `%s` = **窄**字符串，宽字符串必须用 `%ls`（否则 "KB" 会被截成 "K"）。
|
||||
16. 源文件名必须**全局唯一**（Makefile 按 basename 去重 + vpath 查找）；新增目录要同时登记进 `CXX_INCLUDES_PATHS` / `CXX_SOURCES_PATHS`。
|
||||
17. ⚠️ **`m_legendHits` 只在"整幅重绘"路径开头被清空**，因此 `PaintLaneLegend` 在**任何**绘制路径
|
||||
（**包括装饰缓存命中、提前 return 的那条**）都必须**先重建命中矩形**再决定是否跳过绘制 ——
|
||||
否则清空后不再填充，图例的悬停高亮 / 点击选中 / 双击改名会**永久失效**
|
||||
（用户报告"用中键平移过视界后图例点不动"）。同理 `m_editFieldRect` 也必须在几何段设置。
|
||||
18. ⚠️ **装饰缓存的像素必须与时间视界无关**：`CaptureDecorCache` 的捕获边界由 `floor/ceil(rect)` 得出，
|
||||
因此每块装饰（GX 徽标 / 图例托底 / Y 轴胶囊）都必须**先用不透明底色铺满"外接整数像素再外扩 1px"的矩形**
|
||||
再画圆角。否则圆角之外的那几个像素仍是波形 → 平移贴回时表现为"GX/图例周边旧波形像素残留"。
|
||||
装饰矩形也必须**逐块**（禁止覆盖整条图例带）。验证方法：宽基底实时帧 vs 同视界从零重绘，
|
||||
**装饰矩形内必须 0 差异**。
|
||||
19. ⚠️ **逐采样循环里禁止调用 `DataSet::Style(ref)` / `Resolve()` 等按下标解析的函数**：
|
||||
`AutoRangeLaneToView` 曾因此把全段自适应从 147ms 劣化到 **1200ms（8 倍）**。
|
||||
一律把指针提到循环外。整段（`begin==0 && end==count`）且无变换/无水平镜像时，
|
||||
自适应应直接取 `SignalData::minValue/maxValue`（O(1)，与原逐点扫描逐位一致）。
|
||||
20. ⚠️ **"整批图层重建"绝不允许发生在交互帧里**：新增 `WarmLaneLayersStep()`，
|
||||
在**命中静态场景缓存**（视界未变、非拖拽）时用既有预算机制**每帧至多补 1 个网格**并自请求下一帧。
|
||||
否则"加载后的第一次平移 / 选区放大"那一帧会同步重建全部网格图层（首帧 64ms → 预热后 13ms）。
|
||||
|
||||
### 11.3 离屏验证方法学（本机偏好，强烈建议沿用）
|
||||
|
||||
|
||||
Reference in new issue
Block a user