Qt绘制矢量图形时如何实现亚像素精度？

问题描述 #

我用Python和PySide6编写测试脚本验证Qt的矢量图形绘制精度，测试内容为绘制外红内蓝的嵌套圆盘：

import sys

from PySide6.QtCore import Qt, QPoint
from PySide6.QtWidgets import QApplication, QWidget
from PySide6.QtGui import QPainter, QBrush

radii_difference = 1
x_offset = 0


class MyWidget(QWidget):
    def paintEvent(self, event):
        self.setWindowTitle("radii_difference: {}; x_offset: {}".format(radii_difference, x_offset))
        print("radii_difference: {}; x_offset: {}".format(radii_difference, x_offset))
        painter = QPainter(self)
        painter.setRenderHint(QPainter.Antialiasing, on=True)
        painter.setPen(Qt.NoPen)
        painter.setBrush(QBrush(Qt.red))
        painter.drawEllipse(QPoint(300, 250), 200, 200)
        painter.setBrush(QBrush(Qt.blue))
        painter.drawEllipse(QPoint(300 + x_offset, 250), 200 - radii_difference, 200 - radii_difference)


if __name__ == '__main__':
    app = QApplication(sys.argv)

    widget = MyWidget()
    widget.show()

    sys.exit(app.exec_())

测试发现：

• 当radii_difference设为0.5和1时，蓝色圆盘的红色轮廓厚度无差异，说明drawEllipse的整数参数版本会将半径取整；
• 当x_offset设为0.5时，QPoint仅接受整数坐标，图形位置无变化。

需要解决如何提升QPainter的绘制精度，或者找到Qt中支持亚像素精度的其他矢量绘制方案。

提升QPainter绘制精度的方法 #

1. 使用浮点坐标与浮点绘制函数 #

Qt提供了支持浮点类型的API替代整数版本：

• 用QPointF替代QPoint：QPointF支持亚像素级坐标偏移，解决x_offset=0.5时无变化的问题；
• 使用drawEllipse的浮点重载版本：drawEllipse(const QPointF &center, qreal rx, qreal ry)，该版本会保留半径的小数部分，不会强制取整。

修改后的核心代码示例：

# 替换原绘制代码
painter.drawEllipse(QPointF(300, 250), 200.0, 200.0)
painter.setBrush(QBrush(Qt.blue))
painter.drawEllipse(QPointF(300 + x_offset, 250), 200.0 - radii_difference, 200.0 - radii_difference)

2. 启用更高质量的渲染提示 #

除基础抗锯齿外，添加以下渲染提示可进一步提升精度：

painter.setRenderHint(QPainter.Antialiasing, True)
painter.setRenderHint(QPainter.HighQualityAntialiasing, True)
painter.setRenderHint(QPainter.SmoothPixmapTransform, True)

HighQualityAntialiasing会使用更精确的抗锯齿算法，确保亚像素边缘的平滑过渡。

替代方案：Qt中支持亚像素精度的其他矢量绘制方案 #

如果需要更极致的精度控制，可以考虑以下方案：

1. QPainterPath #

QPainterPath完全基于浮点坐标构建图形路径，支持亚像素级形状定义。你可以用它创建椭圆路径，再通过fillPath绘制：

path = QPainterPath()
path.addEllipse(QPointF(300 + x_offset, 250), 200.0 - radii_difference, 200.0 - radii_difference)
painter.fillPath(path, QBrush(Qt.blue))

2. Qt SVG模块 #

SVG是原生支持浮点坐标的矢量格式，Qt的QSvgWidget/QSvgRenderer可直接渲染SVG内容，天然具备亚像素精度。你可以通过代码生成SVG字符串，或加载外部SVG文件进行渲染。

3. Qt Quick #

Qt Quick的Scene Graph渲染架构专为高精度UI设计，完全支持亚像素级绘制。使用QML编写图形绘制逻辑，能获得比QWidget更细腻的渲染效果，适合需要高精度的现代UI场景。

内容的提问来源于stack exchange，提问作者HelloGoodbye