‍

# Header

封存, 未来并不打算继续深入

鉴定为可靠性为5%的11km重坦 –2023.5-6

‍

# 显示

‍

‍

# Surface

元素组件的载体

‍

# 新建图层对象

​Surface=pygame.Surface(size=(width,height),flags,depth)​

• size：表示 Surface 对象的矩形区域大小；如果不设置尺寸，Surface 默认创建一个和主游戏屏幕同样大小的区域。
• flags：功能标志位，有两个可选参数值 HWSURFACE 和 SPCALPHA，前者代表将创建的 Surface 对象存放于显存中，后者表示让图像的每一个像素都包含一个 alpha 通道
• depth：指定像素的颜色深度，默认为自适应模式，由 Pygame 自动调节。

‍

‍

# Screen

‍

# 绘制对象

screen.blit(source, dest, area=None, special_flags = 0)

• source：表示要粘贴的 Surface 对象。
• dest：主窗口中的一个标识的坐标位置，可以接受一个 (x,y) 元组，或者 (x,y,width,height) 元组，也可以是一个 Rect 对象；
• area：接受一个 Rect 对象，默认为 None，如果提供该参数则相当于抠图操作，即在屏幕的指定区域显示想要的内容；
• special_flags：可选参数，它是 Pygame.1.8 版本新增的功能，用于指定对应位置颜色的混合方式，参数值有 BLEND_RGBA_ADD、BLEND_SUB 等。如果不提供该参数的情况下，默认使用 source 的颜色覆盖 screen 的颜色。

‍

# 创建主窗口

​screen = pygame.display.set_mode(size=(),flags=0)​

两个参数常用参数：

• size：元组参数，用来设置主窗口的大小
• flags：功能标志位，表示创建的主窗口样式，比如创建全屏窗口、无边框窗口等，flags 参数值见下表。

‍

# Display

‍

# Rect

rect =pygame.Rect(left,top,width,height) 

创建一个指定位置和大小的矩形区域。Rect 表示的区域必须位于一个 Surface 对象之上，比如游戏的主窗口（screen）, 其左上角为坐标原点

‍

常用属性

x,y  表示矩形距离 x、y 轴的距离
top, left, bottom, right #在坐标系内描述矩形的大小
topleft, bottomleft, topright, bottomright #返回一个描述矩形大小的元组
midtop, midleft, midbottom, midright #返回一个描述矩形大小的元组
center, centerx, centery #(centerx，centery)表示矩形中央坐标(x,y)的值
size, width, height
w,h  #用于描述矩形的width、height

‍

‍

# Draw

在 Surface 对象上绘制一些简单的形状，返回值是一个 Rect 对象，表示实际绘制图形的矩形区域

‍

‍

绘制矩形

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

• surface：指游戏窗口
• color：该参数用于该图形着色；
• rect：绘制图形的位置和尺寸大小；
• width：可选参数，指定边框的宽度，默认为 0，表示填充该矩形区域。

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

‍

绘制多边形

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

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

‍

# 主循环

任务：

• 处理游戏事件
• 更新游戏状态
• 刷新屏幕

‍

刷新界面显示

​pygame.display.flip()​

​pygame.display.update() ​

后者可以根据选定的区域来更新部分内容，而前者则是更新整个待显示的内容。如果后者没有提供区域位置参数时，其作用和 display.flip() 相同。

‍

while True:
    # 循环获取事件，监听事件
    for event in pygame.event.get():
        # 判断用户是否点了关闭按钮
        if event.type == pygame.QUIT:
            pygame.quit()
            sys.exit()  #终止系统
    #更新并绘制屏幕内容
    pygame.display.flip() 

‍

‍

# Event

使用 Pygame 处理事件时，逻辑一般都是相似的。首先是判断事件的类型，然后根据不同的事件操作，执行不同的游戏操作

‍

示例

# 循环获取事件，监听事件状态，使用get()获取事件
for event in pygame.event.get():  # 判断事件类型，用户是否点了"X"关闭按钮
    # pygame.QUIT 指点击右上角窗口的"X"号,点击后，卸载所有pygame模块
    if event.type == pygame.QUIT: 
        pygame.quit()

while True:
    #等待事件发生
    event = pygame.event.wait()
    if event.type == pygame.QUIT:
        exit()
    if event.type == pygame.MOUSEBUTTONDOWN:
        print('鼠标按下',event.pos)

    if event.type == pygame.MOUSEBUTTONUP:
        print('鼠标弹起')

    if event.type == pygame.MOUSEMOTION:
        print('鼠标移动')

        # 键盘事件
    if event.type ==pygame.KEYDOWN:
        # 打印按键的英文字符
        print('键盘按下',chr(event.key))

    if event.type == pygame.KEYUP:
        print('键盘弹起')
    ....

‍

‍

‍

‍

键盘事件

‍

鼠标事件

    event.pos 相对于窗口左上角，鼠标的当前坐标值(x,y)
    event.button 鼠标按下键编号（整数），左键为1，按下滚动轮2、右键为3，向前滚动滑轮4、向后滚动滑轮5

‍

‍

# Time

管理时间和游戏帧数

‍

‍

# FPS

FPS（游戏帧率）影响效果只有在动态图时才能显现出来，不过无论静态图还是动态图，它们的使用规则都是一样的, 通过 Clock() 方法来实现，该对象提供了以下常用方法：

‍

‍

# 素材

‍

‍

# Image

‍

pygame.image.load("图片路径").convert()  

上述方法将被加载的图像作为 Surface 对象来使用。之所以使用 convert(）来转换被加载图片的像素格式，是为了提升 Pygame 对图片的处理速度，该操作能够保证图像的像素格式与图片的显示格式是相同的。

jpg 是不支持透明的，所以我们载入这类图片就用 convert()；而 png 是支持透明的，所以载入就用 convert_alpha()。

‍

# Audio

‍

# 加载音乐
pygame.mixer.music.load("music.mp3")

# 播放音乐
pygame.mixer.music.play(-1)

‍

# Font

‍

‍

# 创建

‍

# font.SysFont()

​pygame.font.SysFont(name, size, bold=False, italic=False)​

‍

name：列表参数值，表示要从系统中加载的字体名称，它会按照列表中的元素顺序依次搜索，如果系统中没有列表中的字体，将使用 Pygame 默认的字体。

‍

如果要显示中文，那么一定要使用中文字体文件，比如“方正粗黑宋简体”，否则会出现文字乱码的现象

‍

# font.Font()

​my_font = pygame.font.Font(filename, size) ​

‍

# 设置

‍

​render(text, antialias, color, background=None)​

• text：要绘制的文本内容
• antialias：布尔值参数，是否是平滑字体（抗锯齿）。
• color：设置字体颜色；
• background：可选参数，默认为 None，该参数用来设置字体的背景颜色。

‍

‍

# 逻辑

‍

# Sprite

Sprite精灵是Pygame中的一个抽象概念，表示游戏中的可移动对象。可以通过继承pygame.sprite.Sprite​​类来创建自己的Sprite对象

‍

通过构建精灵组来统一管理精灵

# 创建精灵组
group = pygame.sprite.Group()
# 向组内添加一个精灵
group.add(sprite_one)

‍

# 碰撞检测

‍

‍

# 高级

‍