Qt中启用抗锯齿时，如何让1px画笔获清晰转角并兼容半透明路径？

针对启用抗锯齿时1px线宽图形转角半透明的问题，以下几种方法可实现清晰转角，同时兼容半透明线条与任意QPainterPaths：

方法1：使用Cosmetic画笔 #

将画笔设置为Cosmetic模式，这种模式下画笔宽度基于设备像素，不受界面变换影响，Qt会优化抗锯齿下的转角渲染逻辑，直接避免半透明问题。修改后的示例代码：

def paintEvent(self, event):
    with QPainter(self) as p:
        p.setRenderHint(QPainter.Antialiasing, True)
        p.fillRect(self.rect(), QColor('black'))
        p.setBrush(Qt.NoBrush)

        # 1px Cosmetic笔，转角清晰无半透明
        pen = QPen(QColor("orange"), 1, cap=Qt.SquareCap, join=Qt.MiterJoin)
        pen.setCosmetic(True)  # 关键设置
        p.setPen(pen)
        p.drawRect(QRectF(10.5, 10.5, 50., 25.))

该方法对曲线、折线等任意路径都有效，半透明线条也不会出现转角重叠导致的深色瑕疵。

方法2：将描边路径转换为填充路径 #

用QPainterPathStroker把线条路径转换成填充区域，让转角处成为连续的填充形状，从根源上避免描边时的转角半透明和重叠问题。示例代码：

from PyQt5.QtGui import QPainterPathStroker

def paintEvent(self, event):
    with QPainter(self) as p:
        p.setRenderHint(QPainter.Antialiasing, True)
        p.fillRect(self.rect(), QColor('black'))

        # 创建目标路径（这里以矩形为例，可替换为任意QPainterPath）
        target_path = QPainterPath()
        target_path.addRect(QRectF(10.5, 10.5, 50., 25.))

        # 生成对应描边宽度的填充路径
        stroker = QPainterPathStroker()
        stroker.setWidth(1)
        stroker.setCapStyle(Qt.SquareCap)
        stroker.setJoinStyle(Qt.MiterJoin)
        fill_path = stroker.createStroke(target_path)

        # 半透明填充，无转角重叠瑕疵
        p.fillPath(fill_path, QColor("orange", 127))  # 127为半透明通道值

这种方案适配复杂路径场景，抗锯齿下的曲线、斜线依然平滑，半透明效果表现均匀。

方法3：调整坐标与画笔宽度配合 #

如果不使用Cosmetic笔，可将画笔宽度设为Qt.PenWidthZero（等价于1px设备像素），同时确保路径坐标为整数，让线条完全对齐像素边界，减少抗锯齿带来的半透明干扰：

def paintEvent(self, event):
    with QPainter(self) as p:
        p.setRenderHint(QPainter.Antialiasing, True)
        p.fillRect(self.rect(), QColor('black'))
        p.setBrush(Qt.NoBrush)

        # PenWidthZero对应1px设备像素，配合整数坐标
        p.setPen(QPen(QColor("orange"), Qt.PenWidthZero, cap=Qt.SquareCap, join=Qt.MiterJoin))
        p.drawRect(QRect(11, 11, 50, 25))  # 使用整数坐标的QRect

注意：该方法仅在无界面缩放变换时效果稳定，若存在缩放场景，优先选择前两种方法。

内容的提问来源于stack exchange，提问作者J. Coenen