DeepSeek V4.1 Flash
940b8e67e6
一、样式区「系数/偏移」二级面板：两个偏移输入框等宽对齐 - 带说明文字的 EDIT 行原来各自按自己的文本长度 + 单位后缀算宽度，于是「时间轴」 （文本更长、还带 `s` 后缀）的输入框比「Y轴」宽一截。现在同一次排布里所有 带说明文字的输入框共用**同一个宽度**（取其中最大自然宽度，再按“给最宽的说明文字 留位 / 不超过内容区 3/4”夹取），因此「Y轴」与「时间轴」严格等宽、右边界对齐。 - 断言：两个输入框 126.0 / 126.0，右边界 277.8 / 277.8。 二、自定义颜色浮层（拾色器）的绘制与排版 - **圆角不再漏像素**：色域方块的位图与色相条的渐变填充都**裁剪进同一个圆角路径** （新增公开的 `UiBuildRoundRectPath`，与 `UiFillRoundRect` / `UiDrawRoundRect` 逐点同源），色相条的圆角与色域方块完全一致。以前填充是直角矩形，会在圆角描边之外 露出四个尖角（色域左下/右下本身就是接近黑色的极值，看起来就是"角落里多出黑色像素点"）。 - 色域位图改用 `WrapModeTileFlipXY` 贴图：插值不再采样到边界之外，边缘也不会被压暗。 - 色相条改用**一条带 7 个色标的线性渐变**画满（颜色与原来 6 段拼色一致）， 顺带去掉段与段之间的接缝横线。 - RGB 三行：轨道**两侧间隙相等**（左：字母 ↔ 轨道；右：轨道 ↔ 数值区，共用同一常量）， 数值区固定 **3 个字符宽**（与数字本身无关），三行轨道等长、同 x，R/G/B 字母与数值 都**右对齐**，因此三个字母、三列数字纵向对齐。 - 色号：固定 **6+1 个字符宽**，**右边界与三行数值的右边界对齐**（像素级验证：两者 最后一个字符同列）；预览色块的长宽不变、左边界与轨道左边界对齐。 - 数值/色号正好 3 / 7 个字符宽，编辑态需要把文本区向外扩出输入框内边距，否则最后 一个字符会被输入框内边距裁掉（新增 `PaddedEditRect`，绘制、命中与插入符定位共用）。 三、修复“用选区放大把视界放大到某个临界点后，拖拽光标就飞到视界边缘” 两个独立原因，都属于“不变量只在某一个调用点维护”： 1. **吸附到采样点**没有边界检查：只要采样点间距 ≥6px 就吸附，而视界一旦比一个采样间隔还窄 （选区放大很容易做到），“最近的采样点”就落在视界之外，于是每一次鼠标移动都把光标 吸到视界外、再被夹回边缘 → 表现为光标“飞到视界边缘后跟不动鼠标”。现在吸附要求 视界内至少放得下 2 个采样点，且只接受**可见区间内**的采样点。 2. **选区放大没有最小跨度下限**：滚轮缩放有 `数据跨度 × 1e-9` 的下限，选区放大没有， 可以一直放大到视界宽度只有几个 double ULP。此时“像素 → 时间”的映射退化 （相邻像素映射到同一个 double），鼠标一动光标就跨几百像素。现在新增 `MinimumTimeSpan`（数据跨度 × 1e-9 与 `ULP(时间) × 画布宽度` 取大者）与 **视界的唯一写入口 `SetTimeView`**（拒绝非有限值、纠正左右颠倒、抬到下限之上、 再按数据范围收敛），滚轮缩放 / 选区放大 / 平移 / 适应视图 / 时间轴适应网格全部走它。 - 另新增**光标位置的唯一写入口 `PlaceCursorTime`**（拖拽光标必须经由此处）： 拒绝非有限值 → 吸附（带上限与可见区间检查）→ 夹回可见区间。`XToTime` 也补上了 跨度退化时的兜底。 - ⚠️ 为什么会反复出现：这两个不变量（“视界必须仍然可表示/可用”“光标必须落在可见区间内、 且对应鼠标位置”）过去是**在每个调用点各自维护**的。后来加入的路径（选区放大、采样点吸附、 派生信号/偏移等新算子）各自绕过了其中一个环节，而故障只有在放大到极限时才可见， 于是每加一个新功能就可能复发一次。现在视界与光标各只有一个守门人，新功能必须经过它们。 四、离屏验证（窗口隐藏、不碰屏幕/鼠标/键盘） - 新增 [AQ]：视界比采样间隔还窄时拖光标必须跟随鼠标（修复前偏差 630px、直接贴边）； 视界内采样点仍精确吸附；连续橡胶带放大不会再突破可分辨下限（停在 1e-9 数据跨度）， 且在极限缩放下拖拽仍精确跟随（修复前 490px 偏差）。 - 新增 [AR]：色域方块与色相条四角之外不再有填充像素（角像素从填充色变为面板底色）、 两侧间隙相等、数值列 3 字符、色号 7 字符且与数值右边界同列（像素级）、预览色块左边界 与轨道左边界对齐、三条轨道等长同 x。 - [AP] 增加两个偏移输入框等宽/右对齐断言。 - ⚠️ 修正 harness 的一个**假通过**：`SetAllVisible(false)` 会清掉标签页的“视图已初始化”标记， 首次渲染的 `FitAll()` 会把测试设置的深缩放覆盖掉（[Z]/[AI]/[AQ] 的“深缩放”其实一直在 整段数据上跑，所以这类回归能溜过去）。现在相关用例显式置位该标记，[Z]/[AI] 真正进入 深缩放；并补上用例间残留弹出菜单的隔离（面板停在窗口下半部会向上翻转盖住按钮， 吞掉下一个用例的首次点击）。 - 合计 669/669 通过（连续 4 次）；`make release` 零警告（Target.exe 正在运行，链接待其关闭， 已用临时输出名验证链接自身成功）。
429 lines
16 KiB
C++
429 lines
16 KiB
C++
#ifndef __PAINT_UTIL_HPP__
|
||
#define __PAINT_UTIL_HPP__
|
||
|
||
#include <windows.h>
|
||
#include <objidl.h>
|
||
#include <gdiplus.h>
|
||
|
||
#include <cstddef>
|
||
#include <cstdint>
|
||
#include <string>
|
||
#include <vector>
|
||
|
||
#include "TextEdit.hpp"
|
||
#include "Theme.hpp"
|
||
|
||
namespace jdi
|
||
{
|
||
|
||
/**
|
||
* @brief 文本水平对齐方式（垂直方向始终居中）。
|
||
*/
|
||
enum class TextAlign : int
|
||
{
|
||
LEFT = 0, /**< 左对齐。 */
|
||
CENTER = 1, /**< 水平居中。 */
|
||
RIGHT = 2 /**< 右对齐。 */
|
||
};
|
||
|
||
/**
|
||
* @brief 图标朝向。
|
||
*/
|
||
enum class IconDirection : int
|
||
{
|
||
LEFT = 0, /**< 指向左侧。 */
|
||
RIGHT = 1, /**< 指向右侧。 */
|
||
UP = 2, /**< 指向上方。 */
|
||
DOWN = 3 /**< 指向下方。 */
|
||
};
|
||
|
||
/**
|
||
* @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 构造圆角矩形路径（与 `UiFillRoundRect` / `UiDrawRoundRect` 使用完全相同的几何）。
|
||
*
|
||
* 需要把一张位图 / 渐变**裁剪进圆角形状**时使用：
|
||
* `g.SetClip(&path)` 之后再填充，就不会在圆角之外漏出直角矩形的角。
|
||
*
|
||
* @param [IN,OUT] path 目标路径对象（不会被清空，直接追加）。
|
||
* @param [IN] rect 目标矩形。
|
||
* @param [IN] radius 圆角半径。
|
||
*/
|
||
void UiBuildRoundRectPath(gd::GraphicsPath& path, const gd::RectF& rect, float radius);
|
||
|
||
/**
|
||
* @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] 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 测量单行文本的像素宽度（无需 GDI+ 上下文，可在布局阶段调用）。
|
||
* @param [IN] font 字体句柄。
|
||
* @param [IN] text 文本内容。
|
||
* @return 文本像素宽度。
|
||
*/
|
||
float UiMeasureTextWidth(HFONT font, const std::wstring& text);
|
||
|
||
/**
|
||
* @brief 在指定裁剪矩形内以显式起点绘制一段文本（使用 GDI ExtTextOut 裁剪）。
|
||
*
|
||
* `UiText` 走 `DrawTextW`，**不遵循 GDI+ 裁剪区**；输入框在长内容、水平滚动的情况下
|
||
* 会把字符画到框体之外。本函数用 `ETO_CLIPPING` 让 GDI 自己裁剪，彻底避免越界绘制。
|
||
*
|
||
* @param [IN,OUT] g 绘图上下文。
|
||
* @param [IN] text 文本内容。
|
||
* @param [IN] font 字体句柄。
|
||
* @param [IN] x 文本起始横坐标。
|
||
* @param [IN] rect 垂直居中参考矩形。
|
||
* @param [IN] argb 文本颜色。
|
||
* @param [IN] clipRect 裁剪矩形（超出部分不绘制）。
|
||
*/
|
||
void UiTextAtClipped(gd::Graphics& g, const std::wstring& text, HFONT font, float x, const gd::RectF& rect,
|
||
std::uint32_t argb, const gd::RectF& clipRect);
|
||
|
||
/**
|
||
* @brief 计算输入框文本的绘制起点（已考虑超出框宽时的水平滚动）。
|
||
* @param [IN] rect 输入框矩形。
|
||
* @param [IN] edit 编辑模型。
|
||
* @param [IN] font 字体句柄。
|
||
* @param [IN] scale 缩放比例。
|
||
* @param [OUT] innerWidth 框内可用宽度输出。
|
||
* @return 文本绘制起点横坐标。
|
||
*/
|
||
float UiEditTextLeft(const gd::RectF& rect, const TextEdit& edit, HFONT font, float scale,
|
||
float& innerWidth);
|
||
|
||
/**
|
||
* @brief 把输入框内的横坐标换算为字符偏移（就近取整，用于鼠标定位插入符）。
|
||
* @param [IN] font 字体句柄。
|
||
* @param [IN] text 当前文本。
|
||
* @param [IN] localX 相对文本起点的横坐标（可超出 [0, 文本宽度]）。
|
||
* @return 字符偏移。
|
||
*/
|
||
std::size_t UiEditOffsetAt(HFONT font, const std::wstring& text, float localX);
|
||
|
||
/**
|
||
* @brief 在超出可用宽度时对文本做尾部省略截断（不绘制任何内容）。
|
||
* @param [IN] text 原始文本。
|
||
* @param [IN] font 字体句柄。
|
||
* @param [IN] maxWidth 允许的最大像素宽度。
|
||
* @return 截断后的文本。
|
||
*/
|
||
std::wstring UiEllipsize(const std::wstring& text, HFONT font, float maxWidth);
|
||
|
||
/**
|
||
* @brief 处理输入框内的鼠标按下：命中则把插入符定位到最近的字符边界并开始拖拽框选。
|
||
* @param [IN] font 字体句柄。
|
||
* @param [IN] rect 输入框矩形。
|
||
* @param [IN,OUT] edit 编辑模型。
|
||
* @param [IN] scale 缩放比例。
|
||
* @param [IN] x 客户区横坐标。
|
||
* @param [IN] y 客户区纵坐标。
|
||
* @return 命中输入框并开始拖拽返回 true。
|
||
*/
|
||
bool UiEditFieldMouseDown(HFONT font, const gd::RectF& rect, TextEdit& edit, float scale, int x, int y);
|
||
|
||
/**
|
||
* @brief 处理输入框内的鼠标拖拽移动（扩展选区）。
|
||
* @param [IN] font 字体句柄。
|
||
* @param [IN] rect 输入框矩形。
|
||
* @param [IN,OUT] edit 编辑模型。
|
||
* @param [IN] scale 缩放比例。
|
||
* @param [IN] x 客户区横坐标。
|
||
* @return 选区发生变化返回 true。
|
||
*/
|
||
bool UiEditFieldMouseMove(HFONT font, const gd::RectF& rect, TextEdit& edit, float scale, int x);
|
||
|
||
/**
|
||
* @brief 在矩形中心绘制一个加号图标。
|
||
* @param [IN,OUT] g 绘图上下文。
|
||
* @param [IN] rect 图标布局矩形。
|
||
* @param [IN] argb 线条颜色。
|
||
* @param [IN] strokeWidth 线条宽度。
|
||
*/
|
||
void UiDrawPlusIcon(gd::Graphics& g, const gd::RectF& rect, std::uint32_t argb, float strokeWidth);
|
||
|
||
/**
|
||
* @brief 用 GDI 一次性绘制若干条**不透明 1px 实线**（每条线段相互独立）。
|
||
*
|
||
* 性能关键：GDI+ 的 `DrawLine` 实测每条约 0.1–0.19 ms（带抗锯齿的长线更慢），
|
||
* 而一张网格通常要画几十条网格线 —— 逐条调用会让单帧多花十几毫秒。
|
||
* 这里改用 GDI（一次取 HDC + 一支画笔 + 多个 LineTo），快一两个数量级，
|
||
* 而且像素级网格线本来就不需要抗锯齿，观感反而更清晰。
|
||
*
|
||
* ⚠️ GDI 绘制**不受 GDI+ 裁剪区约束**，因此必须显式传入裁剪矩形
|
||
* （内部用 `SaveDC` + `IntersectClipRect` 保证不越界）。
|
||
* ⚠️ 只能用于**不透明**颜色（GDI 不做 alpha 混合）；半透明色需调用方先与底色混合。
|
||
*
|
||
* @param [IN,OUT] g 绘图上下文。
|
||
* @param [IN] clip 裁剪矩形（客户区坐标）。
|
||
* @param [IN] segments 线段数组，每 4 个 float 为一条（x1,y1,x2,y2）。
|
||
* @param [IN] segmentCount 线段数量。
|
||
* @param [IN] argb 颜色（Alpha 必须为 0xFF，否则不做任何绘制）。
|
||
* @param [IN] width 线宽（像素，>= 1；仅精确支持 1，更宽时按整数宽画）。
|
||
*/
|
||
void UiDrawSolidLines(gd::Graphics& g, const gd::RectF& clip, const float* segments,
|
||
std::size_t segmentCount, std::uint32_t argb, int width = 1);
|
||
|
||
/**
|
||
* @brief 把半透明颜色与已知不透明底色混合，得到可直接用于 GDI 的不透明颜色。
|
||
* @param [IN] background 不透明底色（0xFFRRGGBB）。
|
||
* @param [IN] argb 待叠加颜色（含 alpha）。
|
||
* @return 混合后的不透明颜色。
|
||
*/
|
||
std::uint32_t UiBlendOver(std::uint32_t background, std::uint32_t argb);
|
||
|
||
/**
|
||
* @brief 作废「文本宽度测量」的记忆化缓存。
|
||
*
|
||
* `UiMeasureTextWidth` 内部按 (字体句柄, 文本) 缓存测量结果以摊薄 GDI 调用开销；
|
||
* 字体句柄被重建（DPI 变化等）时必须调用本函数，否则系统复用的同一句柄值会命中
|
||
* 旧宽度，造成布局错位。
|
||
*/
|
||
void UiClearMeasureCache();
|
||
|
||
/**
|
||
* @brief 一次性填充多个圆角矩形（同色同圆角）。
|
||
*
|
||
* 每帧要画几十个刻度数值底板时，逐个调用 `UiFillRoundRect` 会带来可观的 GDI+ 调用开销；
|
||
* 合并成一条 GraphicsPath 后只 FillPath 一次（实测约快 3 倍）。
|
||
*
|
||
* @param [IN,OUT] g 绘图上下文。
|
||
* @param [IN] rects 矩形集合。
|
||
* @param [IN] radius 圆角半径。
|
||
* @param [IN] argb 填充色。
|
||
*/
|
||
void UiFillRoundRects(gd::Graphics& g, const std::vector<gd::RectF>& rects, float radius,
|
||
std::uint32_t argb);
|
||
|
||
/**
|
||
* @brief 在矩形中心绘制一个叉号（关闭）图标。
|
||
* @param [IN,OUT] g 绘图上下文。
|
||
* @param [IN] rect 图标布局矩形。
|
||
* @param [IN] argb 线条颜色。
|
||
* @param [IN] strokeWidth 线条宽度。
|
||
*/
|
||
void UiDrawCrossIcon(gd::Graphics& g, const gd::RectF& rect, std::uint32_t argb, float strokeWidth);
|
||
|
||
/**
|
||
* @brief 在矩形中心绘制一个实心三角形指示器。
|
||
* @param [IN,OUT] g 绘图上下文。
|
||
* @param [IN] rect 图标布局矩形。
|
||
* @param [IN] argb 填充颜色。
|
||
* @param [IN] direction 三角形朝向。
|
||
*/
|
||
void UiDrawTriangleIcon(gd::Graphics& g, const gd::RectF& rect, std::uint32_t argb, IconDirection direction);
|
||
|
||
/**
|
||
* @brief 将滑块轨道上的横坐标换算为取值比例。
|
||
* @param [IN] trackRect 轨道矩形。
|
||
* @param [IN] x 横坐标。
|
||
* @return 取值比例，范围 0-1。
|
||
*/
|
||
double UiSliderRatioFromX(const gd::RectF& trackRect, float x);
|
||
|
||
/**
|
||
* @brief 绘制水平滑块（轨道 + 已填充部分 + 圆钮）。
|
||
* @param [IN,OUT] g 绘图上下文。
|
||
* @param [IN] track 轨道矩形。
|
||
* @param [IN] ratio 当前值比例（0-1）。
|
||
* @param [IN] fillColor 已填充部分颜色。
|
||
* @param [IN] active 是否处于悬停或拖拽状态（影响圆钮半径）。
|
||
* @param [IN] scale DPI 缩放比例。
|
||
*/
|
||
void UiDrawSlider(gd::Graphics& g, const gd::RectF& track, double ratio, std::uint32_t fillColor,
|
||
bool active, float scale);
|
||
|
||
/**
|
||
* @brief 绘制单行内联输入框（含选区高亮、插入符与水平滚动）。
|
||
*
|
||
* 初始状态为“整体选中”时以强调色底衬显示全部内容，首字符键入即整体替换，
|
||
* 交互观感与常见登录界面的账号/密码输入框一致；文本超出框宽时自动横向滚动，
|
||
* 保证插入符始终可见。
|
||
*
|
||
* @param [IN,OUT] g 绘图上下文。
|
||
* @param [IN] rect 输入框矩形。
|
||
* @param [IN] edit 输入框编辑模型。
|
||
* @param [IN] font 文本字体。
|
||
* @param [IN] scale DPI 缩放比例。
|
||
*/
|
||
void UiDrawEditField(gd::Graphics& g, const gd::RectF& rect, const TextEdit& edit, HFONT font,
|
||
float scale);
|
||
|
||
/**
|
||
* @brief 只绘制输入框的**内容**（选区高亮 / 文本 / 插入符），不绘制底板与边框。
|
||
*
|
||
* 用于"宿主已经画好了外框"的场景（例如信号面板的「筛选信号」输入框）：若直接调用
|
||
* UiDrawEditField，会在外框内部再套一个带边框的圆角框，形成一圈多余的内圈。
|
||
*
|
||
* @param [IN,OUT] g 绘图上下文。
|
||
* @param [IN] rect 输入框矩形（内容区，几何与 UiDrawEditField 完全一致）。
|
||
* @param [IN] edit 输入框编辑模型。
|
||
* @param [IN] font 文本字体。
|
||
* @param [IN] scale DPI 缩放比例。
|
||
*/
|
||
void UiDrawEditFieldContent(gd::Graphics& g, const gd::RectF& rect, const TextEdit& edit, HFONT font,
|
||
float scale);
|
||
|
||
/**
|
||
* @brief 取值胶囊底色上的高对比度文字色与描边色。
|
||
*/
|
||
struct UiInk
|
||
{
|
||
std::uint32_t text = 0xFF073642u; /**< 文字色（不透明）。 */
|
||
std::uint32_t outline = 0x99FDF6E3u; /**< 描边色（半透明，恒与文字色反相）。 */
|
||
};
|
||
|
||
/**
|
||
* @brief 颜色的相对亮度（0-1，逐通道线性加权）。
|
||
* @param [IN] color 0xAARRGGBB 颜色值。
|
||
* @return 相对亮度。
|
||
*/
|
||
double UiColorLuminance(std::uint32_t color);
|
||
|
||
/**
|
||
* @brief 依据胶囊底色求高对比度的文字色与描边色（对底色配色作线性响应）。
|
||
*
|
||
* 求值分两步：
|
||
* 1. **亮度**：按"取最大对比"的一侧选定亮文字或暗文字。这是唯一的阈值判断，但它
|
||
* 本身就是"任意底色下都保持高对比"的必要条件 —— 任何连续的亮度取值都会在中性灰
|
||
* 附近同时远离两侧极值，对比度必然塌陷。
|
||
* 2. **配色**：把该侧的极值色与**底色的互补色**按固定比例线性混合。互补色的相对亮度
|
||
* 恰为 `1 - 底色亮度`，因此文字/描边的亮度是底色亮度的**线性**函数，色相也随信号
|
||
* 配色连续变化（不再是固定的黑/白两色）。
|
||
*
|
||
* 描边色取相反的一侧，保证"描边—文字—底色"三段式对比。
|
||
*
|
||
* @param [IN] background 胶囊底色（0xAARRGGBB）。
|
||
* @return 文字色与描边色。
|
||
*/
|
||
UiInk UiContrastInk(std::uint32_t background);
|
||
|
||
/**
|
||
* @brief 绘制一个带边框的复选框。
|
||
* @param [IN,OUT] g 绘图上下文。
|
||
* @param [IN] rect 复选框矩形。
|
||
* @param [IN] state 选中状态：0 未选，1 全选，2 部分选。
|
||
* @param [IN] radius 圆角半径。
|
||
*/
|
||
void UiDrawCheckBox(gd::Graphics& g, const gd::RectF& rect, int state, float radius);
|
||
|
||
/**
|
||
* @brief 绘制颜色样块：叠加不透明度填充，透明度过低时补充描边以保证可辨识。
|
||
* @param [IN,OUT] g 绘图上下文。
|
||
* @param [IN] rect 样块矩形。
|
||
* @param [IN] color 基础颜色（0xAARRGGBB，其 Alpha 通道会被不透明度覆盖）。
|
||
* @param [IN] opacity 不透明度（0-1）。
|
||
* @param [IN] radius 圆角半径。
|
||
* @param [IN] scale DPI 缩放比例，用于推导描边粗细。
|
||
* @return 实际填充颜色的 0xAARRGGBB 值（供需要同步其他元素的调用方使用）。
|
||
*/
|
||
std::uint32_t UiDrawSwatch(gd::Graphics& g, const gd::RectF& rect, std::uint32_t color, float opacity,
|
||
float radius, float scale);
|
||
|
||
/**
|
||
* @brief 判断给定不透明度是否低到需要为样块补充描边。
|
||
* @param [IN] opacity 不透明度（0-1）。
|
||
* @return 需要描边返回 true。
|
||
*/
|
||
bool UiSwatchNeedsOutline(float opacity);
|
||
|
||
} // namespace jdi
|
||
|
||
#endif // __PAINT_UTIL_HPP__
|