PySide6箭头指示器红色区域毛刺：如何实现抗锯齿平滑？

你的箭头指示器功能正常，但红色扇形的毛刺问题，根源在渐变设置的精度误差和绘制路径的处理方式上，以下是具体解决方法：

问题原因 #

• 在setChunks方法中，你为颜色节点添加了-0.0000000001的偏移量，这种极小的数值会导致QConicalGradient计算颜色过渡时出现精度偏差，直接引发毛刺。
• 使用drawChord绘制半圆时，结合锥形渐变的边缘抗锯齿效果不如路径裁剪精准。
• 抗锯齿设置冗余且位置错误：子函数中save后设置的抗锯齿，会在restore时被还原，根本没起到作用，全局设置一次就足够。

修复步骤 #

1. 优化渐变颜色节点 #

去掉颜色节点的极小偏移，让下一个颜色的起始位置直接衔接上一个的结束位置，避免精度问题：

def setChunks(self, chunks: List[Tuple[float, QColor]]) ->None:
    weightsSum: float = sum(item[0] for item in chunks)
    chunks = [(item[0] / weightsSum, item[1]) for item in chunks]
    self.__gradient = QConicalGradient()
    passedWeight = 0.25  # 对应90度，开始绘制上半圆
    for weight, color in chunks:
        self.__gradient.setColorAt(passedWeight, color)
        # 直接设置下一个节点的位置，去掉极小偏移
        self.__gradient.setColorAt(passedWeight + weight, color)
        passedWeight += weight
    self.__gradient.setCenter(QPoint(0, 0))
    self.__gradient.setAngle(-90)
    self.update()

2. 用路径绘制精确半圆 #

替换__drawColorArc方法，使用QPainterPath.arcTo创建上半圆路径，再填充渐变，提升边缘精度：

def __drawColorArc(self, drawSize: int, painter: QPainter) ->None:
    painter.save()
    path = QPainterPath()
    # 创建上半圆路径：从左到右的180度圆弧
    path.arcTo(-drawSize, -drawSize, 2 * drawSize, 2 * drawSize, 180, 180)
    # 闭合路径，形成完整的半圆区域
    path.lineTo(drawSize, 0)
    path.lineTo(-drawSize, 0)
    path.closeSubpath()
    painter.setBrush(QBrush(self.__gradient))
    painter.drawPath(path)
    painter.restore()

3. 统一抗锯齿设置 #

在paintEvent中创建painter后只设置一次抗锯齿，子函数中无需重复设置：

def paintEvent(self, event: QPaintEvent) ->None:
    super().paintEvent(event)
    drawSize = min(self.width() / 2, self.height())
    painter = QPainter(self)
    # 全局设置抗锯齿，一次即可
    painter.setRenderHint(QPainter.RenderHint.Antialiasing)
    painter.translate(self.width() / 2, self.height())
    self.__drawColorArc(drawSize, painter)
    self.__drawArrowPointer(drawSize, painter)

4. 修正初始化的lineWidth参数 #

你在测试时传入了lineWidth=1000000，这个值毫无意义，改成合理的数值（比如5）：

window = ArrowPointerIndicator(
        chunks=[
            (4, Qt.GlobalColor.white),
            (1, Qt.GlobalColor.red),
            (1, Qt.GlobalColor.white),
            (1, Qt.GlobalColor.red),
            (4, Qt.GlobalColor.white),
    ], lineWidth=5)

完整修改后的代码 #

from PySide6.QtGui import QPainter, QColor, QPolygon, QPaintEvent, QConicalGradient, QGradient, QBrush, QPainterPath
from PySide6.QtCore import Signal, QSize, QRect, QPoint, Qt
from PySide6.QtWidgets import QWidget
from typing import List, Tuple

class ArrowPointerIndicator(QWidget):
    def __init__(self,
                 chunks: List[Tuple[float, QColor]],
                 lineWidth: int = 5,
                 parent: QWidget = None) ->None:
        super().__init__(parent)
        self.__arrowColor: QColor = QColor(255, 0, 0)
        self.__gradient: QGradient = None
        self.setChunks(chunks)
        self.__arrow = QPolygon([
            QPoint(-2, -80),
            QPoint(0, -100),
            QPoint(2, -80),
            QPoint(2, 10),
            QPoint(-2, 10),
            QPoint(-2, -80)
        ])
        self.__minimum = -10.0
        self.__maximum = 10.0
        self.__lineWidth = lineWidth
        self.__value: float = 0.0
    def arrowColor(self) ->QColor:
        return self.__arrowColor  
    def setArrowColor(self, arrowColor: QColor) ->None:
        if self.__arrowColor == arrowColor:
            return
        self.__arrowColor = arrowColor
        self.update()
    def setChunks(self, chunks: List[Tuple[float, QColor]]) ->None:
        weightsSum: float = sum(item[0] for item in chunks)
        chunks = [(item[0] / weightsSum, item[1]) for item in chunks]
        self.__gradient = QConicalGradient()
        passedWeight = 0.25
        for weight, color in chunks:
            self.__gradient.setColorAt(passedWeight, color)
            self.__gradient.setColorAt(passedWeight + weight, color)
            passedWeight += weight
        self.__gradient.setCenter(QPoint(0, 0))
        self.__gradient.setAngle(-90)
        self.update()

    def paintEvent(self, event: QPaintEvent) ->None:
        super().paintEvent(event)
        drawSize = min(self.width() / 2, self.height())
        painter = QPainter(self)
        painter.setRenderHint(QPainter.RenderHint.Antialiasing)
        painter.translate(self.width() / 2, self.height())
        self.__drawColorArc(drawSize, painter)
        self.__drawArrowPointer(drawSize, painter)
    def __drawColorArc(self, drawSize: int, painter: QPainter) ->None:
        painter.save()
        path = QPainterPath()
        path.arcTo(-drawSize, -drawSize, 2 * drawSize, 2 * drawSize, 180, 180)
        path.lineTo(drawSize, 0)
        path.lineTo(-drawSize, 0)
        path.closeSubpath()
        painter.setBrush(QBrush(self.__gradient))
        painter.drawPath(path)
        painter.restore()
    def __drawArrowPointer(self, drawSize: int, painter: QPainter) ->None:
        painter.save()
        painter.setBrush(self.__arrowColor)
        painter.scale(drawSize / 100.0, drawSize / 100.0)
        painter.drawConvexPolygon(self.__arrow)
        painter.restore()

if __name__ == '__main__':
    from PySide6.QtWidgets import QApplication
    import sys
    app = QApplication(sys.argv)
    window = ArrowPointerIndicator(
            chunks=[
                (4, Qt.GlobalColor.white),
                (1, Qt.GlobalColor.red),
                (1, Qt.GlobalColor.white),
                (1, Qt.GlobalColor.red),
                (4, Qt.GlobalColor.white),
        ], lineWidth=5)
    window.show()
    sys.exit(app.exec())

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