必须开启QPainter::Antialiasing才能实现曲线抗锯齿,仅用QPainterPath或drawPolyline无效;推荐整数笔宽、优先使用QPainterPath构造贝塞尔曲线,并注意QWidget与QOpenGLWidget后端差异及缩放影响。

QPainter::setRenderHint() 必须开启 Antialiasing
不加这句,所有曲线都是锯齿状的,哪怕用了 QPainterPath 或 drawPolyline。Qt 默认关闭抗锯齿,因为涉及光栅化性能开销,不是“画出来就自动平滑”。
实操建议:
立即学习“C++免费学习笔记(深入)”;
- 在调用绘图函数前立即设置:
painter.setRenderHint(QPainter::Antialiasing, true) - 如果同时需要文字平滑,加上
QPainter::TextAntialiasing;但注意:某些嵌入式平台或旧显卡驱动下,TextAntialiasing可能被静默忽略 - 避免在循环里反复开关该 flag——它会触发渲染状态重置,影响性能
- 仅对矢量路径(如
QPainterPath、drawEllipse)生效;对位图(drawPixmap)无效
用 QPainterPath 比 drawPolyline() 更可靠
drawPolyline 对折线段抗锯齿效果弱,尤其在斜率突变处仍可见阶梯;而 QPainterPath 把整条曲线当一个拓扑对象处理,光栅化时能统一做边缘采样。
实操建议:
立即学习“C++免费学习笔记(深入)”;
- 构造贝塞尔曲线优先用
QPainterPath::cubicTo或quadTo,别手动拆成大量短直线段 - 若数据源是离散点列,先用样条插值生成控制点,再转为
QPainterPath,而不是直接drawPolyline(points) - 路径添加完后,用
painter.drawPath(path),不是painter.drawPolyline(path.toFillPolygon())—— 后者会破坏抗锯齿质量
笔宽(pen width)小于 1.0 会导致抗锯齿失效
当 QPen 的宽度设为 0(Qt 中表示“1 像素物理宽度”)或 0.5 等小数时,部分 Qt 版本(尤其是 Qt 5.12 以前)在启用 Antialiasing 后反而出现虚边、断线或颜色发灰。
实操建议:
立即学习“C++免费学习笔记(深入)”;
- 固定使用整数笔宽:
QPen(Qt::black, 1)或QPen(Qt::black, 2) - 真需要细线时,改用
QPen(Qt::black, 1, Qt::SolidLine, Qt::RoundCap, Qt::RoundJoin),确保端点和连接处也参与抗锯齿计算 - 避免
setCosmetic(true)和小数 width 同时使用——cosmetic 笔在高 DPI 下行为不稳定
QWidget vs QOpenGLWidget 渲染后端差异
在 QWidget 上启用了 Antialiasing,曲线看起来平滑;但换到 QOpenGLWidget 子类中重写 paintGL(),可能完全没效果——因为 OpenGL 渲染路径绕过了 QPainter 的抗锯齿逻辑。
实操建议:
立即学习“C++免费学习笔记(深入)”;
- 确认当前 widget 类型:如果是
QOpenGLWidget,不要依赖QPainter::Antialiasing,改用 OpenGL 原生 MSAA 或 FXAA 后处理 - 若必须用 QPainter,在
QOpenGLWidget中调用beginNativePainting()/endNativePainting()切回光栅管线,但性能下降明显 - Qt 6 中
QPainter在 OpenGL 后端已大幅改进,但QPainterPath的曲线细分策略仍与软件渲染不同,实测建议始终在目标平台上验证
真正容易被忽略的是:抗锯齿不是“打开就完事”,它依赖路径构造方式、笔属性、设备像素比(devicePixelRatio())、甚至窗口是否被缩放。同一段代码,在 100% 缩放的 4K 屏和 150% 缩放的笔记本上,锯齿表现可能完全不同。


















