PygameZero中文文档 - 1

发表于 更新于 分类于 阅读次数： 阅读次数：

最近在研究PygameZero这个库，用来开发简单游戏的。发现官方文档翻译很少，所以自己胡乱翻译一些，欢迎大家批评指正。

创建窗口

首先，新建一个python空白文件，并保存为 intro.py。

运行一下命令来验证文件可以正常运行并创建一个窗口。

1
pgzrun intro.py

Pygame Zero所有设置都是默认可选，所以一个空的文件也是一个合法可以运行的Pygame Zero脚本！ 好神奇有木有！

单击窗口的关闭按钮或者按 Ctrl+Q ( ⌘-Q on Mac)快捷键退出游戏。如果游戏卡住了， 你可以在终端窗口按 Ctrl+C 快捷键。

绘制窗口的背景

然后，让我们添加一个 draw()函数并且设置窗口的大小。每当需要刷新(重绘)窗口的时候， Pygame Zero就会调用这个函数。

在 intro.py文件添加以下代码：

1
2
3
4
5
WIDTH = 300
HEIGHT = 300

def draw():
    screen.fill((128, 0, 0))

重新运行 pgzrun intro.py 脚本，游戏窗口变成了红色的正方形。

这段代码的作用是啥？

WIDTH 以及 HEIGHT 指明了窗口的宽和高。这段代码把窗口设置为300x300大小。

screen 是内置的代表窗口显示的类. screen类有。很多负责绘制精灵和图形的函数。调用 screen.fill() 方法可以用指定一个颜色元组 (red, green, blue) ，然后用纯色填充窗口。 (128, 0, 0) 是暗红色。试着 改变RGB颜色值，然后查看代码运行效果。

接下来让我们设置一个我们生成动画的精灵。

绘制一个精灵

在我们绘制任意东东之前，我们需要一个外星人alien精灵图片。你可以右键单击这张图，然后选择图片另存为。

alien

这个精灵图片是支持透明色的png图片，非常适合在游戏里使用。这张图片为深色背景设计，所以 只有当你程序运行的时候才能够看到外星人的头盔。

小技巧：

你可以在 kenney.nl 网站找到包括这张图在内的大量免费精灵图片。这张图是 Platformer Art Deluxe pack 的一部分。

只有将图片保存在正确的路径Pygame Zero才能够加载图片。新建一个 images 目录，并且把 图片另存为 alien.png 。文件夹和文件名都是小写，虽然windows不区分文件名的大小写，但是 linux和OSX区分，不然就会陷入一个跨平台兼容性的陷阱。

新建完图片并且另存图片之后，你的项目如下：

1
2
3
4
.
├── images/
│   └── alien.png
└── intro.py

images/ 目录是Pygame Zero查找代码中图片的标准默认位置。

内置类 Actor 用来代表一个你绘制到屏幕的图形。

让我们来定义一个在屏幕上显示的图形，修改 intro.py 文件加载图片：、

1
2
3
4
5
6
7
8
9
alien = Actor('alien')
alien.pos = 100, 56

WIDTH = 500
HEIGHT = alien.height + 20

def draw():
    screen.clear()
    alien.draw()

哇塞，外星人显示在屏幕上了。通过把字符串 'alien' 作为参数传递给 Actor 类，Pygame Zero自动加载了外星人精灵，并且图片具有位置和大小属性。这样我们就可以根据外星人alien的告诉 设置窗口的高度属性 HEIGHT 。 alien.draw() 方法把外星人精灵绘制到屏幕上的当前位置。

1
alien.topright = 0, 10

注意修改topright属性来相对于右上角来修改外星人角色位置的方法。如果外星人角色的右边横坐标为0，外星人角色恰好在屏幕的左侧。然后，我们让外星人角色动起来。在文件底部添加以下代码：

1
2
3
4
def update():
    alien.left += 2
    if alien.left > WIDTH:
        alien.right = 0

Pygame Zero在每一帧都会调用 update()函数。通过在每一帧让外星人移动很小的像素数，外星人就会在屏幕上从左向右滑过。一旦外星人左侧的坐标大于窗口的宽度，就让外星人回到左侧重新向右滑动。

处理鼠标单击事件

接下来，我们让游戏在单击鼠标的时候，做点不一样的东西。为了实现这个目标我们需要定义 一个 on_mouse_down()函数。在文件下方添加以下代码：

1
2
3
4
5
def on_mouse_down(pos):
    if alien.collidepoint(pos):
        print("Eek!")
    else:
        print("You missed me!")

运行游戏，并尝试多次单击外星人角色。

Pygame Zero可以非常聪明的处理你对于函数的调用。如果你定义的函数没有 pos 参数，Pygame 在调用函数的时候就不会传递位置参数。on_mouse_down 方法还有一个 button 按钮参数， 代表单击的鼠标的那个键。因此我们也可以这样定义 on_mouse_down 函数：

1
2
def on_mouse_down():
    print("You clicked!")

或者：

1
2
3
def on_mouse_down(pos, button):
    if button == mouse.LEFT and alien.collidepoint(pos):
        print("Eek!")

声音和图像

接下来我们让外星人表现受伤的造型，保存一下文件：

  • alien_hurt.png -保存图片 alien_hurt.png 到 images 目录。
  • eep.wav - 新建一个叫做 sounds 目录，然后保存 eep.wav 到声音目录。

这时候项目如下图所示:

1
2
3
4
5
6
7
8
.
├── images/
│   └── alien.png
│   └── alien_hurt.png
├── sounds/
│   └── eep.wav
└── intro.py

sounds/ 是Pygame Zero查找声音文件的默认标准目录。 现在让我们用新的图片和声音资源改写 on_mouse_down 函数:

1
2
3
4
5
def on_mouse_down(pos):
    if alien.collidepoint(pos):
        sounds.eep.play()
        alien.image = 'alien_hurt'

当你单击外星人的时候，你会听到一段声音，精灵也会切换到不开心的外星人。

但是这个游戏还有一个bug，那就是被单击后外星人不会回到开心的造型，但是每次单击的时候，声音会播放。接下来让我们改掉这个bug。

时钟函数

如果出了游戏编程之外你对python非常熟悉，你就会知道用 time.sleep() 来插入延时。 你可以像下面这样写代码：

1
2
3
4
5
6
7
def on_mouse_down(pos):
    if alien.collidepoint(pos):
        sounds.eep.play()
        alien.image = 'alien_hurt'
        time.sleep(1)
        alien.image = 'alien'

但是不行的是，在游戏中这样写是不合适的。 time.sleep() 阻塞了所有的活动。我们希望 游戏能够继续运行和播放动画。实际上我们需要从 on_mouse_down 返回，然后让游戏在切换 外星人的造型之后还能够继续运行，让 draw() 和 update() 继续跑。

这可难不倒Pygame Zero，因为我们有一个内置的 Clock ，可以让函数延时执行。

首先，让我们重构代码。我们定一个设置外星人手上和返回普通造型的函数：

1
2
3
4
5
6
7
8
9
10
11
12
13
def on_mouse_down(pos):
    if alien.collidepoint(pos):
        set_alien_hurt()


def set_alien_hurt():
    alien.image = 'alien_hurt'
    sounds.eep.play()


def set_alien_normal():
    alien.image = 'alien'

运行代码跟之前没啥区别 set_alien_normal() 并没有被调用。但是我们可以用时钟类修改 set_alien_hurt() 方法，这样 set_alien_normal() 就可以延迟一段时间被调用了:

1
2
3
4
5
def set_alien_hurt():
    alien.image = 'alien_hurt'
    sounds.eep.play()
    clock.schedule_unique(set_alien_normal, 1.0)

clock.schedule_unique() 可以让 set_alien_normal() 方法在1.0 秒后被调用。 schedule_unique() 同时防止同一函数在快速单击的时候被多次安排调用。

尝试下，你会发现外星人alien在1s后恢复正常形态。尝试快速单击外星人，验证外星人只有在最后单击的1s之后才会恢复。

总结

我们已经学习如何绘制精灵，播放声音，处理输入时间，以及使用内置的时钟类。

也许你继续完善游戏，可以记录游戏的得分，或者让外星人alien移动的更加诡异。