DeepSeek V4.1 Flash
82a29362eb
- 新勾选的信号所在网格固定出现在**最下方**：
原先 PER_SIGNAL 模式按 visibleRefs（文件/列序）重建网格，新勾选的信号会按其列序插到
中间，位置看起来"不确定"。现在先按「原有网格位置」排序（已分配过网格的信号保持相对次序），
再把尚未分配网格（新勾选）的信号统一追加到末尾。
- 网格右键菜单在「实验性功能」上方新增「拆分当前网格」（`PLOT_CMD_LANE_SPLIT`）：
把该网格内的信号按个拆分成独立网格，新网格插入到原网格的**下方依次排列**，
原网格下方的网格顺次后移。网格编号（GX）完全由位置推导，因此左侧列表徽标、图例徽标、
面板标题、菜单标题等所有使用该编号的地方会同步更新，不会错位。
新增 `TabConfig::SplitLane()` / `PlotView::SplitLane()` / `PlotView::LaneSignalCount()`
（仅 1 条信号时菜单项置灰）。拆分出来的网格继承原网格的网格自身状态
（Y 轴自适应、边沿计数、面板位置等）。
- 鼠标**中键**按下拖拽也可自由查看区域（水平平移时间轴 + 纵向偏移当前网格幅值）：
新增 `PlotView::OnMButtonDown/OnMButtonUp` 与 `Application::WM_MBUTTONDOWN/UP`，
**任何缩放模式下都可用**（不改变当前模式）。拖动期间 `WM_MOUSEMOVE` 的按键掩码
加入 `MK_MBUTTON`，光标刷新为抓握图标。
- 选区放大模式下不再阻断图例交互：把「点击图例条目 → 选中信号」的判定移到选区放大分支
**之前**，并让图例悬停（半高亮）在选区放大模式下同样生效（该模式只应改变拖拽语义）。
同时选区放大模式下也可用中键拖拽平移。
- 实验性功能浮动面板悬停时高亮其所属网格（与鼠标直接停在网格上一致）：
`OnMouseMove` 中若鼠标落在面板上则把 `m_hoverLane` 置为该面板所属网格。
- 「边沿计数（中心轴）」：
* 中心平均值曲线的颜色样式改为与光标一致（`CursorColor(1)`，即「边沿计数」横向光标
与中心值胶囊的颜色），曲线与其取值标注、光标形成统一的视觉语言。
* 中心值标注形式改为「数值（中心轴）」（数值在前、尾缀在后）；
双光标模式下由右侧光标额外显示增量，形如「数值（+0.0008 中心轴）」，
与常规信号的增量显示保持一致（无尖头括号）。
* 修复：光标处于当前显示区域之外（贴边显示）时，常规数据点会变成三角指示方向，
而中心轴数据点仍是圆点。现在中心轴数据点复用同一分支，越界时同样绘制三角。
验证（TestData/VERY_BIG_DATA.CSV，125%、1725x996）：
- 置底：先勾选第 5 个信号（电流钳采集(原始)）→ G1，再勾选第 1 个信号（编码器A相）→ G2，
新勾选的信号确实出现在最下方。
- 拆分：G1(编码器A相) / G2(飞线IO+编码器B相) / G3(电流钳(原始)) 时拆分 G2，
得到 G1 / G2(飞线IO) / G3(编码器B相) / G4(电流钳(原始))，
原本在中间的电流钳顺延为 G4，左侧徽标、图例徽标全部同步。
- 中键：常规模式与选区放大模式下中键拖拽均能把时间轴平移到 80~160（截图核对）。
- 选区放大模式：悬停图例条目显示半高亮；点击图例条目可切换选中信号（左侧高亮随之切换）。
- 面板悬停：鼠标停在 G1 的「边沿计数」面板上时 G1 区域被高亮（与悬停 G1、G2 两种情形
做区域哈希对比，确认高亮归属正确）。
- 中心轴：曲线为光标橙 `#CB4B16`；面板标题「中心轴边沿计数」、底部「平滑点数 N = 5」；
单光标显示 `4.9417` + `4.94199（中心轴）`；
双光标（标题带「（光标区间内）」，计数 341959/341957）右侧光标显示
`4.9425 (+0.000…)` + `4.94214（+0.00… 中心轴）`，左侧光标无增量；
把 N 改为 4000 后曲线与计数同步更新（2333700/2333700）；
用选区放大把光标推到视野外后，中心轴数据点在与信号相同的贴边位置绘制为**橙色三角**
（像素扫描 x=479 处得到 6px 高的 `#CB4B16` 三角，而非常规圆点）。
- 回归：[1].CSV 上「边沿计数」面板正常（上升沿 2 / 下降沿 2），中键平移正常。
- make clean && make all 无警告无错误。
665 lines
24 KiB
C++
665 lines
24 KiB
C++
#ifndef __DATA_MODEL_HPP__
|
|
#define __DATA_MODEL_HPP__
|
|
|
|
#include <cstddef>
|
|
#include <cstdint>
|
|
#include <string>
|
|
#include <vector>
|
|
|
|
#include "CsvTable.hpp"
|
|
|
|
namespace jdi
|
|
{
|
|
|
|
/**
|
|
* @brief 波形绘制方式。
|
|
*/
|
|
enum class DrawMode : int
|
|
{
|
|
LINE = 0, /**< 相邻采样点之间以插值直线连接。 */
|
|
SCATTER = 1, /**< 仅绘制采样点散点。 */
|
|
LINE_SCATTER = 2 /**< 同时绘制插值直线与采样点散点。 */
|
|
};
|
|
|
|
/**
|
|
* @brief 绘图区拖拽缩放模式（由工具栏按钮切换）。
|
|
*/
|
|
enum class PlotZoomMode : int
|
|
{
|
|
NONE = 0, /**< 常规模式：拖拽平移时间轴，光标为箭头。 */
|
|
SELECT = 1 /**< 选区放大：横向拖拽放大时间轴，纵向拖拽放大当前网格的幅值范围。 */
|
|
};
|
|
|
|
/**
|
|
* @brief 时间光标模式（由工具栏「光标」按钮三态循环切换）。
|
|
*/
|
|
enum class PlotCursorMode : int
|
|
{
|
|
NONE = 0, /**< 不显示光标。 */
|
|
SINGLE = 1, /**< 单光标。 */
|
|
DOUBLE = 2 /**< 双光标（第二条用于与第一条对比取值）。 */
|
|
};
|
|
|
|
/**
|
|
* @brief 将绘制方式转换为中文显示名称。
|
|
* @param [IN] mode 绘制方式。
|
|
* @return 显示名称。
|
|
*/
|
|
const wchar_t* DrawModeName(DrawMode mode);
|
|
|
|
/**
|
|
* @brief 网格划分策略：决定信号可见性与网格数量的联动方式。
|
|
*/
|
|
enum class LaneMode : int
|
|
{
|
|
PER_SIGNAL = 0, /**< 每条可见信号独占一个网格（随可见性自动增删）。 */
|
|
MERGED = 1, /**< 全部可见信号叠加在同一网格。 */
|
|
CUSTOM = 2 /**< 由用户手动指定归属；可见性变化时仅清理空网格。 */
|
|
};
|
|
|
|
/**
|
|
* @brief 全局信号引用：文件下标 + 文件内信号下标。
|
|
*/
|
|
struct SignalRef
|
|
{
|
|
int fileIndex = -1; /**< 所属文件下标。 */
|
|
int signalIndex = -1; /**< 文件内信号下标。 */
|
|
|
|
/**
|
|
* @brief 判断引用是否指向有效位置。
|
|
* @return 两个下标均非负返回 true。
|
|
*/
|
|
bool IsValid() const { return fileIndex >= 0 && signalIndex >= 0; }
|
|
|
|
/**
|
|
* @brief 相等比较。
|
|
* @param [IN] other 另一引用。
|
|
* @return 指向同一信号返回 true。
|
|
*/
|
|
bool operator==(const SignalRef& other) const
|
|
{
|
|
return fileIndex == other.fileIndex && signalIndex == other.signalIndex;
|
|
}
|
|
|
|
/**
|
|
* @brief 不等比较。
|
|
* @param [IN] other 另一引用。
|
|
* @return 指向不同信号返回 true。
|
|
*/
|
|
bool operator!=(const SignalRef& other) const { return !(*this == other); }
|
|
};
|
|
|
|
/**
|
|
* @brief 单个信号的显示外观（颜色/透明度/线宽/绘制方式）。
|
|
*
|
|
* 外观属于信号自身而非某个标签页——同一信号在所有标签页中必须显示效果一致，
|
|
* 因此在任一视图里修改颜色/线宽/透明度/样式，其它视图会自动同步。
|
|
* 信号是否可见则属于各标签页自己的配置（见 `TabConfig`）。
|
|
*/
|
|
struct SignalStyle
|
|
{
|
|
std::uint32_t color = 0xFF268BD2; /**< 波形颜色，格式 0xAARRGGBB。 */
|
|
std::uint32_t customColor = 0xFF6C71C4; /**< 自定义颜色记忆值（切换预设色后仍保留）。 */
|
|
float opacity = 1.0f; /**< 不透明度，取值 0.0-1.0，默认 1.0。 */
|
|
float lineWidth = 1.0f; /**< 线宽（逻辑像素，未乘 DPI 缩放）。 */
|
|
DrawMode mode = DrawMode::LINE; /**< 绘制方式。 */
|
|
};
|
|
|
|
/**
|
|
* @brief 单条信号的元数据与采样值（纯数据，不含可见性配置）。
|
|
*/
|
|
struct SignalData
|
|
{
|
|
std::wstring name; /**< 名称（取自文件列名，完全保留原样）。 */
|
|
std::wstring displayName; /**< 用户重命名的显示名；为空时使用 name。 */
|
|
std::wstring rawHeader; /**< 原始列名。 */
|
|
std::wstring unit; /**< 从列名括号中提取的单位，可能为空。 */
|
|
std::vector<double> values; /**< 采样值，缺失处为 NaN。 */
|
|
double minValue = 0.0; /**< 有限采样值最小值。 */
|
|
double maxValue = 0.0; /**< 有限采样值最大值。 */
|
|
std::size_t finiteCount = 0; /**< 有限采样点数量。 */
|
|
|
|
/**
|
|
* @brief 粗粒度包络层：每 coarseStride 个采样一组的 min/max。
|
|
*
|
|
* 大文件（千万级采样）的折线包络构建是 O(可见采样数) 的，每次视图变化都要重算，
|
|
* 实测 1770 万行 × 5 信号需要约 200ms/帧，拖拽时严重掉帧。
|
|
* 有了这一层（额外内存 ≈ 采样数的 0.8%），构建包络时只需读取“每列覆盖到的分组”，
|
|
* 读取量降到约 1/5000，且**绘制结果与全量扫描完全一致**（分组内已存真实极值）。
|
|
* 分组内没有有效值时存 ±inf，读取时跳过。
|
|
*/
|
|
std::vector<double> coarseMin; /**< 分组最小值。 */
|
|
std::vector<double> coarseMax; /**< 分组最大值。 */
|
|
std::size_t coarseStride = 0; /**< 分组的采样跨度；0 表示未构建。 */
|
|
|
|
SignalStyle style; /**< 显示外观（全局共享，跨标签页同步）。 */
|
|
|
|
/**
|
|
* @brief 获取用于界面展示的名称。
|
|
* @return 用户重命名后的显示名，未重命名时返回文件中的原始名称。
|
|
*/
|
|
const std::wstring& Title() const { return displayName.empty() ? name : displayName; }
|
|
};
|
|
|
|
/**
|
|
* @brief 一个已加载的数据文件及其自有时间轴。
|
|
*/
|
|
struct DataFile
|
|
{
|
|
std::wstring filePath; /**< 文件完整路径（仅用于状态提示）。 */
|
|
std::wstring fileName; /**< 文件名称。 */
|
|
std::wstring displayName; /**< 用户重命名的分组名；为空时使用 fileName。 */
|
|
std::wstring timeColumnName; /**< 时间列列名。 */
|
|
std::vector<double> time; /**< 时间轴数值。 */
|
|
std::vector<SignalData> signals; /**< 该文件包含的信号。 */
|
|
double minTime = 0.0; /**< 时间轴最小值。 */
|
|
double maxTime = 0.0; /**< 时间轴最大值。 */
|
|
bool timeMonotonic = true; /**< 时间轴是否单调不减。 */
|
|
|
|
/**
|
|
* @brief 获取用于界面展示的分组名。
|
|
* @return 用户重命名后的显示名，未重命名时返回文件名。
|
|
*/
|
|
const std::wstring& Title() const { return displayName.empty() ? fileName : displayName; }
|
|
};
|
|
|
|
/**
|
|
* @brief 由 CSV 解析结果构建可入库的数据文件。
|
|
*
|
|
* 该函数**不访问 DataSet**（只依赖传入的 CsvTable 与调色板基准序号），
|
|
* 因此可以在工作线程上执行：大文件的解析与列重组占整个加载耗时的大头，
|
|
* 放到工作线程后主线程只需做一次 O(1) 的移动入队，加载过程中的界面不会卡住。
|
|
*
|
|
* table 按右值传入：每列会被**移动**进对应信号的 values（零拷贝）。
|
|
*
|
|
* @param [IN,OUT] table CSV 解析结果（列会被移走）。
|
|
* @param [IN] filePath 源文件路径。
|
|
* @param [IN] paletteBase 调色板起始序号（通常传入当前已有信号数）。
|
|
* @param [OUT] file 构建结果。
|
|
* @param [OUT] error 失败原因描述（成功时清空）。
|
|
* @param [IN] progress 进度回调（0-1），返回 false 表示取消，可为空。
|
|
* @return 构建成功返回 true。
|
|
*/
|
|
bool BuildDataFile(CsvTable&& table, const std::wstring& filePath, std::size_t paletteBase, DataFile& file,
|
|
std::wstring& error, const CsvProgress& progress = CsvProgress());
|
|
|
|
/**
|
|
* @brief 数据集合：统一管理全部已加载文件，与视图配置无关。
|
|
*/
|
|
class DataSet
|
|
{
|
|
public:
|
|
/**
|
|
* @brief 清空全部已加载文件。
|
|
*/
|
|
void Clear();
|
|
|
|
/**
|
|
* @brief 依据 CSV 解析结果追加一个数据文件。
|
|
* @param [IN] table CSV 解析结果。
|
|
* @param [IN] filePath 源文件路径。
|
|
* @param [OUT] error 失败原因描述（成功时清空）。
|
|
* @param [OUT] fileIndex 新文件下标，失败时为 -1。
|
|
* @return 追加成功返回 true。
|
|
*/
|
|
bool AddFromTable(const CsvTable& table, const std::wstring& filePath, std::wstring& error, int& fileIndex);
|
|
|
|
/**
|
|
* @brief 追加一个已构建好的数据文件（仅做一次移动，不拷贝采样数据）。
|
|
* @param [IN,OUT] file 数据文件（内部缓冲会被移走）。
|
|
* @param [OUT] fileIndex 新文件下标。
|
|
* @return 追加成功返回 true。
|
|
*/
|
|
bool AddPreparedFile(DataFile&& file, int& fileIndex);
|
|
|
|
/**
|
|
* @brief 移除指定下标的文件，并立即释放其占用的全部采样内存。
|
|
* @param [IN] fileIndex 文件下标。
|
|
* @return 移除成功返回 true。
|
|
*/
|
|
bool RemoveFile(int fileIndex);
|
|
|
|
/**
|
|
* @brief 判断数据集合是否为空。
|
|
* @return 未加载任何文件返回 true。
|
|
*/
|
|
bool Empty() const { return m_files.empty(); }
|
|
|
|
/**
|
|
* @brief 获取文件数量。
|
|
* @return 文件数量。
|
|
*/
|
|
std::size_t FileCount() const { return m_files.size(); }
|
|
|
|
/**
|
|
* @brief 获取信号总数。
|
|
* @return 信号总数。
|
|
*/
|
|
std::size_t SignalCount() const;
|
|
|
|
/**
|
|
* @brief 获取全部文件（只读）。
|
|
* @return 文件集合。
|
|
*/
|
|
const std::vector<DataFile>& Files() const { return m_files; }
|
|
|
|
/**
|
|
* @brief 按下标获取文件。
|
|
* @param [IN] fileIndex 文件下标。
|
|
* @return 文件指针，下标非法时返回 nullptr。
|
|
*/
|
|
const DataFile* FileAt(int fileIndex) const;
|
|
|
|
/**
|
|
* @brief 修改某个信号在界面上的显示名称。
|
|
* @param [IN] fileIndex 文件下标。
|
|
* @param [IN] signalIndex 文件内信号下标。
|
|
* @param [IN] name 新的显示名；传入空串表示恢复使用原始列名。
|
|
* @return 修改成功返回 true。
|
|
*/
|
|
bool SetSignalDisplayName(int fileIndex, int signalIndex, const std::wstring& name);
|
|
|
|
/**
|
|
* @brief 修改某个文件分组的显示名称。
|
|
* @param [IN] fileIndex 文件下标。
|
|
* @param [IN] name 新的分组名；传入空串表示恢复使用文件名。
|
|
* @return 修改成功返回 true。
|
|
*/
|
|
bool SetFileDisplayName(int fileIndex, const std::wstring& name);
|
|
|
|
/**
|
|
* @brief 解析信号引用。
|
|
* @param [IN] ref 信号引用。
|
|
* @return 信号数据指针，引用无效时返回 nullptr。
|
|
*/
|
|
const SignalData* Resolve(const SignalRef& ref) const;
|
|
|
|
/**
|
|
* @brief 获取指定信号的显示外观（只读）。
|
|
* @param [IN] ref 信号引用。
|
|
* @return 外观指针，引用无效时返回 nullptr。
|
|
*/
|
|
const SignalStyle* Style(const SignalRef& ref) const;
|
|
|
|
/**
|
|
* @brief 获取指定信号的显示外观（可写）。
|
|
* @param [IN] ref 信号引用。
|
|
* @return 外观指针，引用无效时返回 nullptr。
|
|
*/
|
|
SignalStyle* Style(const SignalRef& ref);
|
|
|
|
/**
|
|
* @brief 计算全部文件时间范围的并集下限。
|
|
* @return 时间下限。
|
|
*/
|
|
double MinTime() const;
|
|
|
|
/**
|
|
* @brief 计算全部文件时间范围的并集上限。
|
|
* @return 时间上限。
|
|
*/
|
|
double MaxTime() const;
|
|
|
|
/**
|
|
* @brief 获取当前选中的信号（全标签页共享）。
|
|
* @return 信号引用。
|
|
*/
|
|
const SignalRef& Selected() const { return m_selected; }
|
|
|
|
/**
|
|
* @brief 设置当前选中的信号（全标签页共享）。
|
|
* @param [IN] ref 信号引用；传入无效值表示取消选择。
|
|
*/
|
|
void SetSelected(const SignalRef& ref) { m_selected = ref; }
|
|
|
|
/**
|
|
* @brief 在数据层移除某文件之前，按旧下标修正选中引用。
|
|
* @param [IN] fileIndex 即将被移除的文件下标。
|
|
*/
|
|
void RemapSelectionAfterFileRemoval(int fileIndex);
|
|
|
|
/**
|
|
* @brief 校验选中引用是否仍指向存在的信号，失效则取消选中。
|
|
* @return 选中状态发生变化返回 true。
|
|
*/
|
|
bool ValidateSelection();
|
|
|
|
private:
|
|
std::vector<DataFile> m_files; /**< 已加载文件集合。 */
|
|
SignalRef m_selected; /**< 当前选中信号（跨标签页共享）。 */
|
|
};
|
|
|
|
/**
|
|
* @brief 一个波形网格（纵向泳道），可容纳多条信号叠加显示。
|
|
*/
|
|
struct Lane
|
|
{
|
|
std::wstring name; /**< 网格名称。 */
|
|
std::vector<SignalRef> signals; /**< 该网格包含的信号（按加入顺序）。 */
|
|
bool autoRange = true; /**< 是否依据信号取值范围自动计算 Y 轴。 */
|
|
double yMin = -1.0; /**< 手动 Y 轴下限。 */
|
|
double yMax = 1.0; /**< 手动 Y 轴上限。 */
|
|
|
|
/**
|
|
* @brief 「选区 Y 轴自适应」开关。
|
|
*
|
|
* 开启后每次对该网格做时间轴选区放大，都会自动把本网格的 Y 轴匹配到新的可见时间区间；
|
|
* 用户手动调整幅值（拖拽平移、Y 轴选区放大、直接输入上下限）后会自动关闭。
|
|
*/
|
|
bool fitYToSelection = false;
|
|
|
|
/**
|
|
* @brief 「实验性功能 → 边沿计数」开关。
|
|
*
|
|
* 开启后本网格显示一条横向光标（可上下拖动），并在浮动面板中列出该网格各信号的
|
|
* 上升沿 / 下降沿数量。与 `fitYToSelection` 一样属于网格自身状态，重建网格时按信号继承。
|
|
*/
|
|
bool edgeCount = false;
|
|
|
|
/** 横向光标所在的幅值（数据单位）。 */
|
|
double edgeValue = 0.0;
|
|
|
|
/** `edgeValue` 是否已经初始化（首次开启时取可见幅值范围的中点）。 */
|
|
bool edgeValueValid = false;
|
|
|
|
/** 边沿统计浮动面板是否展开（点击面板上的 ✕ 后置 false）。 */
|
|
bool edgePanelOpen = true;
|
|
|
|
/** 统计面板左上角位置（客户区像素；<0 表示自动定位到绘图区右侧）。 */
|
|
double edgePanelX = -1.0;
|
|
|
|
/** 统计面板左上角纵坐标（<0 表示自动定位）。 */
|
|
double edgePanelY = -1.0;
|
|
|
|
/**
|
|
* @brief 「实验性功能 → 边沿计数（中心轴）」开关。
|
|
*
|
|
* 开启后为本网格内每条信号额外绘制一条"中心平均值曲线"（每个数据点取自身与左右各
|
|
* `edgeCenterSmooth` 个点的平均值），并按“信号穿越中心平均值曲线”统计上/下边沿。
|
|
* 这条曲线只是叠加显示，不会作为信号加入左侧列表。
|
|
*/
|
|
bool edgeCenter = false;
|
|
|
|
/** 中心平均值的平滑半径 N（左右各取 N 个数据点，窗口大小 2N+1）。 */
|
|
int edgeCenterSmooth = 5;
|
|
|
|
/** 中心轴统计浮动面板是否展开。 */
|
|
bool edgeCenterPanelOpen = true;
|
|
|
|
/** 中心轴统计面板左上角位置（客户区像素；<0 表示自动定位）。 */
|
|
double edgeCenterPanelX = -1.0;
|
|
|
|
/** 中心轴统计面板左上角纵坐标（<0 表示自动定位）。 */
|
|
double edgeCenterPanelY = -1.0;
|
|
};
|
|
|
|
/**
|
|
* @brief 计算某条信号在给定时刻的取值。
|
|
* @param [IN] file 信号所属文件。
|
|
* @param [IN] signal 目标信号。
|
|
* @param [IN] time 采样时刻。
|
|
* @param [IN] interpolate 是否在相邻采样点之间做线性插值。
|
|
* @param [OUT] value 输出采样值，缺失时为 NaN。
|
|
* @return 时间点落在数据范围内且取到有效值返回 true。
|
|
*/
|
|
bool SampleFileAt(const DataFile& file, const SignalData& signal, double time, bool interpolate, double& value);
|
|
|
|
/**
|
|
* @brief 在指定文件的时间轴上查找与给定时刻最接近的采样点。
|
|
* @param [IN] file 目标文件。
|
|
* @param [IN] time 采样时刻。
|
|
* @return 采样点下标，文件为空时返回 -1。
|
|
*/
|
|
int FindNearestSample(const DataFile& file, double time);
|
|
|
|
/**
|
|
* @brief 单个标签页的独立视图配置（信号可见性、网格划分与视图范围）。
|
|
*
|
|
* 仅保存「本页看到哪些信号」与视图状态；信号的显示外观（颜色/线宽/透明度/样式）
|
|
* 保存在 `DataSet` 中并被所有标签页共享，因此同一个信号在各视图中的显示效果一致。
|
|
*/
|
|
class TabConfig
|
|
{
|
|
public:
|
|
TabConfig();
|
|
|
|
/**
|
|
* @brief 获取标签页名称。
|
|
* @return 名称。
|
|
*/
|
|
const std::wstring& Name() const { return m_name; }
|
|
|
|
/**
|
|
* @brief 设置标签页名称。
|
|
* @param [IN] name 新名称。
|
|
*/
|
|
void SetName(const std::wstring& name) { m_name = name; }
|
|
|
|
/**
|
|
* @brief 依据数据集合调整配置容量（新增文件补默认配置，移除文件清理配置）。
|
|
* @param [IN] dataSet 数据集合。
|
|
*/
|
|
void SyncToDataSet(const DataSet& dataSet);
|
|
|
|
/**
|
|
* @brief 在数据层移除某文件之前，按旧下标修正本配置（不重建网格）。
|
|
* @param [IN] fileIndex 即将被移除的文件下标。
|
|
* @note 调用顺序必须为：各标签页 RemapAfterFileRemoval → 数据层 RemoveFile → 各标签页 SyncToDataSet。
|
|
*/
|
|
void RemapAfterFileRemoval(int fileIndex);
|
|
|
|
/**
|
|
* @brief 判断指定信号是否可见。
|
|
* @param [IN] ref 信号引用。
|
|
* @return 可见返回 true。
|
|
*/
|
|
bool IsVisible(const SignalRef& ref) const;
|
|
|
|
/**
|
|
* @brief 设置指定信号的可见性，并同步网格划分。
|
|
* @param [IN] dataSet 数据集合。
|
|
* @param [IN] ref 信号引用。
|
|
* @param [IN] visible 目标可见状态。
|
|
*/
|
|
void SetVisible(const DataSet& dataSet, const SignalRef& ref, bool visible);
|
|
|
|
/**
|
|
* @brief 切换指定信号的可见性，并同步网格划分。
|
|
* @param [IN] dataSet 数据集合。
|
|
* @param [IN] ref 信号引用。
|
|
*/
|
|
void ToggleVisible(const DataSet& dataSet, const SignalRef& ref);
|
|
|
|
/**
|
|
* @brief 设置某个文件全部信号的可见性，并同步网格划分。
|
|
* @param [IN] dataSet 数据集合。
|
|
* @param [IN] fileIndex 文件下标。
|
|
* @param [IN] visible 目标可见状态。
|
|
*/
|
|
void SetFileVisible(const DataSet& dataSet, int fileIndex, bool visible);
|
|
|
|
/**
|
|
* @brief 设置全部信号可见性，并同步网格划分。
|
|
* @param [IN] dataSet 数据集合。
|
|
* @param [IN] visible 目标可见状态。
|
|
*/
|
|
void SetAllVisible(const DataSet& dataSet, bool visible);
|
|
|
|
/**
|
|
* @brief 仅显示指定信号，其余全部隐藏。
|
|
* @param [IN] dataSet 数据集合。
|
|
* @param [IN] ref 需要保持可见的信号。
|
|
*/
|
|
void SoloSignal(const DataSet& dataSet, const SignalRef& ref);
|
|
|
|
/**
|
|
* @brief 判断某文件是否存在可见信号。
|
|
* @param [IN] dataSet 数据集合。
|
|
* @param [IN] fileIndex 文件下标。
|
|
* @return 存在可见信号返回 true。
|
|
*/
|
|
bool FileHasVisible(const DataSet& dataSet, int fileIndex) const;
|
|
|
|
/**
|
|
* @brief 判断某文件是否全部信号可见。
|
|
* @param [IN] dataSet 数据集合。
|
|
* @param [IN] fileIndex 文件下标。
|
|
* @return 全部可见且至少有一条信号返回 true。
|
|
*/
|
|
bool FileAllVisible(const DataSet& dataSet, int fileIndex) const;
|
|
|
|
/**
|
|
* @brief 判断是否存在任何可见信号。
|
|
* @return 存在返回 true。
|
|
*/
|
|
bool AnyVisible() const;
|
|
|
|
/**
|
|
* @brief 统计可见信号数量。
|
|
* @return 可见信号数量。
|
|
*/
|
|
int VisibleCount() const;
|
|
|
|
/**
|
|
* @brief 获取网格划分策略。
|
|
* @return 策略枚举。
|
|
*/
|
|
LaneMode Mode() const { return m_laneMode; }
|
|
|
|
/**
|
|
* @brief 设置网格划分策略并同步网格。
|
|
* @param [IN] dataSet 数据集合。
|
|
* @param [IN] mode 目标策略。
|
|
*/
|
|
void SetMode(const DataSet& dataSet, LaneMode mode);
|
|
|
|
/**
|
|
* @brief 依据当前可见性与策略重新生成网格划分。
|
|
* @param [IN] dataSet 数据集合。
|
|
*/
|
|
void SyncLanes(const DataSet& dataSet);
|
|
|
|
/**
|
|
* @brief 获取网格集合（只读）。
|
|
* @return 网格集合。
|
|
*/
|
|
const std::vector<Lane>& Lanes() const { return m_lanes; }
|
|
|
|
/**
|
|
* @brief 获取网格集合（可写）。
|
|
* @return 网格集合。
|
|
*/
|
|
std::vector<Lane>& Lanes() { return m_lanes; }
|
|
|
|
/**
|
|
* @brief 查询某信号所属网格下标。
|
|
* @param [IN] ref 信号引用。
|
|
* @return 网格下标，未找到返回 -1。
|
|
*/
|
|
int LaneOfSignal(const SignalRef& ref) const;
|
|
|
|
/**
|
|
* @brief 将信号移动到指定网格，并切换为自定义划分策略。
|
|
* @param [IN] dataSet 数据集合。
|
|
* @param [IN] ref 信号引用。
|
|
* @param [IN] laneIndex 目标网格下标，传入负值表示新建网格。
|
|
* @return 移动后该信号所在的网格下标。
|
|
*/
|
|
int MoveSignalToLane(const DataSet& dataSet, const SignalRef& ref, int laneIndex);
|
|
|
|
/**
|
|
* @brief 「拆分当前网格」：把指定网格内的信号按个拆分成独立网格。
|
|
*
|
|
* 新网格插入在原网格的**下方依次排列**（原位置 + 1 起），原本在其下方的网格
|
|
* 顺次后移。由于网格编号（GX）完全由位置推导，拆分后所有引用该编号的地方
|
|
* （左侧列表徽标、图例徽标、面板标题、右键菜单标题）会自动保持一致。
|
|
*
|
|
* @param [IN] laneIndex 待拆分的网格下标。
|
|
* @return 拆分后该网格内第一条信号所在的网格下标；无法拆分（不存在或只有 1 条信号）返回 -1。
|
|
*/
|
|
int SplitLane(int laneIndex);
|
|
|
|
/**
|
|
* @brief 查询某文件的分组是否处于折叠状态。
|
|
* @param [IN] fileIndex 文件下标。
|
|
* @return 折叠状态。
|
|
*/
|
|
bool IsCollapsed(int fileIndex) const;
|
|
|
|
/**
|
|
* @brief 切换某文件分组的折叠状态。
|
|
* @param [IN] fileIndex 文件下标。
|
|
*/
|
|
void ToggleCollapsed(int fileIndex);
|
|
|
|
/**
|
|
* @brief 计算某网格的 Y 轴显示范围。
|
|
* @param [IN] dataSet 数据集合。
|
|
* @param [IN] laneIndex 网格下标。
|
|
* @param [OUT] yMin 输出下限。
|
|
* @param [OUT] yMax 输出上限。
|
|
*/
|
|
void ComputeLaneRange(const DataSet& dataSet, int laneIndex, double& yMin, double& yMax) const;
|
|
|
|
/**
|
|
* @brief 计算全部可见信号覆盖的时间范围。
|
|
* @param [IN] dataSet 数据集合。
|
|
* @param [OUT] minTime 输出下限。
|
|
* @param [OUT] maxTime 输出上限。
|
|
* @return 存在可见信号返回 true。
|
|
*/
|
|
bool ComputeVisibleTimeBounds(const DataSet& dataSet, double& minTime, double& maxTime) const;
|
|
|
|
/// @brief 视图左边界时间（可读写）。
|
|
double& ViewMin() { return m_viewMin; }
|
|
/// @brief 视图左边界时间（只读）。
|
|
double ViewMin() const { return m_viewMin; }
|
|
/// @brief 视图右边界时间（可读写）。
|
|
double& ViewMax() { return m_viewMax; }
|
|
/// @brief 视图右边界时间（只读）。
|
|
double ViewMax() const { return m_viewMax; }
|
|
/// @brief 视图范围是否已初始化（可读写）。
|
|
bool& ViewInitialized() { return m_viewInitialized; }
|
|
/// @brief 网格纵向滚动偏移量（可读写）。
|
|
float& LaneScroll() { return m_laneScroll; }
|
|
/// @brief 网格纵向滚动偏移量（只读）。
|
|
float LaneScroll() const { return m_laneScroll; }
|
|
/// @brief 时间光标模式（可读写）。
|
|
PlotCursorMode& CursorMode() { return m_cursorMode; }
|
|
/// @brief 时间光标模式（只读）。
|
|
PlotCursorMode CursorMode() const { return m_cursorMode; }
|
|
/// @brief 是否启用了时间光标（单/双光标均为启用，只读）。
|
|
bool CursorEnabled() const { return m_cursorMode != PlotCursorMode::NONE; }
|
|
/// @brief 光标 1（左侧）的时间位置（可读写）。
|
|
double& CursorTime() { return m_cursorTime; }
|
|
/// @brief 光标 1（左侧）的时间位置（只读）。
|
|
double CursorTime() const { return m_cursorTime; }
|
|
/// @brief 光标 2 的时间位置（可读写，仅双光标模式使用）。
|
|
double& CursorTimeAlt() { return m_cursorTimeAlt; }
|
|
/// @brief 光标 2 的时间位置（只读）。
|
|
double CursorTimeAlt() const { return m_cursorTimeAlt; }
|
|
/// @brief 绘图区拖拽缩放模式（可读写）。
|
|
PlotZoomMode& ZoomMode() { return m_zoomMode; }
|
|
/// @brief 绘图区拖拽缩放模式（只读）。
|
|
PlotZoomMode ZoomMode() const { return m_zoomMode; }
|
|
|
|
private:
|
|
std::wstring m_name; /**< 标签页名称。 */
|
|
std::vector<std::vector<bool>> m_visible; /**< 信号可见性，按 [文件][信号] 索引（本页独立）。 */
|
|
std::vector<bool> m_collapsed; /**< 文件分组折叠状态，按文件索引。 */
|
|
std::vector<Lane> m_lanes; /**< 网格划分。 */
|
|
LaneMode m_laneMode = LaneMode::PER_SIGNAL; /**< 网格划分策略。 */
|
|
double m_viewMin = 0.0; /**< 视图左边界时间。 */
|
|
double m_viewMax = 1.0; /**< 视图右边界时间。 */
|
|
bool m_viewInitialized = false; /**< 视图范围是否已初始化。 */
|
|
float m_laneScroll = 0.0f; /**< 网格纵向滚动偏移量。 */
|
|
PlotCursorMode m_cursorMode = PlotCursorMode::NONE; /**< 时间光标模式（无/单/双）。 */
|
|
double m_cursorTime = 0.0; /**< 光标 1（左侧）的时间位置。 */
|
|
double m_cursorTimeAlt = 0.0; /**< 光标 2 的时间位置（仅双光标模式有效）。 */
|
|
PlotZoomMode m_zoomMode = PlotZoomMode::NONE; /**< 绘图区拖拽缩放模式。 */
|
|
};
|
|
|
|
} // namespace jdi
|
|
|
|
#endif // __DATA_MODEL_HPP__
|