网格滚动: - 修复纵向滚动时波形与文字溢出到工具栏/时间轴的问题:网格内容裁剪改为与绘图区求交, 并对网格内的图例、幅值标签与读数框增加显式可见性判定 (GDI 文本不遵循 GDI+ 裁剪区,仅裁剪矢量绘制不足以阻止溢出)。 - 网格之间改为完整矩形描边并加大间距,边界清晰;时间轴固定预留高度,不再被网格挤压。 - 时间轴刻度标签夹在绘图区横向范围内,避免与左侧时间列名重叠。 缩放交互: - 取消滚轮缩放:滚轮改为纵向滚动网格,Shift+滚轮水平平移。 - 新增「时间轴缩放」「Y 轴缩放」工具栏切换按钮:选中后在绘图区拖拽选区放大对应轴向, 拖动过程显示选区与跨度提示(时间用强调色、Y 轴用警示色);再次点击退出该模式。 - 「适应视图」回到初始状态:恢复自适应范围并退出缩放模式。 - 移除右键框选缩放,避免与模式化缩放重复。 时间光标: - 改为工具栏「光标」按钮切换;启用时置于当前视图中心,再次点击关闭(Esc 亦可关闭)。 - 光标由鼠标靠近后拖拽移动,不再跟随鼠标;纵向贯穿全部网格并延伸到时间轴底部, 顶部带三角把手提示可拖拽。 - 具体时间读数移至绘图区顶部,仅在鼠标覆盖光标时显示,不再遮挡时间轴刻度尺。 - 双击光标进入精确时间输入,交互与线宽输入一致:整段高亮、首次键入即整体覆盖、 回车提交、Esc 取消、点击框外提交。 - 光标形态按模式区分:默认与悬停线外为箭头(不再出现十字指针), 时间轴缩放/光标为水平双向箭头,Y 轴缩放为垂直双向箭头。
499 lines
16 KiB
C++
499 lines
16 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, /**< 常规模式:拖拽平移时间轴,光标为箭头。 */
|
|
TIME = 1, /**< 时间轴缩放:在绘图区拖拽竖向选区,放大时间范围。 */
|
|
VALUE = 2 /**< Y 轴缩放:在某个网格内拖拽横向选区,放大该网格幅值范围。 */
|
|
};
|
|
|
|
/**
|
|
* @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 单条信号的元数据与采样值(纯数据,不含显示配置)。
|
|
*/
|
|
struct SignalData
|
|
{
|
|
std::wstring name; /**< 显示名称(已剥离 "[n]" 序号前缀)。 */
|
|
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 一个已加载的数据文件及其自有时间轴。
|
|
*/
|
|
struct DataFile
|
|
{
|
|
std::wstring filePath; /**< 文件完整路径。 */
|
|
std::wstring fileName; /**< 文件名称。 */
|
|
std::wstring timeColumnName; /**< 时间列列名。 */
|
|
std::vector<double> time; /**< 时间轴数值。 */
|
|
std::vector<SignalData> signals; /**< 该文件包含的信号。 */
|
|
double minTime = 0.0; /**< 时间轴最小值。 */
|
|
double maxTime = 0.0; /**< 时间轴最大值。 */
|
|
bool timeMonotonic = true; /**< 时间轴是否单调不减。 */
|
|
};
|
|
|
|
/**
|
|
* @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] 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] ref 信号引用。
|
|
* @return 信号数据指针,引用无效时返回 nullptr。
|
|
*/
|
|
const SignalData* Resolve(const SignalRef& ref) const;
|
|
|
|
/**
|
|
* @brief 计算全部文件时间范围的并集下限。
|
|
* @return 时间下限。
|
|
*/
|
|
double MinTime() const;
|
|
|
|
/**
|
|
* @brief 计算全部文件时间范围的并集上限。
|
|
* @return 时间上限。
|
|
*/
|
|
double MaxTime() const;
|
|
|
|
private:
|
|
std::vector<DataFile> m_files; /**< 已加载文件集合。 */
|
|
};
|
|
|
|
/**
|
|
* @brief 单个信号的显示配置(属于某个标签页)。
|
|
*/
|
|
struct SignalStyle
|
|
{
|
|
bool visible = false; /**< 是否参与绘制。默认关闭,由用户自行勾选。 */
|
|
std::uint32_t color = 0xFF268BD2; /**< 波形颜色,格式 0xAARRGGBB。 */
|
|
std::uint32_t customColor = 0xFF6C71C4; /**< 自定义颜色记忆值(切换预设色后仍保留)。 */
|
|
float opacity = 1.0f; /**< 不透明度,取值 0.0-1.0,默认 1.0。 */
|
|
float lineWidth = 1.6f; /**< 线宽(逻辑像素,未乘 DPI 缩放)。 */
|
|
DrawMode mode = DrawMode::LINE; /**< 绘制方式。 */
|
|
};
|
|
|
|
/**
|
|
* @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 计算某条信号在给定时刻的取值。
|
|
* @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 单个标签页的独立视图配置(信号可见性、样式、网格划分与视图范围)。
|
|
*/
|
|
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 配置指针,引用无效时返回 nullptr。
|
|
*/
|
|
const SignalStyle* Style(const SignalRef& ref) const;
|
|
|
|
/**
|
|
* @brief 获取指定信号的显示配置(可写)。
|
|
* @param [IN] ref 信号引用。
|
|
* @return 配置指针,引用无效时返回 nullptr。
|
|
*/
|
|
SignalStyle* Style(const SignalRef& ref);
|
|
|
|
/**
|
|
* @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 查询某文件的分组是否处于折叠状态。
|
|
* @param [IN] fileIndex 文件下标。
|
|
* @return 折叠状态。
|
|
*/
|
|
bool IsCollapsed(int fileIndex) const;
|
|
|
|
/**
|
|
* @brief 切换某文件分组的折叠状态。
|
|
* @param [IN] fileIndex 文件下标。
|
|
*/
|
|
void ToggleCollapsed(int fileIndex);
|
|
|
|
/**
|
|
* @brief 获取当前选中的信号引用。
|
|
* @return 信号引用。
|
|
*/
|
|
SignalRef Selected() const { return m_selected; }
|
|
|
|
/**
|
|
* @brief 设置当前选中的信号。
|
|
* @param [IN] ref 信号引用,无效值表示取消选择。
|
|
*/
|
|
void SetSelected(const SignalRef& ref) { m_selected = ref; }
|
|
|
|
/**
|
|
* @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 时间光标是否启用(可读写)。
|
|
bool& CursorEnabled() { return m_cursorEnabled; }
|
|
/// @brief 时间光标是否启用(只读)。
|
|
bool CursorEnabled() const { return m_cursorEnabled; }
|
|
/// @brief 时间光标位置(可读写)。
|
|
double& CursorTime() { return m_cursorTime; }
|
|
/// @brief 时间光标位置(只读)。
|
|
double CursorTime() const { return m_cursorTime; }
|
|
/// @brief 绘图区拖拽缩放模式(可读写)。
|
|
PlotZoomMode& ZoomMode() { return m_zoomMode; }
|
|
/// @brief 绘图区拖拽缩放模式(只读)。
|
|
PlotZoomMode ZoomMode() const { return m_zoomMode; }
|
|
|
|
private:
|
|
/**
|
|
* @brief 为新增信号补默认样式(含调色板取色)。
|
|
* @param [IN] dataSet 数据集合。
|
|
* @param [IN] fileIndex 文件下标。
|
|
* @param [IN] signalIndex 信号下标。
|
|
*/
|
|
void EnsureStyle(const DataSet& dataSet, int fileIndex, int signalIndex);
|
|
|
|
std::wstring m_name; /**< 标签页名称。 */
|
|
std::vector<std::vector<SignalStyle>> m_styles; /**< 显示配置,按 [文件][信号] 索引。 */
|
|
std::vector<bool> m_collapsed; /**< 文件分组折叠状态,按文件索引。 */
|
|
std::vector<Lane> m_lanes; /**< 网格划分。 */
|
|
LaneMode m_laneMode = LaneMode::PER_SIGNAL; /**< 网格划分策略。 */
|
|
SignalRef m_selected; /**< 当前选中信号。 */
|
|
double m_viewMin = 0.0; /**< 视图左边界时间。 */
|
|
double m_viewMax = 1.0; /**< 视图右边界时间。 */
|
|
bool m_viewInitialized = false; /**< 视图范围是否已初始化。 */
|
|
float m_laneScroll = 0.0f; /**< 网格纵向滚动偏移量。 */
|
|
bool m_cursorEnabled = false; /**< 时间光标是否启用(由工具栏按钮切换)。 */
|
|
double m_cursorTime = 0.0; /**< 时间光标位置。 */
|
|
PlotZoomMode m_zoomMode = PlotZoomMode::NONE; /**< 绘图区拖拽缩放模式。 */
|
|
};
|
|
|
|
} // namespace jdi
|
|
|
|
#endif // __DATA_MODEL_HPP__
|