#ifndef __THEME_HPP__ #define __THEME_HPP__ #include #include #include #include /// @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((argb >> 24) & 0xFFu), static_cast((argb >> 16) & 0xFFu), static_cast((argb >> 8) & 0xFFu), static_cast(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(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((fromColor >> shift) & 0xFFu); const double b = static_cast((toColor >> shift) & 0xFFu); const std::uint32_t mixed = static_cast(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 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 内置主题配色种类。 * * 顺序即「主题配色」二级菜单里的显示顺序(用户 2026-10-29 指定)。 */ enum class ThemeKind : int { LIGHT = 0, /**< 浅色(参考 VS Code 2026 默认浅色主题)。 */ SOLARIZED_LIGHT = 1, /**< Solarised Light(历史默认主题)。 */ DARK = 2, /**< 深色(参考 VS Code Dark+)。 */ SOLARIZED_DARK = 3 /**< Solarised Dark(参考 VS Code 的 Solarized Dark)。 */ }; /** * @brief 取某个内置主题的配色(静态实例,地址稳定)。 * @param [IN] kind 主题种类;越界时退回 Solarised Light。 * @return 主题常引用。 */ const Theme& ThemeFor(ThemeKind kind); /** * @brief 取主题在「主题配色」菜单里的显示名称。 * @param [IN] kind 主题种类。 * @return 名称(静态字符串,无需释放)。 */ const wchar_t* ThemeName(ThemeKind kind); /** * @brief 全局「当前主题」指针。 * * ⚠️ 为什么需要全局:`UiControls` 里少数几个原语(色块描边、非主题化的默认底色) * 没有 `Theme` 形参,却必须跟随用户选择的主题。宿主在启动与切换主题时调用 * `SetCurrentTheme(&m_theme)`,把**宿主自己那个** `Theme` 实例的地址交给它 —— * 这样切换主题只需修改 `m_theme` 的内容,不需要通知每一个组件刷新指针。 * * @return 当前主题;未设置时返回 Solarised Light。 */ const Theme& CurrentTheme(); /** * @brief 设置全局「当前主题」。 * @param [IN] theme 主题实例(必须比使用期更长;传 nullptr 表示恢复默认)。 */ void SetCurrentTheme(const Theme* theme); /** * @brief 获取波形默认配色表。 * @param [OUT] count 配色数量输出。 * @return 颜色数组首地址。 */ const std::uint32_t* SignalPalette(int& count); } // namespace jdi #endif // __THEME_HPP__