PyQt6 图形绘制技术详解：从基础到高级应用

常樱沙Vigour

于 2025-06-11 09:03:05 发布

阅读量303

点赞数 5

本文链接：https://blog.youkuaiyun.com/gitblog_00814/article/details/148575506

版权

PyQt6 图形绘制技术详解：从基础到高级应用

PyQt-Chinese-tutorial PyQt6中文教程项目地址: https://gitcode.com/gh_mirrors/py/PyQt-Chinese-tutorial

前言

在 GUI 开发中，图形绘制是一个非常重要的功能。PyQt6 提供了强大的绘图系统，能够实现矢量图形、图像处理和文本渲染等功能。本文将深入讲解 PyQt6 的绘图系统，帮助开发者掌握自定义界面绘制技术。

一、PyQt6 绘图系统概述

PyQt6 的绘图系统基于 QPainter 类，它提供了丰富的 API 用于在窗口部件上进行绘制操作。绘图操作通常在 paintEvent 方法中完成，这是 Qt 框架的核心绘制机制。

1.1 基本绘图流程

所有绘图操作都遵循以下基本流程：

创建 QPainter 对象
调用 begin() 方法开始绘制
执行各种绘制操作
调用 end() 方法结束绘制

def paintEvent(self, event):
    painter = QPainter()
    painter.begin(self)
    # 绘制操作...
    painter.end()

二、文本绘制技术

文本绘制是 GUI 开发中最基础的功能之一。PyQt6 提供了灵活的文本绘制能力，支持各种字体、颜色和对齐方式。

2.1 基本文本绘制示例

def drawText(self, event, painter):
    painter.setPen(QColor(168, 34, 3))  # 设置文本颜色
    painter.setFont(QFont('Decorative', 10))  # 设置字体
    painter.drawText(event.rect(), Qt.AlignmentFlag.AlignCenter, self.text)  # 绘制居中文本

关键点说明：

setPen 设置绘制颜色
setFont 设置字体类型和大小
drawText 的第二个参数控制文本对齐方式

三、基本图形绘制

3.1 绘制点

绘制点是图形系统中最简单的操作，常用于数据可视化等场景。

def drawPoints(self, painter):
    painter.setPen(Qt.GlobalColor.red)  # 设置点的颜色
    size = self.size()  # 获取窗口尺寸
    
    for i in range(1000):
        x = random.randint(1, size.width() - 1)
        y = random.randint(1, size.height() - 1)
        painter.drawPoint(x, y)  # 绘制单个点

3.2 颜色系统

PyQt6 使用 QColor 类表示颜色，支持多种颜色定义方式：

RGB 十进制值：QColor(255, 0, 0) 表示红色
十六进制值：QColor('#FF0000') 也表示红色
RGBA 值：QColor(255, 0, 0, 127) 表示半透明红色

# 创建颜色示例
color1 = QColor(200, 0, 0)  # RGB
color2 = QColor() 
color2.setNamedColor('#d4d4d4')  # 十六进制
color3 = QColor(255, 80, 0, 160)  # RGBA

四、高级绘图工具

4.1 QPen 详解

QPen 用于控制线条的绘制样式，支持多种预定义样式和自定义样式。

常用笔触样式：

Qt.PenStyle.SolidLine：实线
Qt.PenStyle.DashLine：虚线
Qt.PenStyle.DotLine：点线
Qt.PenStyle.DashDotLine：点划线
Qt.PenStyle.CustomDashLine：自定义样式

# 自定义笔触示例
pen = QPen(Qt.GlobalColor.black, 2)  # 黑色，2像素宽
pen.setStyle(Qt.PenStyle.CustomDashLine)
pen.setDashPattern([1, 4, 5, 4])  # 1px线，4px空白，5px线，4px空白

4.2 QBrush 详解

QBrush 用于填充形状的内部区域，支持多种填充模式。

常用填充模式：

Qt.BrushStyle.SolidPattern：纯色填充
Qt.BrushStyle.Dense1Pattern 到 Qt.BrushStyle.Dense7Pattern：不同密度的填充
Qt.BrushStyle.HorPattern：水平线填充
Qt.BrushStyle.VerPattern：垂直线填充
Qt.BrushStyle.BDiagPattern：对角线填充

# 使用不同笔刷绘制矩形
brush = QBrush(Qt.BrushStyle.DiagCrossPattern)
painter.setBrush(brush)
painter.drawRect(10, 105, 90, 60)

五、高级图形绘制：贝塞尔曲线

贝塞尔曲线是计算机图形学中重要的曲线表示方法，PyQt6 通过 QPainterPath 类支持贝塞尔曲线的绘制。

def drawBezierCurve(self, painter):
    path = QPainterPath()
    path.moveTo(30, 30)  # 起点
    path.cubicTo(30, 30, 200, 350, 350, 30)  # 控制点和终点
    painter.drawPath(path)

参数说明：