新增主题配色（4 套）+ 信号右键菜单精简与「克隆该信号」+ 布局边界层级根治 + 单点信号吸附修复
## 为什么
用户 2026-10-29 报告/要求五件事：
1. 派生信号的「时间轴偏移保留在样式上、其它调整烘值」维持现状（确认无需改动）；
2. 信号名右键菜单里很多功能已被下方样式自定义区覆盖 ⇒ 只保留「仅显示该信号」，
并在它**上方**新增「克隆该信号」；
3. 设置菜单新增「主题配色」二级菜单（带 √ 状态），顺序 Light / Solarised Light /
Dark / Solarised Dark，默认主题维持现状；
4. 布局边界：中键平移视界时浮动面板上的边界**闪烁**；光标取值胶囊的**文字**框会**穿透**
到浮动面板上；并请核对网格内固定构件（图例 / Y 轴标尺 / GX 标签 / 回到最上方 /
浮动面板）的层级关系；
5. 单数据点信号在拖动光标时的**吸附**功能消失。
## 根因
### 布局边界层级（两个都很隐蔽）
- **文本层号写死**：文本是在绘制过程中由 `UiTextRectSink` 收集的，而宿主把所有文本都记在
固定层 2；组件几何层却是"组件表下标"（`PlotView` = 0）。面板层 = PlotView 层 + 1 = 1，
**低于**文本层 2 ⇒ 面板的遮挡矩形挖不到文本 ⇒ 胶囊文字画在面板表面。
- **面板像素缓存**：面板"先画进图层、命中缓存就贴图"，贴图那一帧不画字 ⇒ 文本框凭空消失
⇒ 面板上的边界闪烁。
- 顺带发现 `PlotView::BuildBoxes` 用 `PushLayer()` 却**从不复位**，会把宿主后续所有组件的
层号整体推高。
### 单点信号吸附
`MinorCellSparse` 在"把判定范围收窄到数据实际时间跨度"的分支里有
`if (!(dataMax > dataMin)) return false;`。单个有效采样点时 `dataMax == dataMin`，
于是被判定成"不稀疏" ⇒ 不吸附。
## 改了什么
### 1. 布局边界层级
- `UiTextRectSink` 新增 `OnTextLayer(int)` / `TextLayer()`；新增 `UiSetTextLayer` /
`UiGetTextLayer`；`UiBoxTable` 实现为改 `m_layer`，并暴露 `Layer()`。
- `Application::Render` 在绘制每个组件前下发 `UiSetTextLayer(ComponentLayer(&component))`，
浮层用 `OverlayLayer(1/2)`；新增 `ComponentLayer()` / `OverlayLayer()` /
`kLayersPerComponent = 3`，与 `PaintLayoutBounds` 的层号**完全同源**。
- `PaintLayoutBounds` 改为**显式** `SetLayer(下标 × 3)`（不再依赖 `PushLayer` 累加）。
- `PlotView`：`BuildBoxes` 用 `baseLayer + 1` 放浮动面板（并登记遮挡）、
`baseLayer + 2` 放绘制在面板之上的滚动条 / 回到最上方 / 输入框，结束**复位**层号；
`paintOverlays` 同步分两次抬高文本层。
- 面板像素图层新增 `PanelSlot::textRects` + 转发型收集器 `PanelTextCollector`：
渲染时存文本框，命中缓存贴图时回放 ⇒ 几何与缓存命中无关（消除闪烁）。
### 2. 信号右键菜单 + 克隆
- 菜单只剩：标题、**克隆该信号**、**仅显示该信号**；删除显示/隐藏、显示全部/隐藏全部、
预设色块行、样式三项，以及对应的 `CMD_SIGNAL_TOGGLE/SHOW_ALL/HIDE_ALL`、
`CMD_COLOR_BASE`、`CMD_MODE_BASE` 及其分支（死代码）。
- 新增 `CMD_SIGNAL_CLONE`（post `WM_APP + 5`）→ `Application::CloneSignal`：
把「调整」（系数 / 绝对值 / 镜像 / Y 偏移）烘进采样值、**时间轴偏移保留在样式上**，
名称前置 `*`，插入到源信号**正下方**，并**保留原外观**（颜色/透明度/线宽/绘制样式）。
- 抽出 `Application::InsertSignalBelowSource(...)` 供派生与克隆共用。
### 3. 主题配色
- `ThemeKind{LIGHT, SOLARIZED_LIGHT, DARK, SOLARIZED_DARK}` + `ThemeFor()` / `ThemeName()`；
Light 取 VS Code 2026 默认浅色、Dark 取 Dark+、Solarized Dark 取 VS Code solarized dark。
**默认仍是 Solarised Light**。
- 新增 `CurrentTheme()` / `SetCurrentTheme()`：宿主交出自己的 `m_theme` 地址，
切换主题只改内容；`UiControls` 里没有 `Theme` 形参的原语改用它（原来硬编码
`SolarizedLight()`，换主题不生效）。
- `Application::ApplyTheme()`：改配色 → `PlotView::OnThemeChanged()`（作废场景/宽基底/
装饰/光晕/面板图层）+ `SignalPanel::OnThemeChanged()`（作废行位图）→ 整窗重绘。
- 菜单用 `SUBMENU` + 4 个 `keepOpen` 子项；新增 `PopupMenu::UpdateSubmenuItemLabel()`
回写勾选，并让子菜单分支尊重 `keepOpen`（原为无条件关闭）。
### 4. 单点信号吸附
`MinorCellSparse` 改为只在 `dataMax < dataMin` 时放弃；相等时按"那一个小格"判定
（`need = 5 > finiteCount = 1` ⇒ 稀疏 ⇒ 吸附恢复）。
### 5. 审计
`Makefile` 的 `LAYOUT_BOUNDS` / `JDI_LAYOUT_BOUNDS` **从未被任何 `#if` 引用**
（`LAYOUT_BOUNDS=0` 产物字节数完全相同），属名实不符的死开关 ⇒ 删除并注明原因。
## 怎么验证
新增两支离屏探针（不占鼠标 / 键盘 / 屏幕）：
```
.preflight/round15check 28 passed, 0 failed
单点吸附 7 条（含"远处不吸附"）、面板层级 5 条、面板文本框跨帧与中键平移稳定 2 条、
克隆 14 条（烘值逐点比对 / 名称前缀 / 偏移与外观保留 / 调整复位）
.preflight/themecheck 17 passed, 0 failed
4 套主题可读性与可区分、默认 = Solarised Light、逐主题换色且无旧底色残留、
切回默认逐像素还原（diff = 0）、子菜单 4 项 / 顺序 / 唯一勾选 / 命令切换 / 菜单保持打开
```
回归全绿：
```
uicheck 69/69 lbcheck 21/21 lbresid 5/5 lbzorder 4/4
lbcovr 7/7 lbpanel 10/10 derivecheck 16/16
rendercheck: 8 个场景哈希与上一轮逐一相同 + FUNC 7/7, exit=0
A FAED59DF284153DB B E6443BFE4E3955F8 C 96A0AA8C402F1729 D E3D5DBD998E43720
E DA0583CB13C26A6F F FFB822159F604D1D G 19F8DE8FE3A8DF18 H DBBDDE4CB2C97C92
```
`make release` / `make debug` 零 error / 零 warning；产物 **791,552 B**
（单一 exe，未拆 DLL，未改 `-Oz`；离 1MB 预警线约 250 KB）。
This commit is contained in:
DeepSeek V4.1 Flash committed
1 parent
71c6ff91cb
commit
71195c4c48
21 files changed
+907
-151
No files matched your search
@@ -740,17 +740,11 @@ namespace jdi
|
||||
|
||||
// 3. 插入到原信号的下方（数据层 + 各标签页引用重映射）。
|
||||
int newIndex = -1;
|
||||
// 插入派生信号会移动该分组的信号存储：先暂停后台计算，避免其读取已移动的数据。
|
||||
m_plot.PauseDerivedAsync();
|
||||
if (!m_dataSet.InsertDerivedSignal(request.groupIndex, request.signalIndex, std::move(derived),
|
||||
newIndex))
|
||||
if (!InsertSignalBelowSource(request.groupIndex, request.signalIndex, std::move(derived),
|
||||
makeVisible, newIndex))
|
||||
{
|
||||
return false;
|
||||
}
|
||||
for (TabConfig& tab : m_tabs)
|
||||
{
|
||||
tab.RemapAfterSignalInsert(request.groupIndex, newIndex);
|
||||
}
|
||||
|
||||
// 3b. 时间轴偏移：**只**写进新信号的样式（不再烘进采样值，见 2c 的说明）。
|
||||
// 绘制路径本来就把采样画在 `t + offsetTime` 处，因此新信号的曲线与预览曲线
|
||||
@@ -763,22 +757,110 @@ namespace jdi
|
||||
}
|
||||
}
|
||||
|
||||
// 4. 在当前标签页中勾选新信号，并把它所在的网格移到原信号网格的下方。
|
||||
if (makeVisible && !m_tabs.empty())
|
||||
{
|
||||
SignalRef derivedRef;
|
||||
derivedRef.groupIndex = request.groupIndex;
|
||||
derivedRef.signalIndex = newIndex;
|
||||
ActiveTab().SetVisible(derivedRef, true);
|
||||
// 4. 数据层结构变化：刷新列表、作废折线/派生缓存并重绘。
|
||||
SyncTabsToDataSet();
|
||||
return true;
|
||||
}
|
||||
|
||||
SignalRef sourceRef;
|
||||
sourceRef.groupIndex = request.groupIndex;
|
||||
sourceRef.signalIndex = request.signalIndex;
|
||||
ActiveTab().MoveLaneOfSignalBelow(derivedRef, sourceRef);
|
||||
bool Application::InsertSignalBelowSource(int groupIndex, int sourceIndex, SignalData&& signal,
|
||||
bool makeVisible, int& newIndex)
|
||||
{
|
||||
newIndex = -1;
|
||||
// 插入派生信号会移动该分组的信号存储：先暂停后台计算，避免其读取已移动的数据。
|
||||
m_plot.PauseDerivedAsync();
|
||||
if (!m_dataSet.InsertDerivedSignal(groupIndex, sourceIndex, std::move(signal), newIndex))
|
||||
{
|
||||
return false;
|
||||
}
|
||||
for (TabConfig& tab : m_tabs)
|
||||
{
|
||||
tab.RemapAfterSignalInsert(groupIndex, newIndex);
|
||||
}
|
||||
|
||||
// 在当前标签页中勾选新信号，并把它所在的网格移到原信号网格的下方。
|
||||
if (makeVisible && !m_tabs.empty())
|
||||
{
|
||||
const SignalRef insertedRef{groupIndex, newIndex};
|
||||
ActiveTab().SetVisible(insertedRef, true);
|
||||
const SignalRef sourceRef{groupIndex, sourceIndex};
|
||||
ActiveTab().MoveLaneOfSignalBelow(insertedRef, sourceRef);
|
||||
}
|
||||
return true;
|
||||
}
|
||||
|
||||
bool Application::CloneSignal(const SignalRef& sourceRef)
|
||||
{
|
||||
const SignalGroup* group = m_dataSet.GroupAt(sourceRef.groupIndex);
|
||||
if (group == nullptr || sourceRef.signalIndex < 0 ||
|
||||
sourceRef.signalIndex >= static_cast<int>(group->signals.size()))
|
||||
{
|
||||
return false;
|
||||
}
|
||||
const SignalData& source = group->signals[static_cast<std::size_t>(sourceRef.signalIndex)];
|
||||
|
||||
// 源信号的「调整」快照（插入会移动信号存储，之后不能再解引用 `source`）。
|
||||
SignalStyle transform;
|
||||
bool hasStyle = false;
|
||||
if (const SignalStyle* style = m_dataSet.Style(sourceRef))
|
||||
{
|
||||
transform = *style;
|
||||
hasStyle = true;
|
||||
}
|
||||
|
||||
// 克隆 = 把「调整」烘进采样值（**时间轴偏移除外**，它留在样式上）。
|
||||
// 与「构建为新信号」完全同一套烘值规则，因此克隆出来的曲线与原信号**逐像素重合**，
|
||||
// 但它的「调整」面板回到默认值，可以继续在此基础上继续叠加新调整。
|
||||
SignalData clone;
|
||||
clone.name = L"*" + source.name;
|
||||
clone.axisIndex = source.axisIndex;
|
||||
clone.values = source.values;
|
||||
if (hasStyle)
|
||||
{
|
||||
const bool valueTransform = (transform.gain != 1.0f || transform.absolute ||
|
||||
transform.mirrorVertical || transform.offsetY != 0.0f);
|
||||
if (valueTransform)
|
||||
{
|
||||
for (double& value : clone.values)
|
||||
{
|
||||
value = ApplyDrawTransform(transform, value);
|
||||
}
|
||||
}
|
||||
if (transform.mirrorHorizontal)
|
||||
{
|
||||
std::reverse(clone.values.begin(), clone.values.end());
|
||||
}
|
||||
}
|
||||
|
||||
int newIndex = -1;
|
||||
if (!InsertSignalBelowSource(sourceRef.groupIndex, sourceRef.signalIndex, std::move(clone),
|
||||
true, newIndex))
|
||||
{
|
||||
return false;
|
||||
}
|
||||
|
||||
// 外观：克隆要**看起来与原信号一样**（颜色 / 透明度 / 线宽 / 绘制样式），
|
||||
// 只把被烘掉的「调整」复位为默认值，并保留时间轴偏移。
|
||||
if (SignalStyle* cloned = m_dataSet.Style(SignalRef{sourceRef.groupIndex, newIndex}))
|
||||
{
|
||||
if (hasStyle)
|
||||
{
|
||||
cloned->color = transform.color;
|
||||
cloned->customColor = transform.customColor;
|
||||
cloned->opacity = transform.opacity;
|
||||
cloned->lineWidth = transform.lineWidth;
|
||||
cloned->mode = transform.mode;
|
||||
cloned->offsetTime = transform.offsetTime;
|
||||
}
|
||||
// ⚠️ 单点信号默认会改成「散点 + 最大线宽」（`InsertDerivedSignal` 里的规则），
|
||||
// 克隆应该用**原信号的样式**，因此上面几行把它覆盖回去了。
|
||||
}
|
||||
|
||||
// 5. 数据层结构变化：刷新列表、作废折线/派生缓存并重绘。
|
||||
SyncTabsToDataSet();
|
||||
SetStatusMessage(L"已克隆信号：" + m_dataSet.GroupAt(sourceRef.groupIndex)
|
||||
->signals[static_cast<std::size_t>(newIndex)]
|
||||
.name,
|
||||
false);
|
||||
InvalidateRect(m_hwnd, nullptr, TRUE);
|
||||
return true;
|
||||
}
|
||||
|
||||
@@ -1080,6 +1162,27 @@ namespace jdi
|
||||
m_plot.AllLanesAutoFitToSelection(), true);
|
||||
}
|
||||
|
||||
void Application::ApplyTheme(ThemeKind kind)
|
||||
{
|
||||
if (kind == m_themeKind && m_theme.windowBg == ThemeFor(kind).windowBg)
|
||||
{
|
||||
return; // 幂等：同一个主题重复点击不必作废缓存
|
||||
}
|
||||
m_themeKind = kind;
|
||||
m_theme = ThemeFor(kind);
|
||||
SetCurrentTheme(&m_theme);
|
||||
|
||||
// 主题色烘进了多处位图缓存，必须整体作废（只作废场景缓存是不够的：
|
||||
// 宽基底图层、装饰层、浮动面板层、信号列表行位图里都存着旧配色的像素）。
|
||||
m_plot.OnThemeChanged();
|
||||
m_panel.OnThemeChanged();
|
||||
|
||||
// 装饰区（标签栏 / 工具栏 / 面板）全部重画，并整窗回送。
|
||||
m_chromeDirty = true;
|
||||
m_panelDirty = true;
|
||||
InvalidateRect(m_hwnd, nullptr, TRUE);
|
||||
}
|
||||
|
||||
void Application::OpenSettingsMenu()
|
||||
{
|
||||
// 锚点取齿轮按钮的**实际矩形**：按钮宽度由控件实测，宿主不应自己推算几何。
|
||||
@@ -1106,6 +1209,25 @@ namespace jdi
|
||||
boundsItem.keepOpen = true;
|
||||
items.push_back(boundsItem);
|
||||
|
||||
// ── 主题配色（二级菜单：鼠标悬停展开，带勾选态）──────────────
|
||||
// 顺序固定为 Light / Solarised Light / Dark / Solarised Dark（用户 2026-10-29 指定）。
|
||||
// `keepOpen` 让点击主题后菜单不关闭，勾选态由宿主回写 —— 便于连续预览几种配色。
|
||||
MenuItem themeItem;
|
||||
themeItem.kind = MenuItemKind::SUBMENU;
|
||||
themeItem.label = L"主题配色";
|
||||
for (int index = 0; index <= static_cast<int>(ThemeKind::SOLARIZED_DARK); ++index)
|
||||
{
|
||||
const ThemeKind kind = static_cast<ThemeKind>(index);
|
||||
MenuItem option;
|
||||
option.kind = MenuItemKind::NORMAL;
|
||||
option.label = ThemeName(kind);
|
||||
option.id = kAppCmdThemeBase + index;
|
||||
option.checked = (m_themeKind == kind);
|
||||
option.keepOpen = true;
|
||||
themeItem.submenu.push_back(option);
|
||||
}
|
||||
items.push_back(themeItem);
|
||||
|
||||
RECT client = {};
|
||||
GetClientRect(m_hwnd, &client);
|
||||
const gd::RectF bounds(0.0f, 0.0f, static_cast<float>(client.right - client.left),
|
||||
@@ -1117,10 +1239,30 @@ namespace jdi
|
||||
m_menu.Open(MenuScope::APP_SETTINGS, bounds, x, y, items);
|
||||
}
|
||||
|
||||
int Application::ComponentLayer(const UiComponent* component) const
|
||||
{
|
||||
if (component == nullptr)
|
||||
{
|
||||
return 0;
|
||||
}
|
||||
for (std::size_t index = 0; index < m_components.size(); ++index)
|
||||
{
|
||||
if (m_components[index].component == component)
|
||||
{
|
||||
return static_cast<int>(index) * kLayersPerComponent;
|
||||
}
|
||||
}
|
||||
return 0;
|
||||
}
|
||||
|
||||
void Application::PaintLayoutBounds(gd::Graphics& g, int width, int height)
|
||||
{
|
||||
// ⚠️ 复用成员容器（不是局部变量）：文本几何已经在**绘制期间**由 `PaintUtil`
|
||||
// 通过 `UiSetTextRectSink(&m_debugBoxes)` 收进来了，这里只负责补组件结构。
|
||||
//
|
||||
// 层号与 `Render` 里下发的"文本层"**完全同源**（组件表下标 / `OverlayLayer`）：
|
||||
// 只有两者一致，遮挡矩形才能正确地把"浮层下面的内容"（含文字框）挖掉，
|
||||
// 而不是反过来让下层文字穿透到浮层之上（用户 2026-10-29 报告的缺陷）。
|
||||
m_debugBoxes.SetLayer(0);
|
||||
|
||||
// 客户区外框：便于确认"窗口边缘 == 最外层边界"。
|
||||
@@ -1128,19 +1270,22 @@ namespace jdi
|
||||
static_cast<float>(height)), 0);
|
||||
|
||||
// 组件区域（底 → 顶；组件自己负责补齐内部结构）。
|
||||
// ⚠️ 两点都很重要：
|
||||
// ⚠️ 三点都很重要：
|
||||
// 1. `SetClip(组件区域)`：组件内部的元素可能落在自己地盘之外（典型：滚出可视区的
|
||||
// 网格 `lane.rect` 的 Y 为负数），不裁剪会把边框画到工具栏/标签栏上。
|
||||
// 2. 每收集完一个组件就 `PushLayer()`：浮层压在本体之上（右键二级菜单压在行上面），
|
||||
// 只有按收集顺序分层，后收集的内容才画在上面。
|
||||
for (const ComponentEntry& entry : m_components)
|
||||
// 2. 每个组件收集前**显式**把层号设成它在组件表里的下标：不能依赖 `PushLayer()`
|
||||
// 累加 —— 组件内部可能为了自己的浮层临时提层（`PlotView` 的浮动面板），
|
||||
// 一旦它没有复位，后面所有组件的层号会被整体推高，遮挡关系全乱。
|
||||
// 3. 层号必须与 `Render` 里给文本下发的层号同源（见 `ComponentLayer`）。
|
||||
for (std::size_t index = 0; index < m_components.size(); ++index)
|
||||
{
|
||||
const ComponentEntry& entry = m_components[index];
|
||||
m_debugBoxes.SetLayer(static_cast<int>(index) * kLayersPerComponent);
|
||||
if (entry.component != nullptr)
|
||||
{
|
||||
m_debugBoxes.SetClip(entry.component->Area());
|
||||
entry.component->BuildBoxes(m_debugBoxes);
|
||||
}
|
||||
m_debugBoxes.PushLayer();
|
||||
}
|
||||
|
||||
// 不属于任何组件的两块：面板分隔条（由宿主直接填充色块）、菜单 / 拾色器（浮层）。
|
||||
@@ -1148,10 +1293,11 @@ namespace jdi
|
||||
// 它们自己会把本体登记为"遮挡矩形"（见 `PopupMenu::BuildBoxes`），
|
||||
// 由绘制阶段把更低层的 box 从浮层区域里挖掉。
|
||||
m_debugBoxes.SetClip(gd::RectF());
|
||||
m_debugBoxes.SetLayer(OverlayLayer(0));
|
||||
m_debugBoxes.Add(m_splitterRect, 0);
|
||||
m_debugBoxes.PushLayer();
|
||||
m_debugBoxes.SetLayer(OverlayLayer(1));
|
||||
m_menu.BuildBoxes(m_debugBoxes);
|
||||
m_debugBoxes.PushLayer();
|
||||
m_debugBoxes.SetLayer(OverlayLayer(2));
|
||||
m_colorPicker.BuildBoxes(m_debugBoxes);
|
||||
|
||||
UiDebugPaintBoxList(g, m_debugBoxes);
|
||||
@@ -1177,6 +1323,19 @@ namespace jdi
|
||||
// 边界比组件矩形外扩 1px 且跨越所有装饰区 ⇒ 必须整帧重绘。
|
||||
m_chromeDirty = true;
|
||||
}
|
||||
else if (result.id >= kAppCmdThemeBase &&
|
||||
result.id <= kAppCmdThemeBase + static_cast<int>(ThemeKind::SOLARIZED_DARK))
|
||||
{
|
||||
const ThemeKind kind = static_cast<ThemeKind>(result.id - kAppCmdThemeBase);
|
||||
ApplyTheme(kind);
|
||||
// 回写勾选态：四项里只有当前主题打勾（子菜单项要用专用接口才会重建布局）。
|
||||
for (int index = 0; index <= static_cast<int>(ThemeKind::SOLARIZED_DARK); ++index)
|
||||
{
|
||||
const ThemeKind option = static_cast<ThemeKind>(index);
|
||||
m_menu.UpdateSubmenuItemLabel(kAppCmdThemeBase + index, ThemeName(option),
|
||||
m_themeKind == option);
|
||||
}
|
||||
}
|
||||
InvalidateRect(m_hwnd, nullptr, TRUE);
|
||||
break;
|
||||
}
|
||||
|
||||
Reference in new issue
Block a user