feat: 搭建 Just DataInspector 波形数据查看器基础功能
基于 Win32 API + GDI+ 从零实现仿真数据检查器，用于替代 Simulink.sdi.view 查看带时间轴的 CSV 数据。 - 新增 Utilities 层：UTF-8/宽字符与数值格式化工具、CSV 解析器（自动识别分隔符与引号）、 信号数据集模型（时间轴识别、信号名解析、取值采样）、Solarised Light 主题色板与绘图基础工具 - 新增 Toolbar 组件：打开 CSV、适应窗口、适应时间、放大、缩小、合并网格、每信号一格 - 新增 SignalPanel 组件：信号列表（可见性开关、颜色标识、所属网格标记）、样式编辑区 （颜色、线宽、线段/散点/点线/阶梯显示方式、所属网格），支持右键上下文菜单与滚轮滚动 - 新增 PlotView 组件：多网格波形绘制、自适应时间轴与幅值轴、网格线、信号图例、 时间光标与实时数值读数、纵向滚动条 - 新增 Application 组件：DPI 感知（Per-Monitor V2）、双缓冲绘制、区域布局与分隔条拖拽、 鼠标与键盘消息分发、文件拖放、状态栏提示 - 交互能力：滚轮缩放、Shift+滚轮平移、Ctrl+滚轮缩放幅值、拖拽平移、幅值轴纵向缩放、 右键框选缩放、单击固定/取消时间光标、双击自适应、方向键平移与滚动 - 补齐 Makefile 的源文件与头文件索引，并新增 gdiplus、comdlg32 链接库
This commit is contained in:
DeepSeek V4.1 Flash committed
commit
132b305544
22 files changed
+7146
No files matched your search
@@ -0,0 +1,43 @@
|
||||
#ifndef __CSV_TABLE_HPP__
|
||||
#define __CSV_TABLE_HPP__
|
||||
|
||||
#include <cstddef>
|
||||
#include <string>
|
||||
#include <vector>
|
||||
|
||||
namespace jdi
|
||||
{
|
||||
|
||||
/**
|
||||
* @brief CSV 文件的解析结果，保存列名与数值矩阵。
|
||||
*/
|
||||
struct CsvTable
|
||||
{
|
||||
std::vector<std::wstring> headers; /**< 列名（已去除引号与首尾空白）。 */
|
||||
std::vector<std::vector<double>> rows; /**< 数值矩阵，行优先，每行长度与 headers 一致。 */
|
||||
wchar_t delimiter = L','; /**< 实际使用的分隔符。 */
|
||||
std::size_t sourceRowCount = 0; /**< 文件中有效数据行数（不含空行与注释行）。 */
|
||||
std::size_t skippedRowCount = 0; /**< 因格式异常被置为缺失值的行数。 */
|
||||
|
||||
/**
|
||||
* @brief 判断解析结果是否包含可用的表格数据。
|
||||
* @return 存在列名且存在数据行时返回 true。
|
||||
*/
|
||||
bool HasData() const
|
||||
{
|
||||
return !headers.empty() && !rows.empty();
|
||||
}
|
||||
};
|
||||
|
||||
/**
|
||||
* @brief 读取并解析一个 CSV 文件。
|
||||
* @param [IN] filePath CSV 文件完整路径（宽字符，支持中文路径）。
|
||||
* @param [OUT] table 解析结果输出。
|
||||
* @param [OUT] error 失败原因描述（成功时清空）。
|
||||
* @return 解析成功返回 true，否则返回 false。
|
||||
*/
|
||||
bool LoadCsvTable(const std::wstring& filePath, CsvTable& table, std::wstring& error);
|
||||
|
||||
} // namespace jdi
|
||||
|
||||
#endif // __CSV_TABLE_HPP__
|
||||
@@ -0,0 +1,163 @@
|
||||
#ifndef __PAINT_UTIL_HPP__
|
||||
#define __PAINT_UTIL_HPP__
|
||||
|
||||
#include <windows.h>
|
||||
#include <objidl.h>
|
||||
#include <gdiplus.h>
|
||||
|
||||
#include <cstdint>
|
||||
#include <string>
|
||||
|
||||
#include "Theme.hpp"
|
||||
|
||||
namespace jdi
|
||||
{
|
||||
|
||||
/**
|
||||
* @brief 文本水平对齐方式（垂直方向始终居中）。
|
||||
*/
|
||||
enum class TextAlign : int
|
||||
{
|
||||
LEFT = 0, /**< 左对齐。 */
|
||||
CENTER = 1, /**< 水平居中。 */
|
||||
RIGHT = 2 /**< 右对齐。 */
|
||||
};
|
||||
|
||||
/**
|
||||
* @brief 按 DPI 创建并缓存整套界面字体（GDI 字体句柄）。
|
||||
*/
|
||||
struct UiFonts
|
||||
{
|
||||
HFONT ui = nullptr; /**< 常规界面字体。 */
|
||||
HFONT uiBold = nullptr; /**< 加粗界面字体。 */
|
||||
HFONT uiSmall = nullptr; /**< 小号界面字体。 */
|
||||
HFONT uiSmallBold = nullptr;/**< 小号加粗界面字体。 */
|
||||
HFONT title = nullptr; /**< 标题字体。 */
|
||||
HFONT mono = nullptr; /**< 等宽数值字体。 */
|
||||
HFONT monoSmall = nullptr; /**< 小号等宽字体。 */
|
||||
UINT dpi = 96; /**< 创建时所使用的 DPI。 */
|
||||
|
||||
/**
|
||||
* @brief 依据 DPI 创建全部字体。
|
||||
* @param [IN] dpi 目标 DPI（96 对应 100% 缩放）。
|
||||
* @return 创建成功返回 true。
|
||||
*/
|
||||
bool Create(UINT dpi);
|
||||
|
||||
/**
|
||||
* @brief 释放全部字体句柄。
|
||||
*/
|
||||
void Destroy();
|
||||
|
||||
~UiFonts() { Destroy(); }
|
||||
};
|
||||
|
||||
/**
|
||||
* @brief 将 0xAARRGGBB 颜色值转换为 GDI COLORREF。
|
||||
* @param [IN] argb 颜色值。
|
||||
* @return GDI 颜色值。
|
||||
*/
|
||||
inline COLORREF ToColorRef(std::uint32_t argb)
|
||||
{
|
||||
return RGB((argb >> 16) & 0xFFu, (argb >> 8) & 0xFFu, argb & 0xFFu);
|
||||
}
|
||||
|
||||
/**
|
||||
* @brief 判断点是否落在矩形内部。
|
||||
* @param [IN] rect 目标矩形。
|
||||
* @param [IN] x 横坐标。
|
||||
* @param [IN] y 纵坐标。
|
||||
* @return 落在内部返回 true。
|
||||
*/
|
||||
inline bool UiPointInRect(const gd::RectF& rect, float x, float y)
|
||||
{
|
||||
return x >= rect.X && x <= (rect.X + rect.Width) && y >= rect.Y && y <= (rect.Y + rect.Height);
|
||||
}
|
||||
|
||||
/**
|
||||
* @brief 填充矩形区域。
|
||||
* @param [IN,OUT] g 绘图上下文。
|
||||
* @param [IN] rect 目标矩形。
|
||||
* @param [IN] argb 填充颜色。
|
||||
*/
|
||||
void UiFillRect(gd::Graphics& g, const gd::RectF& rect, std::uint32_t argb);
|
||||
|
||||
/**
|
||||
* @brief 填充圆角矩形区域。
|
||||
* @param [IN,OUT] g 绘图上下文。
|
||||
* @param [IN] rect 目标矩形。
|
||||
* @param [IN] radius 圆角半径。
|
||||
* @param [IN] argb 填充颜色。
|
||||
*/
|
||||
void UiFillRoundRect(gd::Graphics& g, const gd::RectF& rect, float radius, std::uint32_t argb);
|
||||
|
||||
/**
|
||||
* @brief 描边圆角矩形。
|
||||
* @param [IN,OUT] g 绘图上下文。
|
||||
* @param [IN] rect 目标矩形。
|
||||
* @param [IN] radius 圆角半径。
|
||||
* @param [IN] argb 线条颜色。
|
||||
* @param [IN] width 线条宽度。
|
||||
*/
|
||||
void UiDrawRoundRect(gd::Graphics& g, const gd::RectF& rect, float radius, std::uint32_t argb, float width);
|
||||
|
||||
/**
|
||||
* @brief 绘制一条直线。
|
||||
* @param [IN,OUT] g 绘图上下文。
|
||||
* @param [IN] x1 起点横坐标。
|
||||
* @param [IN] y1 起点纵坐标。
|
||||
* @param [IN] x2 终点横坐标。
|
||||
* @param [IN] y2 终点纵坐标。
|
||||
* @param [IN] argb 线条颜色。
|
||||
* @param [IN] width 线条宽度。
|
||||
*/
|
||||
void UiDrawLine(gd::Graphics& g, float x1, float y1, float x2, float y2, std::uint32_t argb, float width);
|
||||
|
||||
/**
|
||||
* @brief 绘制一条虚线。
|
||||
* @param [IN,OUT] g 绘图上下文。
|
||||
* @param [IN] x1 起点横坐标。
|
||||
* @param [IN] y1 起点纵坐标。
|
||||
* @param [IN] x2 终点横坐标。
|
||||
* @param [IN] y2 终点纵坐标。
|
||||
* @param [IN] argb 线条颜色。
|
||||
* @param [IN] width 线条宽度。
|
||||
* @param [IN] dashPattern 虚线样式。
|
||||
*/
|
||||
void UiDrawDashedLine(gd::Graphics& g, float x1, float y1, float x2, float y2, std::uint32_t argb,
|
||||
float width, gd::DashStyle dashPattern = gd::DashStyleDash);
|
||||
|
||||
/**
|
||||
* @brief 在指定矩形内绘制单行文本（垂直居中，超长自动省略）。
|
||||
* @param [IN,OUT] g 绘图上下文。
|
||||
* @param [IN] text 文本内容。
|
||||
* @param [IN] font 字体句柄。
|
||||
* @param [IN] rect 文本布局矩形。
|
||||
* @param [IN] argb 文本颜色。
|
||||
* @param [IN] align 水平对齐方式。
|
||||
*/
|
||||
void UiText(gd::Graphics& g, const std::wstring& text, HFONT font, const gd::RectF& rect, std::uint32_t argb,
|
||||
TextAlign align = TextAlign::LEFT);
|
||||
|
||||
/**
|
||||
* @brief 测量单行文本的像素宽度。
|
||||
* @param [IN,OUT] g 绘图上下文。
|
||||
* @param [IN] text 文本内容。
|
||||
* @param [IN] font 字体句柄。
|
||||
* @return 文本像素宽度。
|
||||
*/
|
||||
float UiTextWidth(gd::Graphics& g, const std::wstring& text, HFONT font);
|
||||
|
||||
/**
|
||||
* @brief 在超出可用宽度时对文本做尾部省略截断。
|
||||
* @param [IN,OUT] g 绘图上下文。
|
||||
* @param [IN] text 原始文本。
|
||||
* @param [IN] font 字体句柄。
|
||||
* @param [IN] maxWidth 允许的最大像素宽度。
|
||||
* @return 截断后的文本。
|
||||
*/
|
||||
std::wstring UiEllipsize(gd::Graphics& g, const std::wstring& text, HFONT font, float maxWidth);
|
||||
|
||||
} // namespace jdi
|
||||
|
||||
#endif // __PAINT_UTIL_HPP__
|
||||
@@ -0,0 +1,212 @@
|
||||
#ifndef __SIGNAL_SET_HPP__
|
||||
#define __SIGNAL_SET_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, /**< 同时绘制插值直线与采样点散点。 */
|
||||
STEP = 3 /**< 阶梯保持（零阶保持）连线。 */
|
||||
};
|
||||
|
||||
/**
|
||||
* @brief 将绘制方式转换为中文显示名称。
|
||||
* @param [IN] mode 绘制方式。
|
||||
* @return 显示名称。
|
||||
*/
|
||||
const wchar_t* DrawModeName(DrawMode mode);
|
||||
|
||||
/**
|
||||
* @brief 单条信号（一列数据及其显示属性）。
|
||||
*/
|
||||
struct Signal
|
||||
{
|
||||
std::wstring name; /**< 显示名称（已剥离 "[n]" 序号前缀）。 */
|
||||
std::wstring rawHeader; /**< CSV 原始列名。 */
|
||||
std::wstring unit; /**< 从列名括号中提取的单位，可能为空。 */
|
||||
std::vector<double> values; /**< 采样值，缺失处为 NaN。 */
|
||||
bool visible = true; /**< 是否参与绘制。 */
|
||||
std::uint32_t color = 0xFF268BD2; /**< 波形颜色，格式 0xAARRGGBB。 */
|
||||
float lineWidth = 1.6f; /**< 线宽（逻辑像素，未乘 DPI 缩放）。 */
|
||||
DrawMode mode = DrawMode::LINE; /**< 绘制方式。 */
|
||||
double minValue = 0.0; /**< 有限采样值最小值。 */
|
||||
double maxValue = 0.0; /**< 有限采样值最大值。 */
|
||||
std::size_t finiteCount = 0; /**< 有限采样点数量。 */
|
||||
};
|
||||
|
||||
/**
|
||||
* @brief 一个波形网格（纵向泳道），可容纳多条信号叠加显示。
|
||||
*/
|
||||
struct Lane
|
||||
{
|
||||
std::wstring name; /**< 网格名称。 */
|
||||
std::vector<int> signalIndices; /**< 该网格包含的信号下标（按加入顺序）。 */
|
||||
bool autoRange = true; /**< 是否依据信号取值范围自动计算 Y 轴。 */
|
||||
double yMin = -1.0; /**< 手动 Y 轴下限。 */
|
||||
double yMax = 1.0; /**< 手动 Y 轴上限。 */
|
||||
};
|
||||
|
||||
/**
|
||||
* @brief 仿真数据集合：时间轴 + 多条信号 + 网格划分。
|
||||
*/
|
||||
class SignalSet
|
||||
{
|
||||
public:
|
||||
SignalSet();
|
||||
|
||||
/**
|
||||
* @brief 清空全部数据与显示状态。
|
||||
*/
|
||||
void Clear();
|
||||
|
||||
/**
|
||||
* @brief 依据 CSV 解析结果构建数据集（自动识别时间列与信号列）。
|
||||
* @param [IN] table CSV 解析结果。
|
||||
* @param [IN] filePath 源文件路径，用于界面展示。
|
||||
* @param [OUT] error 失败原因描述。
|
||||
* @return 构建成功返回 true。
|
||||
*/
|
||||
bool BuildFromTable(const CsvTable& table, const std::wstring& filePath, std::wstring& error);
|
||||
|
||||
/**
|
||||
* @brief 判断数据集是否已加载数据。
|
||||
* @return 已加载返回 true。
|
||||
*/
|
||||
bool IsLoaded() const { return !m_signals.empty(); }
|
||||
|
||||
/// @brief 信号集合（可读写）。
|
||||
std::vector<Signal>& Signals() { return m_signals; }
|
||||
/// @brief 信号集合（只读）。
|
||||
const std::vector<Signal>& Signals() const { return m_signals; }
|
||||
/// @brief 网格集合（可读写）。
|
||||
std::vector<Lane>& Lanes() { return m_lanes; }
|
||||
/// @brief 网格集合（只读）。
|
||||
const std::vector<Lane>& Lanes() const { return m_lanes; }
|
||||
/// @brief 时间轴数值（只读）。
|
||||
const std::vector<double>& Time() const { return m_time; }
|
||||
/// @brief 时间轴列名（只读）。
|
||||
const std::wstring& TimeColumnName() const { return m_timeColumnName; }
|
||||
/// @brief 源文件路径（只读）。
|
||||
const std::wstring& FilePath() const { return m_filePath; }
|
||||
/// @brief 源文件名称（只读）。
|
||||
const std::wstring& FileName() const { return m_fileName; }
|
||||
/// @brief 采样点数量（只读）。
|
||||
std::size_t SampleCount() const { return m_time.size(); }
|
||||
/// @brief 时间轴最小值（只读）。
|
||||
double MinTime() const { return m_minTime; }
|
||||
/// @brief 时间轴最大值（只读）。
|
||||
double MaxTime() const { return m_maxTime; }
|
||||
/// @brief 时间轴是否单调不减（只读）。
|
||||
bool TimeMonotonic() const { return m_timeMonotonic; }
|
||||
/// @brief 当前选中信号下标，-1 表示未选中（只读）。
|
||||
int SelectedSignal() const { return m_selectedSignal; }
|
||||
|
||||
/**
|
||||
* @brief 设置当前选中信号。
|
||||
* @param [IN] index 信号下标，传入越界值等价于取消选择。
|
||||
*/
|
||||
void SetSelectedSignal(int index);
|
||||
|
||||
/**
|
||||
* @brief 查询某信号所属网格下标。
|
||||
* @param [IN] signalIndex 信号下标。
|
||||
* @return 网格下标，未找到返回 -1。
|
||||
*/
|
||||
int LaneOfSignal(int signalIndex) const;
|
||||
|
||||
/**
|
||||
* @brief 将信号移动到指定网格，必要时创建新网格并回收空网格。
|
||||
* @param [IN] signalIndex 信号下标。
|
||||
* @param [IN] laneIndex 目标网格下标，传入负值表示新建网格。
|
||||
* @return 移动后该信号所在的网格下标。
|
||||
*/
|
||||
int MoveSignalToLane(int signalIndex, int laneIndex);
|
||||
|
||||
/**
|
||||
* @brief 将所有可见信号合并到同一个网格中。
|
||||
*/
|
||||
void MergeIntoSingleLane();
|
||||
|
||||
/**
|
||||
* @brief 为每条信号创建独立网格。
|
||||
*/
|
||||
void SplitIntoLanes();
|
||||
|
||||
/**
|
||||
* @brief 设置全部信号的可见状态。
|
||||
* @param [IN] visible 目标可见状态。
|
||||
*/
|
||||
void SetAllVisible(bool visible);
|
||||
|
||||
/**
|
||||
* @brief 仅显示指定信号，其余全部隐藏。
|
||||
* @param [IN] signalIndex 需要保持可见的信号下标。
|
||||
*/
|
||||
void SoloSignal(int signalIndex);
|
||||
|
||||
/**
|
||||
* @brief 计算某网格的 Y 轴显示范围。
|
||||
* @param [IN] laneIndex 网格下标。
|
||||
* @param [OUT] yMin 输出下限。
|
||||
* @param [OUT] yMax 输出上限。
|
||||
*/
|
||||
void ComputeLaneRange(int laneIndex, double& yMin, double& yMax) const;
|
||||
|
||||
/**
|
||||
* @brief 在当前时间轴上采样指定信号的值。
|
||||
* @param [IN] signalIndex 信号下标。
|
||||
* @param [IN] time 采样时刻。
|
||||
* @param [IN] interpolate 是否在相邻采样点之间做线性插值。
|
||||
* @param [OUT] value 输出采样值，缺失时为 NaN。
|
||||
* @return 时间点落在数据范围内且取到有效值返回 true。
|
||||
*/
|
||||
bool SampleAt(int signalIndex, double time, bool interpolate, double& value) const;
|
||||
|
||||
/**
|
||||
* @brief 在当前数据集中查找时间最为接近的采样点下标。
|
||||
* @param [IN] time 采样时刻。
|
||||
* @return 采样点下标，数据集为空时返回 -1。
|
||||
*/
|
||||
int FindNearestSample(double time) const;
|
||||
|
||||
private:
|
||||
/**
|
||||
* @brief 移除没有包含任何信号的网格（至少保留一个）。
|
||||
*/
|
||||
void PruneEmptyLanes();
|
||||
|
||||
/**
|
||||
* @brief 为新增信号分配默认颜色。
|
||||
* @param [IN] index 信号序号。
|
||||
* @return 0xAARRGGBB 颜色值。
|
||||
*/
|
||||
std::uint32_t PickDefaultColor(std::size_t index) const;
|
||||
|
||||
std::vector<double> m_time; /**< 时间轴数值。 */
|
||||
std::vector<Signal> m_signals; /**< 信号集合。 */
|
||||
std::vector<Lane> m_lanes; /**< 网格集合。 */
|
||||
std::wstring m_timeColumnName; /**< 时间列列名。 */
|
||||
std::wstring m_filePath; /**< 源文件完整路径。 */
|
||||
std::wstring m_fileName; /**< 源文件名称。 */
|
||||
double m_minTime = 0.0; /**< 时间轴最小值。 */
|
||||
double m_maxTime = 0.0; /**< 时间轴最大值。 */
|
||||
bool m_timeMonotonic = true; /**< 时间轴是否单调不减。 */
|
||||
int m_selectedSignal = -1; /**< 当前选中信号下标。 */
|
||||
};
|
||||
|
||||
} // namespace jdi
|
||||
|
||||
#endif // __SIGNAL_SET_HPP__
|
||||
@@ -0,0 +1,132 @@
|
||||
#ifndef __THEME_HPP__
|
||||
#define __THEME_HPP__
|
||||
|
||||
#include <windows.h>
|
||||
#include <objidl.h>
|
||||
#include <gdiplus.h>
|
||||
|
||||
#include <cstdint>
|
||||
|
||||
/// @brief GDI+ 命名空间短别名，便于在界面代码中引用绘图类型。
|
||||
namespace gd = Gdiplus;
|
||||
|
||||
namespace jdi
|
||||
{
|
||||
|
||||
/**
|
||||
* @brief 将 0xAARRGGBB 颜色值转换为 GDI+ 颜色对象。
|
||||
* @param [IN] argb 颜色值。
|
||||
* @return GDI+ 颜色对象。
|
||||
*/
|
||||
inline gd::Color ToGdiColor(std::uint32_t argb)
|
||||
{
|
||||
return gd::Color(static_cast<BYTE>((argb >> 24) & 0xFFu), static_cast<BYTE>((argb >> 16) & 0xFFu),
|
||||
static_cast<BYTE>((argb >> 8) & 0xFFu), static_cast<BYTE>(argb & 0xFFu));
|
||||
}
|
||||
|
||||
/**
|
||||
* @brief 由 0xRRGGBB 构造不透明的 0xAARRGGBB 颜色值。
|
||||
* @param [IN] rgb RGB 颜色值。
|
||||
* @return 不透明颜色值。
|
||||
*/
|
||||
inline std::uint32_t MakeArgb(std::uint32_t rgb)
|
||||
{
|
||||
return 0xFF000000u | (rgb & 0x00FFFFFFu);
|
||||
}
|
||||
|
||||
/**
|
||||
* @brief 替换颜色值的 Alpha 通道。
|
||||
* @param [IN] argb 原颜色值。
|
||||
* @param [IN] alpha 新的 Alpha 值（0-255）。
|
||||
* @return 新的颜色值。
|
||||
*/
|
||||
inline std::uint32_t WithAlpha(std::uint32_t argb, unsigned int alpha)
|
||||
{
|
||||
return (argb & 0x00FFFFFFu) | ((static_cast<std::uint32_t>(alpha) & 0xFFu) << 24);
|
||||
}
|
||||
|
||||
/**
|
||||
* @brief 在两个颜色之间做线性插值。
|
||||
* @param [IN] fromColor 起始颜色。
|
||||
* @param [IN] toColor 结束颜色。
|
||||
* @param [IN] ratio 插值比例，0 返回起始色，1 返回结束色。
|
||||
* @return 插值后的颜色值。
|
||||
*/
|
||||
inline std::uint32_t MixColor(std::uint32_t fromColor, std::uint32_t toColor, double ratio)
|
||||
{
|
||||
if (ratio < 0.0)
|
||||
{
|
||||
ratio = 0.0;
|
||||
}
|
||||
if (ratio > 1.0)
|
||||
{
|
||||
ratio = 1.0;
|
||||
}
|
||||
|
||||
std::uint32_t result = 0;
|
||||
for (int shift = 0; shift <= 24; shift += 8)
|
||||
{
|
||||
const double a = static_cast<double>((fromColor >> shift) & 0xFFu);
|
||||
const double b = static_cast<double>((toColor >> shift) & 0xFFu);
|
||||
const std::uint32_t mixed = static_cast<std::uint32_t>(a + (b - a) * ratio + 0.5);
|
||||
result |= ((mixed & 0xFFu) << shift);
|
||||
}
|
||||
return result;
|
||||
}
|
||||
|
||||
/**
|
||||
* @brief 界面主题色板（Solarised Light 派生）。
|
||||
*/
|
||||
struct Theme
|
||||
{
|
||||
std::uint32_t windowBg = 0; /**< 窗口底色。 */
|
||||
std::uint32_t toolbarBg = 0; /**< 顶部工具栏底色。 */
|
||||
std::uint32_t panelBg = 0; /**< 侧边面板底色。 */
|
||||
std::uint32_t cardBg = 0; /**< 面板内卡片底色。 */
|
||||
std::uint32_t statusBg = 0; /**< 底部状态栏底色。 */
|
||||
std::uint32_t plotBg = 0; /**< 绘图区底色。 */
|
||||
std::uint32_t border = 0; /**< 常规描边色。 */
|
||||
std::uint32_t borderStrong = 0; /**< 强调描边色。 */
|
||||
|
||||
std::uint32_t text = 0; /**< 正文文字色。 */
|
||||
std::uint32_t textStrong = 0; /**< 强调文字色。 */
|
||||
std::uint32_t textMuted = 0; /**< 次要文字色。 */
|
||||
std::uint32_t textOnAccent = 0; /**< 强调色之上的文字色。 */
|
||||
|
||||
std::uint32_t accent = 0; /**< 主题强调色。 */
|
||||
std::uint32_t accentSoft = 0; /**< 强调色的浅色版本。 */
|
||||
std::uint32_t hover = 0; /**< 悬停底色。 */
|
||||
std::uint32_t pressed = 0; /**< 按下底色。 */
|
||||
std::uint32_t selection = 0; /**< 选中底色。 */
|
||||
|
||||
std::uint32_t gridWeak = 0; /**< 次级网格线颜色。 */
|
||||
std::uint32_t gridStrong = 0; /**< 主要网格线颜色。 */
|
||||
std::uint32_t axisLine = 0; /**< 坐标轴线颜色。 */
|
||||
std::uint32_t cursor = 0; /**< 时间光标颜色。 */
|
||||
std::uint32_t readoutBg = 0; /**< 数值读数底色。 */
|
||||
std::uint32_t danger = 0; /**< 警示色。 */
|
||||
std::uint32_t warning = 0; /**< 提示色。 */
|
||||
};
|
||||
|
||||
/**
|
||||
* @brief 获取当前使用的主题（Solarised Light）。
|
||||
* @return 主题常引用。
|
||||
*/
|
||||
const Theme& SolarizedLight();
|
||||
|
||||
/**
|
||||
* @brief 获取波形默认配色表。
|
||||
* @param [OUT] count 配色数量输出。
|
||||
* @return 颜色数组首地址。
|
||||
*/
|
||||
const std::uint32_t* SignalPalette(int& count);
|
||||
|
||||
/**
|
||||
* @brief 获取波形默认配色数量。
|
||||
* @return 配色数量。
|
||||
*/
|
||||
int SignalColorCount();
|
||||
|
||||
} // namespace jdi
|
||||
|
||||
#endif // __THEME_HPP__
|
||||
@@ -0,0 +1,121 @@
|
||||
#ifndef __UTF8_UTIL_HPP__
|
||||
#define __UTF8_UTIL_HPP__
|
||||
|
||||
#include <cstddef>
|
||||
#include <string>
|
||||
#include <vector>
|
||||
|
||||
namespace jdi
|
||||
{
|
||||
|
||||
/**
|
||||
* @brief 将 UTF-8 编码的字节序列转换为宽字符串（UTF-16LE）。
|
||||
* @param [IN] text UTF-8 文本起始地址。
|
||||
* @param [IN] length 文本字节数，传入负值表示按 '\0' 结尾自动计算长度。
|
||||
* @return 转换后的宽字符串，输入非法时返回空字符串。
|
||||
*/
|
||||
std::wstring Utf8ToWide(const char* text, int length = -1);
|
||||
|
||||
/**
|
||||
* @brief 将宽字符串（UTF-16LE）转换为 UTF-8 编码的字节序列。
|
||||
* @param [IN] text 宽字符文本起始地址。
|
||||
* @return 转换后的 UTF-8 字符串，输入非法时返回空字符串。
|
||||
*/
|
||||
std::string WideToUtf8(const wchar_t* text);
|
||||
|
||||
/**
|
||||
* @brief 去除字符串首尾的空白字符（含制表、换行与不间断空格）。
|
||||
* @param [IN] text 待处理文本。
|
||||
* @return 去除首尾空白后的新字符串。
|
||||
*/
|
||||
std::wstring Trim(const std::wstring& text);
|
||||
|
||||
/**
|
||||
* @brief 去除字符串首尾的成对引号（单引号或双引号）。
|
||||
* @param [IN] text 待处理文本。
|
||||
* @return 去除引号后的新字符串。
|
||||
*/
|
||||
std::wstring StripQuotes(const std::wstring& text);
|
||||
|
||||
/**
|
||||
* @brief 仅针对 ASCII 字母执行小写转换（其余字符原样保留）。
|
||||
* @param [IN] text 待处理文本。
|
||||
* @return 转换后的新字符串。
|
||||
*/
|
||||
std::wstring ToLowerAscii(const std::wstring& text);
|
||||
|
||||
/**
|
||||
* @brief 判断字符串是否以指定前缀开头。
|
||||
* @param [IN] text 被检索文本。
|
||||
* @param [IN] prefix 前缀文本。
|
||||
* @return 以该前缀开头返回 true，否则返回 false。
|
||||
*/
|
||||
bool StartsWith(const std::wstring& text, const std::wstring& prefix);
|
||||
|
||||
/**
|
||||
* @brief 判断字符串是否包含指定子串（ASCII 大小写不敏感）。
|
||||
* @param [IN] text 被检索文本。
|
||||
* @param [IN] needle 子串文本。
|
||||
* @return 包含返回 true，否则返回 false。
|
||||
*/
|
||||
bool ContainsInsensitive(const std::wstring& text, const std::wstring& needle);
|
||||
|
||||
/**
|
||||
* @brief 从字符区间中解析一个双精度浮点数（允许尾部存在非数字残留字符）。
|
||||
* @param [IN] begin 区间起始指针。
|
||||
* @param [IN] end 区间结束指针（不包含）。
|
||||
* @param [OUT] value 解析结果输出。
|
||||
* @return 解析成功返回 true，区间为空或完全无法识别时返回 false。
|
||||
*/
|
||||
bool TryParseDouble(const char* begin, const char* end, double& value);
|
||||
|
||||
/**
|
||||
* @brief 以固定小数位格式化数值。
|
||||
* @param [IN] value 待格式化数值。
|
||||
* @param [IN] decimals 小数位数。
|
||||
* @return 格式化后的文本。
|
||||
*/
|
||||
std::wstring FormatNumber(double value, int decimals);
|
||||
|
||||
/**
|
||||
* @brief 以自适应有效位格式化数值（NaN/Inf 会被转换为可读文本）。
|
||||
* @param [IN] value 待格式化数值。
|
||||
* @return 格式化后的文本。
|
||||
*/
|
||||
std::wstring FormatValue(double value);
|
||||
|
||||
/**
|
||||
* @brief 依据坐标轴刻度步长格式化刻度标签。
|
||||
* @param [IN] value 刻度值。
|
||||
* @param [IN] step 刻度步长，用于推断所需小数位。
|
||||
* @return 刻度标签文本。
|
||||
*/
|
||||
std::wstring FormatTick(double value, double step);
|
||||
|
||||
/**
|
||||
* @brief 将整数格式化为带千位分隔符的文本。
|
||||
* @param [IN] value 待格式化整数。
|
||||
* @return 格式化后的文本。
|
||||
*/
|
||||
std::wstring FormatCount(unsigned long long value);
|
||||
|
||||
/**
|
||||
* @brief 计算“美观”的坐标轴刻度步长（1/2/5 乘以 10 的整数次幂）。
|
||||
* @param [IN] range 坐标轴数值跨度，必须为正数。
|
||||
* @param [IN] targetTicks 期望的刻度数量。
|
||||
* @return 刻度步长，输入非法时返回 1.0。
|
||||
*/
|
||||
double NiceStep(double range, int targetTicks);
|
||||
|
||||
/**
|
||||
* @brief 依据范围与步长生成刻度值序列。
|
||||
* @param [IN] minValue 范围下限。
|
||||
* @param [IN] maxValue 范围上限。
|
||||
* @param [IN] step 刻度步长。
|
||||
* @param [OUT] ticks 输出刻度序列（按升序排列）。
|
||||
*/
|
||||
void BuildTicks(double minValue, double maxValue, double step, std::vector<double>& ticks);
|
||||
|
||||
} // namespace jdi
|
||||
|
||||
#endif // __UTF8_UTIL_HPP__
|
||||
Reference in new issue
Block a user