API 参考

PaintCompat

该头文件公开的类型、函数与常量参考。

`FluentRasterCachePainter`

继承自 QPainter

显式位图缓存保留原 DPR 元数据；仅在画笔忽略小于 1 的 DPR 时补偿，新 Qt 的矩阵保持不变。

构造函数

explicit FluentRasterCachePainter(QPaintDevice* target)

Qt 基类完整成员：QPainter

`Global`

方法

template <class Device> inline void fluentSetRenderTargetDevicePixelRatio(Device& device, qreal dpr): Qt 5.15/6.2 将画布 DPR 钳制到 1，特效滤镜也假定至少单位密度。显式渲染目标保持 DPR >= 1，剩余缩放交给画笔；不扩大分配尺寸或脏图块。
inline void fluentApplyRenderTargetScale(QPainter& painter, qreal dpr): 对已归一化的显式渲染目标补充剩余缩放；每次绘制开始时调用一次。
inline QSize fluentPixmapLogicalSize(const QPixmap& pixmap)
inline void fluentDrawPixmapAt(QPainter& painter, const QPointF& position, const QPixmap& pixmap): 按逻辑尺寸绘制位图，包含小于 1 的 DPR。
inline void fluentDrawImageAt(QPainter& painter, const QPointF& position, const QImage& image): 按逻辑尺寸绘制图像，包含小于 1 的 DPR。
inline QRectF fluentPixmapSourceRectForDraw(const QRectF& logicalSource, const QPixmap& pixmap)
inline QPixmap fluentIconPixmapForLogicalExtent(const QIcon& icon, const QSize& logicalExtent, qreal devicePixelRatio = 1.0, QWindow* targetWindow = nullptr)
inline qreal fluentPainterDevicePixelRatio(const QPainter& painter): 绘制器当前绘制设备的有效设备像素比。
inline void fluentDrawPixmapInLogicalRect(QPainter& painter, const QRectF& logicalRect, const QPixmap& source): 按绘制器设备 DPR 将 pixmap 画进逻辑矩形。
inline void fluentDrawPixmapInLogicalRect(QPainter& painter, const QRect& logicalRect, const QPixmap& source)
inline void fluentDrawCoverPixmapInLogicalRect(QPainter& painter, const QRectF& logicalRect, const QPixmap& source): 以 cover（裁切铺满）方式将 pixmap 画进逻辑矩形。

类型与别名

using FluentColorComponent = float: QColor::getHsvF / getRgbF / getHslF 分量指针类型。
using FluentColorComponent = qreal