一、两个「边沿计数」按「画出来的曲线」判定(原先按原始采样值 → 应用过「调整」的信号恒为 0)
- 用户复述的权威定义:设定一个横向(Y 轴)光标,信号绘制出来的曲线从下往上穿过该幅值 = 上升沿,
从上往下穿过 = 下降沿。
- 症状:VERY_BIG_DATA 的「编码器B相」设系数 50 + 时间轴偏移 -20s,把光标拖到画面中间,
很规整的方波却统计出 0/0。
- 根因:EdgeCountsFor / EdgeCenterCountsFor 只比较 signal.values 的原始采样值,而横向光标读的是
屏幕上的值(已乘系数、已加偏移)→ 原始值域与阈值完全不相交。
- 修法:判定值一律取 ApplyDrawTransform(style, values[SourceIndexFor(style, count, index)]);
* 中心轴两侧必须套用同一套变换(drawn - drawnCenter);
* 水平镜像时曲线数组按源下标存储、而统计区间是显示下标 → 请求曲线窗口前必须把
[needFirst, needEnd) 映射为 [count-needEnd, count-needFirst);
* 缓存必须带样式指纹:EdgeCountEntry / EdgeCenterCountEntry 新增 styleKey
(EdgeStyleKey():gain/offsetY 按 1e6 定点 + absolute/mirrorVertical/mirrorHorizontal 位),
否则改完「调整」仍会命中变换前的旧计数。
二、时间区间之外的采样不得计入(区间边界点)
- 症状:A 在阈值以下、B 超过阈值;双光标下一个光标正好在 B 点,旧实现把 B 算成一个上升沿。
- 根因:EdgeIndexRange 在左端多取了一个采样点(if (begin > 0) --begin;)。
- 修法:删掉该外扩,收紧为「只有两个端点都落在 [begin, end) 内的采样对才计入」
(begin = lower_bound(rangeMin)、end = upper_bound(rangeMax),调用方从 begin+1 枚举到 end-1)。
- 结果:把区间起点从 times[crossing-1] 移到 times[crossing] 恰好少一个上升沿。
三、派生信号把 offsetTime 也烘进采样值(推翻 §9.19 的「唯一例外」)
- 用户要求:新信号默认不启用任何「调整」时就必须与网格里的预览逐点重合。
- 修法(Application::BuildDerivedSignal,在「值变换 + 水平镜像反序」之后追加一步):
新信号第 i 个采样 = 已变换的曲线在 time[i] - offsetTime 处的取值(取最近的采样点);
单调时间轴用只前进的游标(整段 O(n));平移后越界的采样置 NaN(与预览一致);
新信号样式全部保持默认(gain=1 / absolute=false / 两个镜像=false / offsetY=0 / offsetTime=0)。
- 退化路径:时间轴非单调或时间列缺失时无法按下标推进取样,退回把 offsetTime 带在样式上
(两条路径的显示效果相同)。
四、图例托底统一为 GX 编号徽标同款 + 新增更小字体 uiTiny
- 托底高度 = kLaneBadgeHeight、上下边界与 LaneBadgeRect() 完全一致、圆角 = 高度的一半(胶囊形)、
配色与描边与徽标相同(选中态 accentSoft/accent)、水平内边距 = 胶囊半径。
- 文本改用新增字体 UiFonts::uiTiny(10 逻辑 px):原 uiSmall(12px) 几乎顶满 17px 高的胶囊。
- LegendItem 拆出 plateWidth(托底宽 = 内容宽 + 2×内边距),条目步进 = plateWidth + kLegendItemGap;
kLegendPlateRadius 已删除(半径一律由徽标高度推出)。
五、「系数/偏移」「镜像」二级面板改为向上展开
- PopupMenu::Open(..., bool expandUp = false):true 时 (x, y) 是菜单的左下角、菜单向上展开;
BuildLayout 增加同参数并记录 m_buildExpandUp(RebuildLayout 必须复用,否则数值回写触发的重排
会让面板跳回向下展开)。
- SignalPanel::OpenGainMenu / OpenMirrorMenu:锚点 = (button.X, button.Y - kAdjustMenuGap),
即「面板左下角对准按钮左上角、再略微上去一点」(kAdjustMenuGap = 4 逻辑像素)。
六、验证(全部离屏,不占用用户的鼠标 / 键盘 / 屏幕)
- .preflight/uitest 新增 [AR]:
* 边沿计数 plain / gain=50 / offsetY / mirrorVertical / mirrorHorizontal 逐个与「独立参考实现」
逐位一致;offsetY 用例给出 A/B:按原始采样值算会得到 7/6 个边沿(正是用户报告的缺陷);
* 区间边界:起点从 crossing-1 移到 crossing 恰好少一个上升沿;
* 中心轴:absolute + offsetY 的样式下与参考实现逐位一致(32234 个边沿量级);
* 派生信号:无偏移时全部 128 万采样逐点等于 transform(滤波);带 +10 个平均采样周期的偏移时,
抽样点等于 transform(滤波) 在 time[i] - offsetTime(最近采样)处的取值;样式全默认;
* 图例托底:height == 徽标高度、Y == 徽标 Y、radius == height/2、色块与文本都在托底之内;
* 调整面板:菜单左边界 == 按钮左边界、菜单底 == 按钮顶 - 4*scale、且不覆盖按钮(两个按钮各测一次);
* GX 拖拽让位:±0.6H 各让位 1 格(目标 0 / 3),±0.4H 与恰好 ±0.5H 都不让位(严格「超过」)。
- 同步修正 harness 里两处「旧规则」断言(否则必然 FAIL 并误导后来者):
[AP] 「派生信号继承调整变换」→ 「样式默认 + 采样值按 time[i]-offsetTime 烘焙」;
[AN] 「图例带无托底(网格线可透出)」→ 「装饰矩形逐块、无一块跨越整条带、未被托底覆盖的列
仍能看到底层内容」。
- 合计 722/722 通过;make release 零警告(本机 GCC 15.2.0 UCRT;Target.exe 被占用时链接会报
Permission denied,已用临时 -o 名字验证链接正确性)。
规则同步:Documents/agent_mem.md 新增 §9.21,§9.19 的「offsetTime 仍需继承」标注为已作废,
新增 §11.2 第 21–25 条硬约束,并补变更日志一行。
430 lines
16 KiB
C++
430 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 uiTiny = nullptr; /**< 微型界面字体(图例文字:必须能放进 GX 徽标同款的托底)。 */
|
||
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__
|