Pygame Zero（pgzrun）详解（简介、使用方法、坐标系、目录结构、语法参数、安装、实例解释）

Pygame Zero（pgzrun）详解

（简介、使用方法、坐标系、目录结构、语法参数、安装、实例解释）

本文目录：

零、时光宝盒

一、Pygame Zero简介

二、Pygame Zero的编写游戏的一般流程

三、Pygame Zero 的坐标系

四、Pygame Zero项目的目录

五、Pygame Zero的语法参数

六、Pygame Zero常用的固定函数

七、Pygame Zero（pgzrun）安装

八、pygame zero实例（飘动的小精灵）

零、时光宝盒

逆境清醒：https://blog.csdn.net/weixin_69553582   

今天是2025年1月1日，

在新的一年里，
愿你心如阳光，明媚不忧伤。
愿你心如月光，恬淡不清冷。
愿你身体健康，快乐无烦恼。
愿你梦里幸福笑，如意直到老。
愿你被时光温柔笼罩，幸运女神偏偏宠着你。
开心、健康、平安、好运、幸福、顺利、有钱、又闲。。。
所求皆如愿，所行皆坦途，
多喜乐，长安宁，愿守护精灵坚定地留在你身旁！！！
愿你的一切美好都会在新的一年发生！！！

虽然我并不算真的认识你们，你们也不知道我是谁，
但这份祝福是发自肺腑，钻石般坚定的！

    逆境清醒
2025.1.1 

此文地址：https://blog.csdn.net/weixin_69553582/article/details/144864025

一、Pygame Zero简介

　　Pygame Zero（pgzrun）是一个用于创建简单的2D游戏的Python库。它是基于Pygame库开发的，旨在简化游戏开发的流程，特别适合初学者和快速原型设计。

　　Pygame Zero是建立在Pygame库之上的，是一个基于Pygame的简化游戏框架，旨在帮助初学者快速入门游戏开发。它封装了Pygame的一些复杂性，使得开发者可以更快速、更容易地开发游戏，而无需处理Pygame的一些底层细节。Pygame Zero是Python编程语言中的一个模块，提供了一种简化的方式来创建游戏和交互式应用程序。

　　对于没有编程经验的人来说。Pygame Zero的目标是通过封装一些常见的游戏开发任务和提供一些简化的API，使游戏开发变得更加容易和有趣。Pygame Zero为初学者提供了一个简单直观的游戏开发环境，使得他们能够快速上手，快速实现自己的游戏创意。同时，对于有经验的开发者，Pygame Zero也提供了一些有用的功能和工具，用于快速原型设计和快速迭代。

Pygame Zero的主要特点：

　　1. 简化的绘图：Pygame Zero提供了一些简单的绘图函数，如绘制矩形、圆圈和文本等。这些函数使绘图变得容易，无需了解复杂的Pygame绘图API。

　　2. 内置的游戏循环：Pygame Zero自动处理游戏循环，包括事件处理、更新游戏状态和绘制场景等。Pygame Zero会自动创建一个主循环来处理游戏逻辑和渲染。你只需要实现一些回调函数，例如，你可以编写名为update()的函数来处理游戏逻辑，每帧都会被调用。另外，你还可以编写名为draw()的函数来处理渲染，也会每帧被调用。

　　3. 简化的输入处理：Pygame Zero处理键盘和鼠标输入，并提供了一些简单的函数来检测按键和鼠标事件。你可以轻松地检测玩家的输入并作出相应的反应。你可以根据需要编写事件处理函数，在用户触发事件时执行相应的操作。

　　4. 物理引擎支持：Pygame Zero集成了物理引擎pymunk，使得处理物理碰撞和运动变得更加容易。你可以创建物理对象，设置其属性，然后让它与其他对象交互。

　　5. 简化的语法：Pygame Zero通过提供一些简化的语法，使得编写游戏代码更加简单易懂。例如，你可以使用Actor()类来创建可移动的游戏对象，使用.pos属性来获取或设置对象的位置，使用.colliderect()函数来检测对象之间的碰撞等。

二、Pygame Zero的编写游戏的一般流程

使用Pygame Zero编写游戏的一般流程是：

1. 安装：可以使用pip命令来安装Pygame Zero库。在命令行中输入pip install pgzero即可安装。

2. 导入Pygame Zero模块：import pgzrun 或者 from pgzrun import * 

3. 初始化：设置游戏窗口的宽度和高度等参数，例如：`WIDTH = 800; HEIGHT = 600`

4. 在draw()函数中绘制游戏场景，例如绘制背景、角色等。

5. 在update()函数中更新游戏状态，例如检测输入、移动角色等。

6. 调用Pygame Zero的主循环函数：pgzrun.go()

三、Pygame Zero 的坐标系

Pygame Zero 的坐标系以左上角为原点 ( 0, 0 )

四、Pygame Zero项目的目录

Pygame Zero项目的目录一般如下:

Pygame Zero项目
│
├──music/
│   └── 音乐文件，支持的格式：MP3 (.mp3)、OGG (.ogg)、WAV (.wav)
│
├── sounds/
│   └── 声音文件，支持的格式：WAV (.wav)、OGG (.ogg)
│
├── images/
│   └── 图片文件，支持的图片格式：.png、.jpg、.gif
│
└── python文件

规定的目录说明：

images/ 图片文件目录：

是Pygame Zero查找代码中图片的标准默认目录。支持的图片格式：.png、.jpg、.gif

sounds/ 声音文件目录：

是 Pygame Zero 查找声音文件的默认标准目录。

声音文件通常是指短时的音频片段，如音效、声效等，

在与程序文件同一根目录下名为sounds的文件夹放下需要的音乐（ WAV (.wav)、OGG (.ogg)格式）,

在程序中用

sounds.音乐名(英文且不带后缀名).play()

sounds.音乐名(英文且不带后缀名).play()

效果：只播放一次此音乐

music/ 音乐文件目录：

是 Pygame Zero 查找音乐文件的默认标准目录。

音乐文件通常是指较长时长的音频剪辑，如歌曲、乐曲等，用于背景音乐。

在与程序文件同一根目录下名为music的文件夹放下您想播放的音乐（MP3 (.mp3)、OGG (.ogg)、WAV (.wav)）

在程序中用

music.play('音乐名不带后缀名')

music.play('音乐名不带后缀名')

效果：一直重复播放此音乐

五、Pygame Zero的语法参数

5.1、设置窗口的标题

在Pgzero中，用TITLE来设置窗口的标题。需要大写。例如：

TITLE = "逆境清醒编程用法示例pgzrun"  # 设置窗口顶部的标题

5.2、设置窗口的大小

Pgzero中，通过两个常量值（WIDTH和HEGIHT，指场景的宽和高）来确定程序运行窗口的大小。例如：

WIDTH = 300
HEIGHT = 300

5.3、创建角色

Pgzero中生成一个游戏角色十分简单，只需一行代码即可。

Actor类是Pgzero库提供的角色类，调用该类的构造方法并传入角色图片和位置便可生成一个角色对象。

<变量> =Actor("str", (x, y))    #生成一个游戏角色，导入一个名为str图片

Actor类的构造方法有两个基本参数：

• 第一个参数是角色的图片文件名，角色图片可以调用的图片格式是.jpg、.png、.gif，调用图片文件时无需扩展名，
• 第二个参数是角色的初始位置坐标。

例如：

alien = Actor("jingling00.png",(100,100))

4、内置对象

Pgzreo提供了很多的内置对象，以便进行各项操作。

screen对象表示您的游戏屏幕。

它可让您轻松地将图像绘制到屏幕上（“blit”它们）。主要用来在程序运行窗口进行绘制图形和图像及文字信息等，在游戏编程中经常会用到screen对象提供的很多的绘制方法。

六、Pygame Zero常用的固定函数

Pygame Zero定义了一些其他固定名称的函数（约定好的函数），用于处理特定的游戏事件或执行其他功能。你可以根据需要在你的代码中实现这些函数，以便响应相应的事件。

以下是一些常用的固定函数名称：

七、pygame zero安装验证：

7.1、首先，必须先安装 pygame

Pip install pygame

7.2、最后，安装pygame zero：

pip install pgzero

7.3、验证

首先，创建一个名为 intro.py的空白python文件

在命令行通过运行

pgzrun intro.py

运行结果：

弹出一个黑色的空白窗口

说明pygame zero安装成功

八、pygame zero实例（飘动的小精灵）

简单例子，一个小精灵在空中飘动。

先看效果图（gif)：

8.1、安装python和相关的库

先安装好python和相关的库（pygame、pygame zero）

Pip install pygame
pip install pgzero

8.2、建立python文件njqx.py

新建立python文件，文件名：njqx.py（你可以换成你喜欢的文件名.py)

8.3、导入库

import pgzrun

8.4、下载保存好素材

准备好素材，保存到指定的目录中，

本例子中，如果你想得到和我一样的效果，

下载我提供的素材（素材版权是我的），

保存图片时所起的名字一定要按我下文中所列出的一样，

同时保存图片的位置也不能改变任何。

 

在njqx.py所在的位置，新建立一个 images 目录，

素材1：

将素材1保存在images目录中，名字为：njqx00_bg.png

素材2：

将素材2保存在images目录中，名字为：njqx00.png

8.5、项目的目录

飘动的小精灵目录结构
│
├── images/
│   └── njqx00_bg.png
│   └── njqx00.png
│
└── njqx.py

8.6、初始化

在njqx.py文件中新增代码如下：

"""
=================================================
@Project ->Adversity Awake python游戏系列
@类别     : pygame->pgzrun
@Author  : 逆境清醒
@Date    : 2025/1/1
@Desc    :https://blog.csdn.net/weixin_69553582
原文链接：https://blog.csdn.net/weixin_69553582/article/details/144864025
=================================================
"""
TITLE = "逆境清醒编程用法示例pgzrun"
jingling = Actor('njqx00')
jingling.pos = 150, 110
WIDTH = 350
HEIGHT = jingling.height + 80

8.7、绘制场景

在njqx.py文件中新增代码如下：

def draw():screen.clear()screen.blit("njqx00_bg.png", (0, 0))  jingling.draw()

8.8、设定更新内容

在njqx.py文件中新增代码如下：

def update():jingling.left += 2if jingling.left > WIDTH:jingling.right = 0

8.9、增加主循环

pgzrun.go()

8.10、运行代码

运行njqx.py

效果如下：

8.11、完整代码

import pgzrun
import time
"""
=================================================
@Project ->Adversity Awake python游戏系列
@类别     : pygame->pgzrun
@Author  : 逆境清醒
@Date    : 2025/1/1
@Desc    :https://blog.csdn.net/weixin_69553582
原文链接：https://blog.csdn.net/weixin_69553582/article/details/144864025
=================================================
"""
TITLE = "逆境清醒编程用法示例pgzrun"
jingling = Actor('njqx00')
jingling.pos = 150, 110
WIDTH = 350
HEIGHT = jingling.height + 80def draw():screen.clear()screen.blit("njqx00_bg.png", (0, 0)) jingling.draw()def update():jingling.left += 2if jingling.left > WIDTH:jingling.right = 0pgzrun.go()

推荐阅读：

逆境清醒

matplotlib 自带绘图样式效果展示速查（28种，全）	PyCharm 社区版（2024.2.3）安装、配置、创建项目	pycharm汉化插件无法使用也无法卸载的解决方法
Three.js实例详解___旋转的精灵女孩(附完整代码和资源)（一）	开源数据科学平台Anaconda简介	最新版本Anaconda 2024.06-1安装设置
立体多层玫瑰绘图源码__玫瑰花python 绘图源码集锦	Python 3D可视化（一）	让你的作品更出色——词云Word Cloud的制作方法（基于python，WordCloud，stylecloud)
python Format()函数的用法___实例详解（一）(全，例多）___各种格式化替换，format对齐打印	用代码写出浪漫__合集（python、matplotlib、Matlab、java绘制爱心、玫瑰花、前端特效玫瑰、爱心）	python爱心源代码集锦（18款）
Python中Print()函数的用法___实例详解(全，例多）	Python函数方法实例详解全集(更新中...)	《 Python List 列表全实例详解系列（一）》__系列总目录、列表概念
用代码过中秋，python海龟月饼你要不要尝一口？	python练习题目录
草莓熊python turtle绘图（风车版）附源代码	​草莓熊python turtle绘图代码（玫瑰花版）附源代码	​草莓熊python绘图（春节版，圣诞倒数雪花版）附源代码
巴斯光年python turtle绘图__附源代码	皮卡丘python turtle海龟绘图（电力球版）附源代码	【中秋月饼系列】2024年立体月饼新鲜出炉----python画月饼（1）附完整代码

逆境清醒

逆境清醒

用代码画万圣节南瓜（python,MATLAB，html css)	CSS3 动画相关属性实例大全	CSS @规则(At-rules)系列详解
​​​​​​​
vue3 项目搭建教程（基于create-vue，vite，Vite + Vue）	圣诞节系列代码专辑（目录)	Markdown 语法详解大全(超级版)
​​​​​​​	​​​​​​​	​​​​​​​
2023年春节祝福第二弹——送你一只守护兔，让它温暖每一个你【html5 css3】画会动的小兔子，炫酷充电，字体特	别具一格，原创唯美浪漫情人节表白专辑，(复制就可用)（html5,css3,svg)表白爱心代码(4套)	SVG实例详解系列（一）(svg概述、位图和矢量图区别（图解）、SVG应用实例）
​​​​​​​	​​​​​​​	​​​​​​​
【程序人生】卡塔尔世界杯元素python海龟绘图（附源代码），世界杯主题前端特效5个（附源码）	HTML+CSS+svg绘制精美彩色闪灯圣诞树，HTML+CSS+Js实时新年时间倒数倒计时(附源代码)	2023春节祝福系列第一弹（上）（放飞祈福孔明灯，祝福大家身体健康）（附完整源代码及资源免费下载）

逆境清醒

逆境清醒

信息系统项目管理师试题	云计算