数据层大重构:文件→分组 / 时间轴一等公民 / 加载器抽象 + CSV 多时间轴 + MF4 支持
一、数据模型解耦(详见 Documents/refactor_report_2026-10-15.md 与 agent_mem §9.27)
1. DataFile → SignalGroup:删除 filePath / fileName / time / timeColumnName / timeMonotonic /
minTime / maxTime —— 「分组」是应用内的逻辑容器,加载完成后与磁盘文件再无关系。
2. 新增 TimeAxis(name / time / minTime / maxTime / monotonic / finiteCount),一个分组可含 1..N 条;
SignalData 新增 axisIndex 指向所属时间轴,采样值与时间的对应关系自包含。
3. SignalData 删除冗余的 rawHeader(name 的副本)与 unit(由列名猜出、全仓无人使用);
名字只保留 name(源名称)+ displayName(用户重命名),Title() 统一展示。
4. SignalRef::fileIndex → groupIndex;DataSet:AddGroup/RemoveGroup/GroupAt/GroupCount/Groups()/
SetGroupDisplayName/RemapSelectionAfterGroupRemoval + 新增 Axis(ref);
TabConfig:SetGroupVisible/GroupHasVisible/GroupAllVisible/RemapAfterGroupRemoval +
RowKind::GROUP / CMD_GROUP_*。
5. 采样与统计 API 首参由 const DataFile& 改为 const TimeAxis&:
SampleSignalAt / SampleDisplayedSignalAt / FindNearestSample(Utilities)与
SampleSpacingPixels / VisibleIndexRange / EdgeIndexRange / MeanFilterValueAt / WeakPeakValueAt /
EdgeCountsFor / EdgeCenterCountsFor / EdgeScanFor(PlotView)。
6. 视图层:ResolvedSignal = { data, style, group, axis, visible };PolylineCacheEntry::file→group;
EdgeScanState::file→axis(统计身份 = 时间轴 + 信号);
ComputeVisibleTimeBounds 只统计可见信号真正用到的时间轴。
二、加载层抽象(格式与模型彻底解耦)
- 新增 Utilities/Inc/DataTable.hpp:DataTable(通用列优先表格)+ LoadProgress/Info +
TableBlock(一个时间轴块)+ LoadedSource(源文件全部块)。
- 新增 Utilities/Inc|Src/DataLoader.*:唯一入口 LoadSignalSource 按扩展名分发 +
IsSupportedSignalFile + SignalFileDialogFilter。
- 新增 Utilities/Inc|Src/CsvLoader.*:CSV 解析 + 多时间轴切分 + 各轴按自己的时间列裁剪。
- 新增 Utilities/Inc|Src/Mf4Loader.*:ASAM MDF v4 解析。
- 删除 Utilities/Inc/CsvTable.hpp 与 Utilities/Src/CsvTable.cpp。
- 唯一装配点 BuildSignalGroup(LoadedSource&&, paletteBase, group, error, progress):
时间轴去重合并 + 信号命名 + 调色板取色 + 统计与粗粒度包络;新增格式只需写一个加载器。
三、CSV 多时间轴(修正用户报告的缺陷)
- 只有名为 t/time/timestamp/simulation time/时间/时间轴 的列是时间轴(判据收紧,
不再用「包含 time」以免把 timeout 误判成时间轴)。
- 每个时间列开启一个新块,其后直到下一个时间列之前的列都属于该块;各块按自己的时间列裁剪
⇒ 支持各轴长度不同(Multi_Timeline.CSV 实测切出 3 条轴,长度 7/4/7);
**不再把其它 time 列当成信号显示**。
- 完全没有时间列时保留旧行为(第一列当时间轴,单轴)。
四、MF4 支持(新功能)
- 加载后新建一个分组、组名 = 文件名,文件内全部信号归入该分组。
- 每个通道组(CG)是一条时间轴,内容相同的时间轴自动合并(实测 27 个 CG → 3 条轴 / 124 条信号)。
- 实现 MDF v4 块解析(HD/DG/CG/CN/CC/DT)、1–64 位整数(任意位偏移、含符号扩展)与
32/64 位 IEEE 浮点解码、无效位(inval bit)处理、线性换算 phys = cc_val[0] + cc_val[1]*raw。
- TX 文本块同时兼容规范写法(U32 长度 + UTF-16/UTF-8)与 CANape 的「无长度前缀 NUL 结尾裸文本」。
- 未实现(跳过该组):压缩块 ##DZ/##HL/##SD、##DL 数据列表、字符串/MIME 通道。
五、顺带修复
- Application::Initialize:窗口类已注册(ERROR_CLASS_ALREADY_EXISTS)时复用而不是弹模态错误框
(旧实现让同一进程第二次构造 Application 永久阻塞);Shutdown 注销窗口类并销毁窗口。
- UI 文案统一到「分组」:选中该分组全部信号 / 取消该分组全部信号 / 关闭该分组(从工作区移除)/
请关闭部分分组或信号后重试。/ 尚未加载数据,请打开数据文件 / 打开数据文件以查看波形 /
(可同时加载多个文件,各自成为一个分组);对话框过滤器增加 *.mf4/*.mdf。
六、验证(全部离屏:BELOW_NORMAL 优先级 + SW_HIDE 窗口 + 只注入合成消息)
- 新增 .preflight/perf/datacheck_main.cpp:69/69 通过(单轴 CSV 回归、多时间轴 CSV、MF4 组名/信号数/
时间轴/主时间轴 ns→s/setSpeed 首样本与原始字节人工核对、DataSet 不变量、派生信号沿用源轴、
MF4 集成 124 信号并一格 60~68ms/帧)。
- 新增 .preflight/perf/edgecheck_main.cpp(ASCII-only,替代被编码破坏的 panelcheck):46/46 通过
(「调整」符号规则走真实菜单路径、边沿统计按帧推进/不饿死/逐位一致/无鼠标输入也完成、
面板两列等宽与信号名限宽、弱峰复位控件)。
- 既有 .preflight/perf/verify_main.cpp(已适配新 API):47/47,另有 2 条本机未同步的旧规则断言
(derived offsetTime kept / mouse in lane1 lower half),与本轮无关。
- make clean && make all 零警告。
This commit is contained in:
1 parent
fba40ee1a2
commit
6eedbe3c5d
18 files changed
+2545
-817
No files matched your search
+210
-105
@@ -9,7 +9,8 @@
|
||||
#include <atomic>
|
||||
#include <vector>
|
||||
|
||||
#include "CsvTable.hpp"
|
||||
#include "DataLoader.hpp"
|
||||
#include "DataTable.hpp"
|
||||
|
||||
namespace jdi
|
||||
{
|
||||
@@ -61,18 +62,23 @@ namespace jdi
|
||||
};
|
||||
|
||||
/**
|
||||
* @brief 全局信号引用:文件下标 + 文件内信号下标。
|
||||
* @brief 全局信号引用:**分组下标 + 组内信号下标**。
|
||||
*
|
||||
* ⚠️ 这里的「分组」是信号在应用内的**逻辑归属**(加载一个文件形成一个分组,
|
||||
* 用户可以重命名),与磁盘上的文件**没有任何关系**:文件可以在加载后被移动、
|
||||
* 重命名甚至删除,已加载的数据不受影响。因此引用只由两个下标构成,
|
||||
* 不携带路径等易失效的信息。
|
||||
*/
|
||||
struct SignalRef
|
||||
{
|
||||
int fileIndex = -1; /**< 所属文件下标。 */
|
||||
int signalIndex = -1; /**< 文件内信号下标。 */
|
||||
int groupIndex = -1; /**< 所属分组下标。 */
|
||||
int signalIndex = -1; /**< 组内信号下标。 */
|
||||
|
||||
/**
|
||||
* @brief 判断引用是否指向有效位置。
|
||||
* @return 两个下标均非负返回 true。
|
||||
*/
|
||||
bool IsValid() const { return fileIndex >= 0 && signalIndex >= 0; }
|
||||
bool IsValid() const { return groupIndex >= 0 && signalIndex >= 0; }
|
||||
|
||||
/**
|
||||
* @brief 相等比较。
|
||||
@@ -81,7 +87,7 @@ namespace jdi
|
||||
*/
|
||||
bool operator==(const SignalRef& other) const
|
||||
{
|
||||
return fileIndex == other.fileIndex && signalIndex == other.signalIndex;
|
||||
return groupIndex == other.groupIndex && signalIndex == other.signalIndex;
|
||||
}
|
||||
|
||||
/**
|
||||
@@ -261,15 +267,42 @@ namespace jdi
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* @brief 一条时间轴(时间向量 + 它的取值范围与单调性)。
|
||||
*
|
||||
* 时间轴**独立于信号**:同一分组内多条信号可以共用同一条时间轴(最常见的 CSV 单时间轴文件、
|
||||
* MF4 里同一通道组内的全部通道),也可以各自使用不同的时间轴(多 `time` 列的 CSV、
|
||||
* MF4 的不同通道组)。
|
||||
*/
|
||||
struct TimeAxis
|
||||
{
|
||||
std::wstring name; /**< 时间列名(源文件中的原样名称,如 `time`)。 */
|
||||
std::vector<double> time; /**< 时间数值,缺失处为 NaN。 */
|
||||
double minTime = 0.0; /**< 有限时间最小值。 */
|
||||
double maxTime = 0.0; /**< 有限时间最大值。 */
|
||||
bool monotonic = true; /**< 时间是否单调不减(决定能否用下标区间做二分)。 */
|
||||
std::size_t finiteCount = 0; /**< 有效时间点数量。 */
|
||||
|
||||
/** @brief 时间点数量。 */
|
||||
std::size_t Count() const { return time.size(); }
|
||||
};
|
||||
|
||||
/**
|
||||
* @brief 单条信号的元数据与采样值(纯数据,不含可见性配置)。
|
||||
*
|
||||
* ⚠️ 信号**只有两个名字字段,各有明确职责**,不要再引入第三个:
|
||||
* * `name` —— 源名称(列名 / 通道名),加载后**原样保留、永不修改**;
|
||||
* * `displayName` —— 用户在界面上重命名后的名称,为空表示“用源名称”。
|
||||
* 界面展示一律走 `Title()`。
|
||||
*
|
||||
* ⚠️ 信号的时间轴由 `axisIndex` 指向所属分组的时间轴列表,
|
||||
* 因此采样值本身不需要、也不应该携带时间信息。
|
||||
*/
|
||||
struct SignalData
|
||||
{
|
||||
std::wstring name; /**< 名称(取自文件列名,完全保留原样)。 */
|
||||
std::wstring displayName; /**< 用户重命名的显示名;为空时使用 name。 */
|
||||
std::wstring rawHeader; /**< 原始列名。 */
|
||||
std::wstring unit; /**< 从列名括号中提取的单位,可能为空。 */
|
||||
std::wstring name; /**< 源名称(列名 / 通道名,原样保留)。 */
|
||||
std::wstring displayName; /**< 用户重命名后的显示名;为空时使用 name。 */
|
||||
std::size_t axisIndex = 0; /**< 所属时间轴在分组内的下标。 */
|
||||
std::vector<double> values; /**< 采样值,缺失处为 NaN。 */
|
||||
double minValue = 0.0; /**< 有限采样值最小值。 */
|
||||
double maxValue = 0.0; /**< 有限采样值最大值。 */
|
||||
@@ -292,89 +325,154 @@ namespace jdi
|
||||
|
||||
/**
|
||||
* @brief 获取用于界面展示的名称。
|
||||
* @return 用户重命名后的显示名,未重命名时返回文件中的原始名称。
|
||||
* @return 用户重命名后的显示名,未重命名时返回源名称。
|
||||
*/
|
||||
const std::wstring& Title() const { return displayName.empty() ? name : displayName; }
|
||||
};
|
||||
|
||||
/**
|
||||
* @brief 一个已加载的数据文件及其自有时间轴。
|
||||
* @brief 一个**信号分组**:一次加载产生的全部信号,以及它们使用的若干条时间轴。
|
||||
*
|
||||
* ⚠️ 「分组」是应用内的逻辑容器,**不是文件**:加载完成后二者已无关系,
|
||||
* 因此这里**不保存文件路径**(路径只在加载那一刻用于错误提示,之后毫无用处)。
|
||||
* 分组的默认名称取源文件名(便于用户辨认来源),用户可以重命名。
|
||||
*
|
||||
* 一个分组可以包含**多条时间轴**(CSV 的多个 `time` 列、MF4 的多个通道组),
|
||||
* 每条信号通过 `SignalData::axisIndex` 指向自己那条。
|
||||
*/
|
||||
struct DataFile
|
||||
struct SignalGroup
|
||||
{
|
||||
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; /**< 时间轴是否单调不减。 */
|
||||
std::wstring name; /**< 分组默认名称(源文件名,含扩展名)。 */
|
||||
std::wstring displayName; /**< 用户重命名后的分组名;为空时使用 name。 */
|
||||
std::vector<TimeAxis> axes; /**< 该分组使用的时间轴(至少一条)。 */
|
||||
std::vector<SignalData> signals; /**< 该分组包含的信号。 */
|
||||
|
||||
/**
|
||||
* @brief 获取用于界面展示的分组名。
|
||||
* @return 用户重命名后的显示名,未重命名时返回文件名。
|
||||
* @return 用户重命名后的显示名,未重命名时返回源文件名。
|
||||
*/
|
||||
const std::wstring& Title() const { return displayName.empty() ? fileName : displayName; }
|
||||
const std::wstring& Title() const { return displayName.empty() ? name : displayName; }
|
||||
|
||||
/**
|
||||
* @brief 取某条信号所属的时间轴(下标越界时回退到第一条,保证永不返回悬空引用)。
|
||||
* @param [IN] signal 目标信号。
|
||||
* @return 时间轴引用;分组没有任何时间轴时返回内部静态空时间轴。
|
||||
*/
|
||||
const TimeAxis& AxisOf(const SignalData& signal) const
|
||||
{
|
||||
return AxisAt(signal.axisIndex);
|
||||
}
|
||||
|
||||
/**
|
||||
* @brief 按下标取时间轴(越界时回退到第一条)。
|
||||
* @param [IN] index 时间轴下标。
|
||||
* @return 时间轴引用。
|
||||
*/
|
||||
const TimeAxis& AxisAt(std::size_t index) const
|
||||
{
|
||||
static const TimeAxis kEmptyAxis;
|
||||
if (axes.empty())
|
||||
{
|
||||
return kEmptyAxis;
|
||||
}
|
||||
return axes[(index < axes.size()) ? index : 0];
|
||||
}
|
||||
|
||||
/**
|
||||
* @brief 计算本分组全部时间轴的时间范围并集。
|
||||
* @param [OUT] low 下限。 @param [OUT] high 上限。
|
||||
* @return 至少有一条时间轴有有效时间返回 true。
|
||||
*/
|
||||
bool TimeRange(double& low, double& high) const
|
||||
{
|
||||
low = 0.0;
|
||||
high = 0.0;
|
||||
bool valid = false;
|
||||
for (const TimeAxis& axis : axes)
|
||||
{
|
||||
if (axis.finiteCount == 0)
|
||||
{
|
||||
continue;
|
||||
}
|
||||
if (!valid)
|
||||
{
|
||||
low = axis.minTime;
|
||||
high = axis.maxTime;
|
||||
valid = true;
|
||||
}
|
||||
else
|
||||
{
|
||||
low = std::min(low, axis.minTime);
|
||||
high = std::max(high, axis.maxTime);
|
||||
}
|
||||
}
|
||||
return valid;
|
||||
}
|
||||
};
|
||||
|
||||
/**
|
||||
* @brief 由 CSV 解析结果构建可入库的数据文件。
|
||||
* @brief 由一个**格式无关**的加载结果构建应用内的信号分组。
|
||||
*
|
||||
* 该函数**不访问 DataSet**(只依赖传入的 CsvTable 与调色板基准序号),
|
||||
* 因此可以在工作线程上执行:大文件的解析与列重组占整个加载耗时的大头,
|
||||
* 放到工作线程后主线程只需做一次 O(1) 的移动入队,加载过程中的界面不会卡住。
|
||||
* 职责划分(新增文件格式时只需要写一个加载器,本函数完全不用改):
|
||||
* * 加载器:文件 → `LoadedSource`(若干「时间轴块」,纯格子,无应用语义);
|
||||
* * 本函数:`LoadedSource` → `SignalGroup`(时间轴**去重合并**、信号命名、
|
||||
* 调色板取色、统计与粗粒度包络层)。
|
||||
*
|
||||
* table 按右值传入:每列会被**移动**进对应信号的 values(零拷贝)。
|
||||
* 时间轴去重:内容完全相同(长度与全部数值逐位相同)的时间轴只保留一条,
|
||||
* 于是 CSV 里多个同刻度的 `time` 列、MF4 里多个同基线的通道组不会重复占内存,
|
||||
* 也不会让信号各自持有实质上相同的轴。
|
||||
*
|
||||
* @param [IN,OUT] table CSV 解析结果(列会被移走)。
|
||||
* @param [IN] filePath 源文件路径。
|
||||
* 该函数**不访问 DataSet**(只依赖传入数据与调色板基准序号),因此可以在工作线程上执行:
|
||||
* 大文件的解析与列重组占整个加载耗时的大头,放到工作线程后主线程只需做一次 O(1) 的
|
||||
* 移动入队,加载过程中的界面不会卡住。
|
||||
*
|
||||
* @param [IN,OUT] source 加载结果(列会被**移动**进信号,零拷贝)。
|
||||
* @param [IN] paletteBase 调色板起始序号(通常传入当前已有信号数)。
|
||||
* @param [OUT] file 构建结果。
|
||||
* @param [OUT] group 构建结果。
|
||||
* @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());
|
||||
bool BuildSignalGroup(LoadedSource&& source, std::size_t paletteBase, SignalGroup& group,
|
||||
std::wstring& error, const LoadProgress& progress = LoadProgress());
|
||||
|
||||
/**
|
||||
* @brief 数据集合:统一管理全部已加载文件,与视图配置无关。
|
||||
* @brief 数据集合:统一管理全部已加载的**信号分组**,与视图配置无关。
|
||||
*/
|
||||
class DataSet
|
||||
{
|
||||
public:
|
||||
/**
|
||||
* @brief 追加一个已构建好的数据文件(仅做一次移动,不拷贝采样数据)。
|
||||
* @param [IN,OUT] file 数据文件(内部缓冲会被移走)。
|
||||
* @param [OUT] fileIndex 新文件下标。
|
||||
* @brief 追加一个已构建好的信号分组(仅做一次移动,不拷贝采样数据)。
|
||||
* @param [IN,OUT] group 信号分组(内部缓冲会被移走)。
|
||||
* @param [OUT] groupIndex 新分组下标。
|
||||
* @return 追加成功返回 true。
|
||||
*/
|
||||
bool AddDataFile(DataFile&& file, int& fileIndex);
|
||||
bool AddGroup(SignalGroup&& group, int& groupIndex);
|
||||
|
||||
/**
|
||||
* @brief 在指定文件的指定信号**下方**插入一条新信号(派生信号)。
|
||||
* @brief 在指定分组的指定信号**下方**插入一条新信号(派生信号)。
|
||||
*
|
||||
* 新信号会占据 `afterSignalIndex + 1` 的位置,该位置及其后的信号下标整体后移一位;
|
||||
* 调用方必须紧接着对每个标签页调用 `TabConfig::RemapAfterSignalInsert()` 修正引用。
|
||||
* 采样值会被就地统计(min/max/finiteCount 与粗粒度包络层),显示外观按「全局信号序号」
|
||||
* 取调色板颜色(与普通新信号一致)。
|
||||
*
|
||||
* @param [IN] fileIndex 目标文件下标。
|
||||
* @param [IN] groupIndex 目标分组下标。
|
||||
* @param [IN] afterSignalIndex 插入位置的上一条信号下标。
|
||||
* @param [IN,OUT] signal 待插入的信号(values 会被统计,其余字段原样使用)。
|
||||
* @param [OUT] newSignalIndex 新信号在本文件内的下标。
|
||||
* @param [OUT] newSignalIndex 新信号在本组内的下标。
|
||||
* @return 插入成功返回 true。
|
||||
*/
|
||||
bool InsertDerivedSignal(int fileIndex, int afterSignalIndex, SignalData&& signal, int& newSignalIndex);
|
||||
bool InsertDerivedSignal(int groupIndex, int afterSignalIndex, SignalData&& signal,
|
||||
int& newSignalIndex);
|
||||
|
||||
/**
|
||||
* @brief 移除指定下标的文件,并立即释放其占用的全部采样内存。
|
||||
* @param [IN] fileIndex 文件下标。
|
||||
* @brief 移除指定下标的分组,并立即释放其占用的全部采样内存。
|
||||
* @param [IN] groupIndex 分组下标。
|
||||
* @return 移除成功返回 true。
|
||||
*/
|
||||
bool RemoveFile(int fileIndex);
|
||||
bool RemoveGroup(int groupIndex);
|
||||
|
||||
/**
|
||||
* @brief 从某个分组中移除一条信号,并立即释放它的采样内存。
|
||||
@@ -383,30 +481,30 @@ namespace jdi
|
||||
* `TabConfig::RemapAfterSignalRemoval()`,并用 `RemapSelectionAfterSignalRemoval()`
|
||||
* 修正共享选中项。使用者一旦确认不再需要该信号即可调用,本调用后其采样缓冲立即析构。
|
||||
*
|
||||
* @param [IN] fileIndex 信号所属文件下标。
|
||||
* @param [IN] signalIndex 文件内信号下标。
|
||||
* @param [IN] groupIndex 信号所属分组下标。
|
||||
* @param [IN] signalIndex 组内信号下标。
|
||||
* @return 移除成功返回 true。
|
||||
*/
|
||||
bool RemoveSignal(int fileIndex, int signalIndex);
|
||||
bool RemoveSignal(int groupIndex, int signalIndex);
|
||||
|
||||
/**
|
||||
* @brief 在数据层移除某条信号之前,按旧下标修正选中引用。
|
||||
* @param [IN] fileIndex 信号所属文件下标。
|
||||
* @param [IN] groupIndex 信号所属分组下标。
|
||||
* @param [IN] signalIndex 即将被移除的信号下标。
|
||||
*/
|
||||
void RemapSelectionAfterSignalRemoval(int fileIndex, int signalIndex);
|
||||
void RemapSelectionAfterSignalRemoval(int groupIndex, int signalIndex);
|
||||
|
||||
/**
|
||||
* @brief 判断数据集合是否为空。
|
||||
* @return 未加载任何文件返回 true。
|
||||
* @return 未加载任何分组返回 true。
|
||||
*/
|
||||
bool Empty() const { return m_files.empty(); }
|
||||
bool Empty() const { return m_groups.empty(); }
|
||||
|
||||
/**
|
||||
* @brief 获取文件数量。
|
||||
* @return 文件数量。
|
||||
* @brief 获取分组数量。
|
||||
* @return 分组数量。
|
||||
*/
|
||||
std::size_t FileCount() const { return m_files.size(); }
|
||||
std::size_t GroupCount() const { return m_groups.size(); }
|
||||
|
||||
/**
|
||||
* @brief 获取信号总数。
|
||||
@@ -415,34 +513,34 @@ namespace jdi
|
||||
std::size_t SignalCount() const;
|
||||
|
||||
/**
|
||||
* @brief 获取全部文件(只读)。
|
||||
* @return 文件集合。
|
||||
* @brief 获取全部分组(只读)。
|
||||
* @return 分组集合。
|
||||
*/
|
||||
const std::vector<DataFile>& Files() const { return m_files; }
|
||||
const std::vector<SignalGroup>& Groups() const { return m_groups; }
|
||||
|
||||
/**
|
||||
* @brief 按下标获取文件。
|
||||
* @param [IN] fileIndex 文件下标。
|
||||
* @return 文件指针,下标非法时返回 nullptr。
|
||||
* @brief 按下标获取分组。
|
||||
* @param [IN] groupIndex 分组下标。
|
||||
* @return 分组指针,下标非法时返回 nullptr。
|
||||
*/
|
||||
const DataFile* FileAt(int fileIndex) const;
|
||||
const SignalGroup* GroupAt(int groupIndex) const;
|
||||
|
||||
/**
|
||||
* @brief 修改某个信号在界面上的显示名称。
|
||||
* @param [IN] fileIndex 文件下标。
|
||||
* @param [IN] signalIndex 文件内信号下标。
|
||||
* @param [IN] name 新的显示名;传入空串表示恢复使用原始列名。
|
||||
* @brief 修改某条信号在界面上的显示名称。
|
||||
* @param [IN] groupIndex 分组下标。
|
||||
* @param [IN] signalIndex 组内信号下标。
|
||||
* @param [IN] name 新的显示名;传入空串表示恢复使用源名称。
|
||||
* @return 修改成功返回 true。
|
||||
*/
|
||||
bool SetSignalDisplayName(int fileIndex, int signalIndex, const std::wstring& name);
|
||||
bool SetSignalDisplayName(int groupIndex, int signalIndex, const std::wstring& name);
|
||||
|
||||
/**
|
||||
* @brief 修改某个文件分组的显示名称。
|
||||
* @param [IN] fileIndex 文件下标。
|
||||
* @param [IN] name 新的分组名;传入空串表示恢复使用文件名。
|
||||
* @brief 修改某个分组的显示名称。
|
||||
* @param [IN] groupIndex 分组下标。
|
||||
* @param [IN] name 新的分组名;传入空串表示恢复使用默认名称。
|
||||
* @return 修改成功返回 true。
|
||||
*/
|
||||
bool SetFileDisplayName(int fileIndex, const std::wstring& name);
|
||||
bool SetGroupDisplayName(int groupIndex, const std::wstring& name);
|
||||
|
||||
/**
|
||||
* @brief 解析信号引用。
|
||||
@@ -451,6 +549,13 @@ namespace jdi
|
||||
*/
|
||||
const SignalData* Resolve(const SignalRef& ref) const;
|
||||
|
||||
/**
|
||||
* @brief 取某条信号所属的时间轴。
|
||||
* @param [IN] ref 信号引用。
|
||||
* @return 时间轴指针,引用无效时返回 nullptr。
|
||||
*/
|
||||
const TimeAxis* Axis(const SignalRef& ref) const;
|
||||
|
||||
/**
|
||||
* @brief 获取指定信号的显示外观(只读)。
|
||||
* @param [IN] ref 信号引用。
|
||||
@@ -466,13 +571,13 @@ namespace jdi
|
||||
SignalStyle* Style(const SignalRef& ref);
|
||||
|
||||
/**
|
||||
* @brief 计算全部文件时间范围的并集下限。
|
||||
* @brief 计算全部分组、全部时间轴时间范围的并集下限。
|
||||
* @return 时间下限。
|
||||
*/
|
||||
double MinTime() const;
|
||||
|
||||
/**
|
||||
* @brief 计算全部文件时间范围的并集上限。
|
||||
* @brief 计算全部分组、全部时间轴时间范围的并集上限。
|
||||
* @return 时间上限。
|
||||
*/
|
||||
double MaxTime() const;
|
||||
@@ -490,10 +595,10 @@ namespace jdi
|
||||
void SetSelected(const SignalRef& ref) { m_selected = ref; }
|
||||
|
||||
/**
|
||||
* @brief 在数据层移除某文件之前,按旧下标修正选中引用。
|
||||
* @param [IN] fileIndex 即将被移除的文件下标。
|
||||
* @brief 在数据层移除某分组之前,按旧下标修正选中引用。
|
||||
* @param [IN] groupIndex 即将被移除的分组下标。
|
||||
*/
|
||||
void RemapSelectionAfterFileRemoval(int fileIndex);
|
||||
void RemapSelectionAfterGroupRemoval(int groupIndex);
|
||||
|
||||
/**
|
||||
* @brief 校验选中引用是否仍指向存在的信号,失效则取消选中。
|
||||
@@ -502,8 +607,8 @@ namespace jdi
|
||||
bool ValidateSelection();
|
||||
|
||||
private:
|
||||
std::vector<DataFile> m_files; /**< 已加载文件集合。 */
|
||||
SignalRef m_selected; /**< 当前选中信号(跨标签页共享)。 */
|
||||
std::vector<SignalGroup> m_groups; /**< 已加载信号分组集合。 */
|
||||
SignalRef m_selected; /**< 当前选中信号(跨标签页共享)。 */
|
||||
};
|
||||
|
||||
/**
|
||||
@@ -712,14 +817,14 @@ namespace jdi
|
||||
*
|
||||
* 加载完成后全部采样值已在内存中,本函数只查询内存数据,与源文件无关。
|
||||
*
|
||||
* @param [IN] file 信号所属的已加载数据分组(提供时间轴)。
|
||||
* @param [IN] axis 该信号使用的时间轴。
|
||||
* @param [IN] signal 目标信号。
|
||||
* @param [IN] time 采样时刻。
|
||||
* @param [IN] interpolate 是否在相邻采样点之间做线性插值。
|
||||
* @param [OUT] value 输出采样值,缺失时为 NaN。
|
||||
* @return 时间点落在数据范围内且取到有效值返回 true。
|
||||
*/
|
||||
bool SampleSignalAt(const DataFile& file, const SignalData& signal, double time, bool interpolate,
|
||||
bool SampleSignalAt(const TimeAxis& axis, const SignalData& signal, double time, bool interpolate,
|
||||
double& value);
|
||||
|
||||
/**
|
||||
@@ -732,15 +837,15 @@ namespace jdi
|
||||
* 否则读数会与看到的波形不一致。
|
||||
* ⚠️ 系数 / 绝对值 / 垂直镜像 / `offsetY` 不在这里处理,由 `ApplyDrawTransform` 负责。
|
||||
*
|
||||
* @param [IN] file 信号所属的已加载数据分组(提供时间轴)。
|
||||
* @param [IN] axis 该信号使用的时间轴。
|
||||
* @param [IN] signal 目标信号。
|
||||
* @param [IN] style 显示外观(只用 `mirrorHorizontal`)。
|
||||
* @param [IN] style 显示外观(只用 `mirrorHorizontal` 与 `offsetTime`)。
|
||||
* @param [IN] time 采样时刻。
|
||||
* @param [IN] interpolate 是否在相邻采样点之间做线性插值。
|
||||
* @param [OUT] value 输出采样值,缺失时为 NaN。
|
||||
* @return 时间点落在数据范围内且取到有效值返回 true。
|
||||
*/
|
||||
bool SampleDisplayedSignalAt(const DataFile& file, const SignalData& signal,
|
||||
bool SampleDisplayedSignalAt(const TimeAxis& axis, const SignalData& signal,
|
||||
const SignalStyle& style, double time, bool interpolate, double& value);
|
||||
|
||||
/**
|
||||
@@ -827,12 +932,12 @@ namespace jdi
|
||||
bool throttle = false);
|
||||
|
||||
/**
|
||||
* @brief 在指定文件的时间轴上查找与给定时刻最接近的采样点。
|
||||
* @param [IN] file 目标文件。
|
||||
* @brief 在给定时间轴上查找与给定时刻最接近的采样点。
|
||||
* @param [IN] axis 目标时间轴。
|
||||
* @param [IN] time 采样时刻。
|
||||
* @return 采样点下标,文件为空时返回 -1。
|
||||
* @return 采样点下标,时间轴为空时返回 -1。
|
||||
*/
|
||||
int FindNearestSample(const DataFile& file, double time);
|
||||
int FindNearestSample(const TimeAxis& axis, double time);
|
||||
|
||||
/**
|
||||
* @brief 单个标签页的独立视图配置(信号可见性、网格划分与视图范围)。
|
||||
@@ -865,10 +970,10 @@ namespace jdi
|
||||
|
||||
/**
|
||||
* @brief 在数据层移除某文件之前,按旧下标修正本配置(不重建网格)。
|
||||
* @param [IN] fileIndex 即将被移除的文件下标。
|
||||
* @note 调用顺序必须为:各标签页 RemapAfterFileRemoval → 数据层 RemoveFile → 各标签页 SyncToDataSet。
|
||||
* @param [IN] groupIndex 即将被移除的分组下标。
|
||||
* @note 调用顺序必须为:各标签页 RemapAfterGroupRemoval → 数据层 RemoveFile → 各标签页 SyncToDataSet。
|
||||
*/
|
||||
void RemapAfterFileRemoval(int fileIndex);
|
||||
void RemapAfterGroupRemoval(int groupIndex);
|
||||
|
||||
/**
|
||||
* @brief 在数据层移除某条信号之前,按旧下标修正本配置(不重建网格)。
|
||||
@@ -876,12 +981,12 @@ namespace jdi
|
||||
* 会删除该信号的可见性记录与网格归属,并把同一文件内位于其后的引用下标前移一位。
|
||||
* 若某个网格因此变空则一并移除(与“取消勾选后空网格消失”的策略一致)。
|
||||
*
|
||||
* @param [IN] fileIndex 信号所属文件下标。
|
||||
* @param [IN] groupIndex 信号所属分组下标。
|
||||
* @param [IN] signalIndex 即将被移除的信号下标。
|
||||
* @note 调用顺序必须为:各标签页 RemapAfterSignalRemoval → 数据层修正选中 →
|
||||
* 数据层 RemoveSignal → 各标签页 SyncToDataSet。
|
||||
*/
|
||||
void RemapAfterSignalRemoval(int fileIndex, int signalIndex);
|
||||
void RemapAfterSignalRemoval(int groupIndex, int signalIndex);
|
||||
|
||||
/**
|
||||
* @brief 判断指定信号是否可见。
|
||||
@@ -905,10 +1010,10 @@ namespace jdi
|
||||
|
||||
/**
|
||||
* @brief 设置某个文件全部信号的可见性,并同步网格划分。
|
||||
* @param [IN] fileIndex 文件下标。
|
||||
* @param [IN] groupIndex 分组下标。
|
||||
* @param [IN] visible 目标可见状态。
|
||||
*/
|
||||
void SetFileVisible(int fileIndex, bool visible);
|
||||
void SetGroupVisible(int groupIndex, bool visible);
|
||||
|
||||
/**
|
||||
* @brief 设置全部信号可见性,并同步网格划分。
|
||||
@@ -924,17 +1029,17 @@ namespace jdi
|
||||
|
||||
/**
|
||||
* @brief 判断某文件是否存在可见信号。
|
||||
* @param [IN] fileIndex 文件下标。
|
||||
* @param [IN] groupIndex 分组下标。
|
||||
* @return 存在可见信号返回 true。
|
||||
*/
|
||||
bool FileHasVisible(int fileIndex) const;
|
||||
bool GroupHasVisible(int groupIndex) const;
|
||||
|
||||
/**
|
||||
* @brief 判断某文件是否全部信号可见。
|
||||
* @param [IN] fileIndex 文件下标。
|
||||
* @param [IN] groupIndex 分组下标。
|
||||
* @return 全部可见且至少有一条信号返回 true。
|
||||
*/
|
||||
bool FileAllVisible(int fileIndex) const;
|
||||
bool GroupAllVisible(int groupIndex) const;
|
||||
|
||||
/**
|
||||
* @brief 判断是否存在任何可见信号。
|
||||
@@ -1010,10 +1115,10 @@ namespace jdi
|
||||
* 数据层在下标 `insertPos` 处插入了一条信号,因此本页可见性表需插入一列,
|
||||
* 且所有指向该文件、下标不小于 `insertPos` 的信号引用都要后移一位。
|
||||
*
|
||||
* @param [IN] fileIndex 发生插入的文件下标。
|
||||
* @param [IN] groupIndex 发生插入的分组下标。
|
||||
* @param [IN] insertPos 新信号的下标。
|
||||
*/
|
||||
void RemapAfterSignalInsert(int fileIndex, int insertPos);
|
||||
void RemapAfterSignalInsert(int groupIndex, int insertPos);
|
||||
|
||||
/**
|
||||
* @brief 把某信号所在的网格移动到另一信号所在网格的下方(紧邻其后)。
|
||||
@@ -1046,16 +1151,16 @@ namespace jdi
|
||||
void RenameLanes();
|
||||
|
||||
/** * @brief 查询某文件的分组是否处于折叠状态。
|
||||
* @param [IN] fileIndex 文件下标。
|
||||
* @param [IN] groupIndex 分组下标。
|
||||
* @return 折叠状态。
|
||||
*/
|
||||
bool IsCollapsed(int fileIndex) const;
|
||||
bool IsCollapsed(int groupIndex) const;
|
||||
|
||||
/**
|
||||
* @brief 切换某文件分组的折叠状态。
|
||||
* @param [IN] fileIndex 文件下标。
|
||||
* @param [IN] groupIndex 分组下标。
|
||||
*/
|
||||
void ToggleCollapsed(int fileIndex);
|
||||
void ToggleCollapsed(int groupIndex);
|
||||
|
||||
/**
|
||||
* @brief 设置「新出现的文件分组是否默认折起」。
|
||||
|
||||
Reference in new issue
Block a user