#ifndef __MF4_LOADER_HPP__
#define __MF4_LOADER_HPP__

#include <string>

#include "DataTable.hpp"

namespace jdi
{

	/**
	 * @brief 读取并解析一个 ASAM MDF v4（`.mf4` / `.mdf`）测量文件。
	 *
	 * 只解析**绘制需要的那部分**：头块版本、数据组（DG）→ 通道组（CG）→ 通道（CN）/换算（CC），
	 * 以及每个通道组的原始记录；字符串/字节数组通道、压缩数据块（DZ/HZ）与 MIME 通道一律跳过。
	 *
	 * **时间轴**：MDF 的每个通道组（CG）自带一个时间基准。本加载器把每个 CG 输出为一个
	 * 时间轴块（`TableBlock`）：块的时间列取自该组的**时间主通道**（`cn_sync_type == 1`，
	 * 退回名为 `time`/`t` 的通道，再退回第一个数值通道），其余数值通道作为该块的信号列。
	 * 内容完全相同的时间轴在数据模型层会被合并（见 `BuildSignalGroup`）。
	 *
	 * 支持的通道编码：无符号/有符号整数（1–64 位，任意位偏移）与 IEEE-754 浮点（32/64 位）。
	 * 支持的换算：无换算、线性（`phys = c0 + c1 * raw`）。其它换算按“无换算”处理。
	 *
	 * @param [IN] filePath MDF 文件完整路径。
	 * @param [OUT] source 解析结果（每个通道组一个时间轴块）。
	 * @param [OUT] error 失败原因描述（成功时清空）。
	 * @param [IN] progress 进度回调（按字节比例），可为空。
	 * @return 解析成功返回 true。
	 */
	bool LoadMf4Source(const std::wstring& filePath, LoadedSource& source, std::wstring& error,
	                   const LoadProgress& progress = LoadProgress());

} // namespace jdi

#endif // __MF4_LOADER_HPP__