新增主题配色（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
@@ -323,6 +323,35 @@ namespace jdi
|
||||
*/
|
||||
bool BuildDerivedSignal(const DerivedSignalRequest& request, bool makeVisible);
|
||||
|
||||
/**
|
||||
* @brief 把一条信号插入到「源信号」的下方，并同步各标签页的引用与可见性。
|
||||
*
|
||||
* 派生（均值滤波 / 弱峰调整）与克隆共用这一段：插入 → 各标签页下标重映射 →
|
||||
* 在当前标签页勾选并把它所在的网格挪到源信号网格下方。**不做** `SyncTabsToDataSet`，
|
||||
* 好让调用方在同步之前再改新信号的外观。
|
||||
*
|
||||
* @param [IN] groupIndex 分组下标。
|
||||
* @param [IN] sourceIndex 源信号在组内的下标。
|
||||
* @param [IN] signal 要插入的信号（移动语义）。
|
||||
* @param [IN] makeVisible 是否在当前标签页中勾选新信号。
|
||||
* @param [OUT] newIndex 新信号在组内的下标。
|
||||
* @return 插入成功返回 true。
|
||||
*/
|
||||
bool InsertSignalBelowSource(int groupIndex, int sourceIndex, SignalData&& signal,
|
||||
bool makeVisible, int& newIndex);
|
||||
|
||||
/**
|
||||
* @brief 克隆一条信号：把它的「调整」（系数 / 绝对值 / 镜像 / Y 偏移）烘焙进采样值，
|
||||
* 时间轴偏移保留在样式上，名称前置 `*`，插入到原信号下方。
|
||||
*
|
||||
* 烘值规则与「构建为新信号」完全一致，因此克隆曲线与原信号重合；区别只是
|
||||
* 克隆**保留原外观**（颜色 / 透明度 / 线宽 / 绘制样式），便于“冻住当前效果继续调”。
|
||||
*
|
||||
* @param [IN] sourceRef 源信号引用。
|
||||
* @return 克隆成功返回 true。
|
||||
*/
|
||||
bool CloneSignal(const SignalRef& sourceRef);
|
||||
|
||||
/**
|
||||
* @brief 弹出“打开数据文件”对话框并加载所选文件。
|
||||
*/
|
||||
@@ -396,6 +425,16 @@ namespace jdi
|
||||
*/
|
||||
void OpenSettingsMenu();
|
||||
|
||||
/**
|
||||
* @brief 切换主题配色，并作废全部**像素级**缓存后整窗重绘。
|
||||
*
|
||||
* 主题色被烘进了多处位图缓存（场景缓存、每网格宽基底图层、装饰层、浮动面板层、
|
||||
* 信号列表行位图），换主题后必须整体作废，否则界面会停留在旧配色上。
|
||||
*
|
||||
* @param [IN] kind 目标主题。
|
||||
*/
|
||||
void ApplyTheme(ThemeKind kind);
|
||||
|
||||
/**
|
||||
* @brief 绘制全部 UI 控件的布局边界（调试开关开启时在 Render 的最后一步调用）。
|
||||
*
|
||||
@@ -411,6 +450,43 @@ namespace jdi
|
||||
*/
|
||||
void PaintLayoutBounds(gd::Graphics& g, int width, int height);
|
||||
|
||||
/**
|
||||
* @brief 取某个组件的**绘制层号**（越小越靠下）。
|
||||
*
|
||||
* 层号 = 组件在 `m_components` 里的下标 × `kLayersPerComponent`，因此
|
||||
* “文本收集层”与 `PaintLayoutBounds` 里给几何 box 分配的层号**完全同源**。
|
||||
*
|
||||
* ⚠️ **为什么要乘以间隔而不是直接用下标**：组件内部可能还需要再压一层
|
||||
*（`PlotView` 的浮动面板就在自己之上再加一层）。若直接用下标，
|
||||
* 那个子层会与“下一个组件的基层”撞号，遮挡比较就失去意义。
|
||||
*
|
||||
* @param [IN] component 组件实例。
|
||||
* @return 层号；不在组件表里返回 0。
|
||||
*/
|
||||
int ComponentLayer(const UiComponent* component) const;
|
||||
|
||||
/**
|
||||
* @brief 每个组件占用的层号个数。
|
||||
*
|
||||
* * `+0`：组件自己的基层（网格 / 悬浮构件 / 光标读数…）；
|
||||
* * `+1`：组件内部的不透明浮层（`PlotView` 的实验性功能浮动面板）；
|
||||
* * `+2`：绘制在那些浮层**之上**的叠加层（滚动条 / 回到最上方 / 内联输入框）。
|
||||
*/
|
||||
static constexpr int kLayersPerComponent = 3;
|
||||
|
||||
/**
|
||||
* @brief 取**不属于组件表**的浮层 / 装饰的绘制层号。
|
||||
*
|
||||
* 它们接在组件表之后：`offset = 0` = 面板分隔条，`1` = 弹出菜单，`2` = 浮动拾色器。
|
||||
* @param [IN] offset 相对组件表末尾的偏移。
|
||||
* @return 层号。
|
||||
*/
|
||||
int OverlayLayer(int offset) const
|
||||
{
|
||||
return static_cast<int>(m_components.size()) * kLayersPerComponent +
|
||||
offset * kLayersPerComponent;
|
||||
}
|
||||
|
||||
/**
|
||||
* @brief 处理客户区鼠标移动。
|
||||
* @param [IN] x 客户区横坐标。
|
||||
@@ -439,6 +515,13 @@ namespace jdi
|
||||
bool m_gdiplusReady = false; /**< GDI+ 是否初始化成功。 */
|
||||
|
||||
Theme m_theme; /**< 主题配色。 */
|
||||
/**
|
||||
* @brief 当前选中的主题种类（设置菜单 → 主题配色里的勾选项）。
|
||||
*
|
||||
* 默认值是 **Solarised Light**：这是项目历史默认，用户 2026-10-29 明确要求
|
||||
* 新增其它主题时"默认的主题色维持现状"。
|
||||
*/
|
||||
ThemeKind m_themeKind = ThemeKind::SOLARIZED_LIGHT;
|
||||
UiFonts m_fonts; /**< 界面字体。 */
|
||||
PopupMenu m_menu; /**< 与主题一致的自绘弹出菜单。 */
|
||||
ColorPickerPopup m_colorPicker; /**< 与主题一致的浮动拾色器。 */
|
||||
|
||||
Reference in new issue
Block a user