Pygame Draw绘图函数

Pygame 中提供了一个

模块用来绘制一些简单的图形状，比如矩形、多边形、圆形、直线、弧线等。

模块的常用方法如下表所示：

表格中的函数使用方法大同小异，它们都可以在 Surface 对象上绘制一些简单的形状，返回值是一个 Rect 对象，表示实际绘制图形的矩形区域。上述绘图函数都提供了一个 color 参数，我们可以通过以下三种方式来传递 color 参数值：

• 使用 pygame.color 对象
• RGB 三元组
• RGBA 四元组

下面通对上述一些方法的参数进行详细说明：

1) 绘制矩形

绘制矩形的语法格式如下：

pygame.draw.rect(surface, color, rect, width)

参数说明如下：

• surface：指主游戏窗口，无特殊情况，一般都会绘制在主屏幕上；
• color：该参数用于该图形着色；
• rect：绘制图形的位置和尺寸大小；
• width：可选参数，指定边框的宽度，默认为 0，表示填充该矩形区域。

注意，当 width > 0 时，表示线框的宽度；而 width < 0 时，此时不会绘制任何图形。

2) 绘制多边形

pygame.draw.polygon(surface, color, points, width)

其中 points 一个列表参数，它表示组成多边形顶点的 3 或者多个 (x,y) 坐标，通过元组或者列表来表示这些多边形顶点。其余参数与上述函数相同。

3) 绘制圆形

pygame.circle(surface, color, pos, radius, width=0)

上述参数的含义如下：

• pos：该参数用来指定的圆心位置；
• radius：用来指定圆的半径；

4) 绘制椭圆形

pygame.draw.ellipse(surface, color, Rect, width=0)

绘制椭圆形的过程，其实就是在矩形区域内部（Rect）绘制一个内接椭圆形，其余参数与上述参数意思相同。

5) 绘制圆弧曲线

当需要绘制圆弧的曲线时，使用以下函数，语法格式如下：

pygame.draw.arc(Surface, color, Rect, start_angle, stop_angle, width=1)

与 ellipse 函数相比，该函数多了两个参数：

• start_angle是该段圆弧的起始角度；
• stop_angle是终止角度；

这两个都是用弧度制来表示的，而原点就是矩形 Rect 的中心位置。

6) 绘制直线

Draw 模块提供了两类绘制直线的方法，即是否消除直线的锯齿，并且根据实际情况，我们还可以选择绘制一条或者多条直线。

pygame.draw.line(surface, color, start_pos, end_pos, width=1)

参数说明：

• start_pos 和 end_pos 表示线段的起始位置，此处使用 [x,y] 来表示起始位置；
• width =1 表示直线的宽度，默认为 1。

如果是绘制一条消除锯齿的平滑线，此时则使用 blend = 1 参数，如下所示：

pygame.aaline(surface, color, startpos, endpos, blend=1) 

blend 参数表示通过绘制混合背景的阴影来实现抗锯齿功能。

7) 绘制多条直接

当需要绘制多条直线的时候，我们可以使用以下方法：

pygame.lines(surface, color, closed, pointlist, width=1)

其中  pointlist 与 closed 含义如下：

• pointlist：参数值为列表，包含了一些列点坐标的列表
• closed：布尔值参数，如果设置为 True，表示直线的第一个端点和直线的最后一个端点要首尾相连；

如果绘制抗锯齿直线，使用以下方法：

pygame.draw.aalines(surface, color, closed, pointlist, blend=1)

除了指定了 blend = 1 之外，其余参数含义与上述函数相同。

下面通过一组简单的示例对上述绘图方法进行演示：

import pygame
from math import pi
#初始化
pygame.init()
# 设置主屏幕大小
size = (500, 450)
screen = pygame.display.set_mode(size)
#设置标题
pygame.display.set_caption("C语言中文网")
# 设置一个控制主循环的变量
done = False
#创建时钟对象
clock = pygame.time.Clock()
while not done:
    # 设置游戏的fps
    clock.tick(10)
    for event in pygame.event.get():
        if event.type == pygame.QUIT:
            done = True  # 若检测到关闭窗口，则将done置为True
    # 绘制一条宽度为 3 的红色对角线
    pygame.draw.line(screen, (0, 255, 0), [0, 0], (500, 450), 3)
    # 绘制多条蓝色的直线（连续直线，非抗锯齿），False 表示首尾不相连
    pygame.draw.lines(screen, (0, 0, 255), False, [[0, 80], [50, 90], [200, 80], [220, 30]], 1)
    # 绘制一个灰色的矩形区域，以灰色填充区域
    pygame.draw.rect(screen, (155, 155, 155), (75, 10, 50, 20), 0)
    # 绘制一个线框宽度为2的矩形区域
    pygame.draw.rect(screen, (0, 0, 0), [150, 10, 50, 20],2)
    # 绘制一个椭圆形,其线宽为2
    pygame.draw.ellipse(screen, (255, 0, 0), (225, 10, 50, 20), 2)
    # 绘制一个实心的红色椭圆形
    pygame.draw.ellipse(screen, (255, 0, 0), (300, 10, 50, 20))
    # 绘制一个绿色边框(宽度为2)三角形
    pygame.draw.polygon(screen, (100, 200, 45), [[100, 100], [0, 200], [200, 200]], 2)
    # 绘制一个蓝色实心的圆形，其中[60,250]表示圆心的位置，40为半径，width默认为0
    pygame.draw.circle(screen, (0, 0, 255), [60, 250], 40)
    # 绘制一个圆弧,其中0表示弧线的开始位置，pi/2表示弧线的结束位置，2表示线宽
    pygame.draw.arc(screen, (255, 10, 0), (210, 75, 150, 125), 0, pi / 2, 2)
    # 刷新显示屏幕
    pygame.display.flip()
# 点击关闭，退出pygame程序
pygame.quit()

程序的运行结果如下所示：

图1：Pygame绘图函数用法