PyQt5绘图系统详解：从基础文本到贝塞尔曲线

最新推荐文章于 2025-06-11 09:03:05 发布

晏闻田Solitary

最新推荐文章于 2025-06-11 09:03:05 发布

阅读量407

点赞数 5

本文链接：https://blog.csdn.net/gitblog_00240/article/details/148575479

版权

PyQt5绘图系统详解：从基础文本到贝塞尔曲线

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

前言

PyQt5作为Python中强大的GUI开发框架，其绘图系统提供了丰富的功能来创建自定义图形界面元素。本文将深入探讨PyQt5的绘图系统，帮助开发者掌握从基础文本绘制到复杂曲线绘制的各项技术。

PyQt5绘图基础

PyQt5的绘图系统基于QPainter类，这是一个低级绘图接口，能够渲染矢量图形、位图图像和文本。绘图操作通常在组件的paintEvent()方法中完成，所有绘图代码需要放置在QPainter对象的begin()和end()方法之间。

文本绘制示例

让我们从一个简单的文本绘制示例开始：

import sys
from PyQt5.QtWidgets import QWidget, QApplication
from PyQt5.QtGui import QPainter, QColor, QFont
from PyQt5.QtCore import Qt

class TextDrawingExample(QWidget):
    def __init__(self):
        super().__init__()
        self.text = "示例文本\n第二行"
        self.initUI()

    def initUI(self):      
        self.setGeometry(300, 300, 280, 170)
        self.setWindowTitle('文本绘制示例')
        self.show()

    def paintEvent(self, event):
        painter = QPainter()
        painter.begin(self)
        self.drawText(event, painter)
        painter.end()

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

if __name__ == '__main__':
    app = QApplication(sys.argv)
    ex = TextDrawingExample()
    sys.exit(app.exec_())

关键点解析：

paintEvent是绘图的核心方法，系统会在需要重绘时自动调用
QPainter对象必须在begin()和end()之间使用
drawText()方法接受绘制区域、对齐方式和文本内容三个主要参数

基本图形绘制

点绘制

点是最基础的图形元素，PyQt5提供了简单的方法来绘制点：

from PyQt5.QtCore import Qt
import random

class PointDrawingExample(QWidget):
    # ... 初始化代码省略 ...
    
    def drawPoints(self, painter):
        painter.setPen(Qt.red)  # 设置点的颜色为红色
        size = self.size()
        
        for _ in range(1000):
            x = random.randint(1, size.width()-1)
            y = random.randint(1, size.height()-1)
            painter.drawPoint(x, y)  # 绘制单个点

技术细节：

使用setPen()设置点的颜色
drawPoint()方法接受x,y坐标参数
窗口大小变化时会自动触发重绘

矩形与颜色

PyQt5支持多种颜色定义方式和图形填充：

from PyQt5.QtGui import QColor, QBrush

class ColorExample(QWidget):
    # ... 初始化代码省略 ...
    
    def drawRectangles(self, painter):
        # 使用16进制颜色定义
        painter.setPen(QColor('#d4d4d4'))
        
        # 填充红色矩形
        painter.setBrush(QColor(200, 0, 0))
        painter.drawRect(10, 15, 90, 60)
        
        # 半透明橙色矩形
        painter.setBrush(QColor(255, 80, 0, 160))
        painter.drawRect(130, 15, 90, 60)

颜色系统说明：

RGB颜色：QColor(红,绿,蓝)，各分量0-255
RGBA颜色：增加透明度分量(0-255)
16进制颜色：QColor('#rrggbb')格式
预定义颜色：如Qt.red, Qt.blue等

高级绘图工具

QPen详解

QPen控制线条的绘制样式，支持多种线型：

from PyQt5.QtGui import QPen

class PenStyleExample(QWidget):
    # ... 初始化代码省略 ...
    
    def drawLines(self, painter):
        # 实线
        pen = QPen(Qt.black, 2, Qt.SolidLine)
        painter.setPen(pen)
        painter.drawLine(20, 40, 250, 40)
        
        # 虚线
        pen.setStyle(Qt.DashLine)
        painter.setPen(pen)
        painter.drawLine(20, 80, 250, 80)
        
        # 自定义虚线样式
        pen.setStyle(Qt.CustomDashLine)
        pen.setDashPattern([1, 4, 5, 4])  # 1像素线，4像素空，5像素线，4像素空
        painter.setPen(pen)
        painter.drawLine(20, 240, 250, 240)

线型选项：

Qt.SolidLine - 实线
Qt.DashLine - 虚线
Qt.DotLine - 点线
Qt.DashDotLine - 点划线
Qt.DashDotDotLine - 双点划线
Qt.CustomDashLine - 自定义样式

QBrush填充模式

QBrush定义了图形的填充样式：

from PyQt5.QtGui import QBrush

class BrushExample(QWidget):
    # ... 初始化代码省略 ...
    
    def drawBrushes(self, painter):
        # 实心填充
        brush = QBrush(Qt.SolidPattern)
        painter.setBrush(brush)
        painter.drawRect(10, 15, 90, 60)
        
        # 水平线填充
        brush.setStyle(Qt.HorPattern)
        painter.setBrush(brush)
        painter.drawRect(10, 195, 90, 60)
        
        # 对角线填充
        brush.setStyle(Qt.BDiagPattern)
        painter.setBrush(brush)
        painter.drawRect(250, 195, 90, 60)

常见填充模式：

Qt.SolidPattern - 实心填充
Qt.Dense1Pattern~Qt.Dense7Pattern - 密度递增的填充
Qt.HorPattern - 水平线
Qt.VerPattern - 垂直线
Qt.CrossPattern - 十字线
Qt.DiagCrossPattern - 对角十字线

贝塞尔曲线绘制

贝塞尔曲线是矢量图形中的重要元素，PyQt5通过QPainterPath实现：

from PyQt5.QtGui import QPainterPath

class BezierCurveExample(QWidget):
    # ... 初始化代码省略 ...
    
    def drawBezierCurve(self, painter):
        path = QPainterPath()
        path.moveTo(30, 30)  # 起点
        # 三次贝塞尔曲线：起点、控制点1、控制点2、终点
        path.cubicTo(30, 30, 200, 350, 350, 30)
        
        painter.drawPath(path)

贝塞尔曲线要点：