#ifndef __COLOR_PICKER_POPUP_HPP__ #define __COLOR_PICKER_POPUP_HPP__ #include #include #include #include #include #include "PaintUtil.hpp" #include "Theme.hpp" namespace jdi { /** * @brief 浮动式 RGB 自定义颜色拾取器。 * * 与弹出菜单一致,不创建独立窗口,而是作为宿主绘制的最后一步直接画到后备缓冲区, * 以浮动面板的形式出现在触发控件附近;取值变化实时生效,点击面板外部即收起。 */ class ColorPickerPopup { public: ColorPickerPopup(); /** * @brief 绑定字体与主题资源。 * @param [IN] fonts 字体集合,需在弹出面板生命周期内保持有效。 * @param [IN] theme 主题配色,需在弹出面板生命周期内保持有效。 */ void Setup(const UiFonts* fonts, const Theme* theme); /** * @brief 设置 DPI 缩放比例。 * @param [IN] scale 缩放比例(1.0 对应 96 DPI)。 */ void SetScale(float scale); /** * @brief 在指定位置打开拾色面板。 * @param [IN] bounds 宿主客户区矩形,用于把面板限制在窗口内。 * @param [IN] anchor 触发控件矩形(客户区坐标),面板会紧贴其下方或上方展开。 * @param [IN] color 初始颜色(0xAARRGGBB,仅取 RGB 分量)。 */ void Open(const gd::RectF& bounds, const gd::RectF& anchor, std::uint32_t color); /** * @brief 关闭拾色面板。 */ void Close(); /** * @brief 判断拾色面板是否处于打开状态。 * @return 打开返回 true。 */ bool IsOpen() const { return m_open; } /** * @brief 获取当前取色结果。 * @return 0xAARRGGBB 颜色值(Alpha 固定为不透明)。 */ std::uint32_t CurrentColor() const; /** * @brief 取出并清除“取值已变化”标记。 * @param [OUT] color 变化后的颜色。 * @return 自上次调用以来取值发生过变化返回 true。 */ bool TakeChanged(std::uint32_t& color); /** * @brief 绘制拾色面板(应在宿主绘制的最后一步调用)。 * @param [IN,OUT] g 绘图上下文。 */ void Paint(gd::Graphics& g); /** * @brief 处理鼠标移动(含滑块拖拽)。 * @param [IN] x 客户区横坐标。 * @param [IN] y 客户区纵坐标。 * @return 需要重绘返回 true。 */ bool OnMouseMove(int x, int y); /** * @brief 处理鼠标左键按下。 * @param [IN] x 客户区横坐标。 * @param [IN] y 客户区纵坐标。 * @return 事件已被消费返回 true。 */ bool OnLButtonDown(int x, int y); /** * @brief 处理鼠标左键抬起。 * @return 需要重绘返回 true。 */ bool OnLButtonUp(); /** * @brief 处理键盘按键(Esc 收起)。 * @param [IN] key 虚拟键码。 * @return 事件已被消费返回 true。 */ bool OnKeyDown(WPARAM key); /** * @brief 判断坐标是否落在拾色面板内部。 * @param [IN] x 客户区横坐标。 * @param [IN] y 客户区纵坐标。 * @return 落在内部返回 true。 */ bool ContainsPoint(int x, int y) const; private: /** * @brief 依据锚点矩形与客户区计算面板矩形与内部控件矩形。 * @param [IN] bounds 宿主客户区矩形。 * @param [IN] anchor 触发控件矩形。 */ void BuildLayout(const gd::RectF& bounds, const gd::RectF& anchor); /** * @brief 查询坐标命中的滑块下标。 * @param [IN] x 客户区横坐标。 * @param [IN] y 客户区纵坐标。 * @return 滑块下标(0=R,1=G,2=B),未命中返回 -1。 */ int SliderAtPoint(int x, int y) const; /** * @brief 应用滑块拖拽位置到对应通道。 * @param [IN] index 滑块下标。 * @param [IN] x 客户区横坐标。 */ void ApplySlider(int index, float x); const UiFonts* m_fonts = nullptr; /**< 字体资源。 */ const Theme* m_theme = nullptr; /**< 主题资源。 */ float m_scale = 1.0f; /**< DPI 缩放比例。 */ bool m_open = false; /**< 是否处于打开状态。 */ bool m_changed = false; /**< 取值是否发生变化。 */ int m_draggingSlider = -1; /**< 正在拖拽的滑块下标,-1 表示未拖拽。 */ int m_hoverSlider = -1; /**< 当前悬停的滑块下标。 */ std::array m_channels = {0.0, 0.0, 0.0}; /**< RGB 分量(0-1)。 */ gd::RectF m_rect; /**< 面板整体矩形。 */ gd::RectF m_titleRect; /**< 标题区域。 */ std::array m_tracks; /**< 滑块轨道矩形。 */ std::array m_values; /**< 数值文本矩形。 */ gd::RectF m_previewRect; /**< 预览色块矩形。 */ gd::RectF m_hexRect; /**< 十六进制文本矩形。 */ }; } // namespace jdi #endif // __COLOR_PICKER_POPUP_HPP__