PyGame是SDL多媒体库的Python包装器模块。它包含python函数和类，允许您使用SDL对播放cdroms、音频和视频输出以及键盘、鼠标和操纵杆输入的支持。

• 自述

  关于游戏的基本信息：它是什么，涉及到谁，在哪里找到它。

• 安装

  在多个平台上编译游戏所需的步骤。还可以帮助您为系统查找和安装预构建的二进制文件。

• 文件路径函数参数

  游戏如何处理文件系统路径。

• LGPL许可证

  这是许可证下的玩牌游戏。它提供了用开源软件和商业软件发布游戏的功能。一般情况下，如果游戏没有改变，它可以与任何类型的程序一起使用。

• 游戏导论

  游戏基础介绍。这是为Python的用户编写的，并出现在Py杂志的第二卷中。

• 导入和初始化

导入和初始化游戏的开始步骤。游戏包由几个模块组成。有些模块并不包括在所有平台上。

• 如何移动图像？

一个基础教程，涵盖了2D计算机动画背后的概念。有关绘制和清除对象以使其显示为动画的信息。

• 黑猩猩教程，逐行

游戏的例子包括一个简单的程序，有一个互动的拳头和一个黑猩猩。这是受21世纪初令人讨厌的闪光旗帜的启发。本教程将检查示例中使用的每一行代码。

• 雪碧模块游戏攻略

  PyGame包括一个更高级别的精灵模块，以帮助组织游戏。sprite模块包括几个类，它们帮助管理几乎所有游戏类型中的细节。雪碧类比常规的游戏模块要先进一些，需要更多的理解才能正确使用。

• 苏法雷游戏攻略

  PyGames使用NumPypython模块对图像进行有效的每个像素效果。使用表面阵列是一个高级功能，允许自定义效果和过滤器。这还研究了pyGames示例arraydemo.py的一些简单效果。

• 相机模块游戏攻略

  PYGAME，在1.9岁时，有一个相机模块，允许你捕捉图像，观看实时流，并做一些基本的计算机视觉。本教程涵盖这些用例。

• 新手指南

  列出了十三个有用的小窍门，让人们可以轻松地使用游戏。

• 制作游戏教程

  一个大型教程，涵盖创建整个游戏所需的更大主题。

• 显示模式

  为屏幕获取一个显示面。

1、pygame.cdrom 访问光驱

cdrom模块管理计算机上的CD和DVD驱动器。它还可以控制音频CD的播放。在执行任何操作之前，需要先初始化此模块。CD您创建的每个对象都代表一个cdrom驱动器，并且在执行大多数操作之前还必须单独进行初始化。

用于音频CDROM控制的游戏模块

类来管理CDROM驱动器。

CD(Id)->CD

2、pygame.cursors 加载光标

该模块包括几个标准游标。该pygame.mouse.set_cursor() 函数带有几个参数。所有这些参数都存储在一个元组中，您可以这样调用：

>>> pygame.mouse.set_cursor(*pygame.cursors.arrow)

该模块还包含一些作为格式化字符串的游标。您需要pygame.cursors.compile()先将它们传递给功能，然后才能使用它们。示例调用如下所示：

>>> cursor = pygame.cursors.compile(pygame.cursors.textmarker_strings)
>>> pygame.mouse.set_cursor(*cursor)

以下变量是可用作光标的光标位图：

• pygame.cursors.arrow
• pygame.cursors.diamond
• pygame.cursors.broken_x
• pygame.cursors.tri_left
• pygame.cursors.tri_right

可以使用以下字符串将其转换为光标位图 pygame.cursors.compile()：

• pygame.cursors.thickarrow_strings
• pygame.cursors.sizer_x_strings
• pygame.cursors.sizer_y_strings
• pygame.cursors.sizer_xy_strings

游标资源的游戏模块

3、pygame.display 访问显示设备

该模块提供对pygame显示的控制。Pygame具有单个显示Surface，该Surface可以包含在窗口中，也可以全屏运行。创建显示后，将其视为常规Surface。更改不会立即显示在屏幕上；您必须选择两个翻转功能之一来更新实际显示。

显示的原点（x = 0和y = 0）在屏幕的左上方。两个轴都朝着屏幕的右下角正向增加。

游戏模块控制显示窗口和屏幕

4、pygame.draw，pygame.gfxdraw 绘制图像

在表面上绘制几个简单的形状。这些功能可用于渲染到任何格式的表面。渲染到硬件表面将比常规软件表面慢。

大多数函数采用width参数来表示形状边缘周围的笔触大小（厚度）。如果宽度为0，则将填充形状（实心）。

所有绘图功能均会遵守曲面的裁剪区域，并且将约束到该区域。该函数返回一个矩形，该矩形代表更改后的像素的边界区域。该边界矩形是包围受影响区域的“最小”边界框。

注意：pygame.gfxdraw在以后的pygame版本中可能会更改或消失。如果使用此选项，则您的代码可能会在下一个pygame版本中中断。

pygame软件包在加载时不会自动导入gfxdraw，因此必须显式导入才能使用。

import pygame
import pygame.gfxdraw

图形绘制游戏模块

图形绘制游戏模块

5、pygame.event 管理事件

事件队列对其可容纳的事件数有上限（标准SDL 1.2为128）。当队列已满时，新事件将被静默删除。为了防止丢失事件，尤其是表示发出退出命令的输入事件，您的程序必须定期检查事件并进行处理。为了加快队列处理速度，可以pygame.event.set_blocked()控制队列中允许哪些事件，以限制将哪些事件放入队列。

要获取各种输入设备的状态，您可以放弃事件队列，并使用其相应的模块直接访问输入设备： pygame.mousepygame模块与鼠标一起使用，pygame.keypygame模块与键盘一起使用，以及pygame.joystickPygame模块与操纵杆进行交互，游戏手柄和轨迹球。。如果使用此方法，请记住pygame需要与系统窗口管理器和平台的其他部分进行某种形式的通信。为了使pygame与系统保持同步，您将需要在pygame.event.pump()内部调用pygame事件处理程序以使所有内容保持最新。通常，每个游戏循环应调用一次。注意：在初始化设备之前，操纵杆不会发送任何事件。

事件队列包含pygame.event.EventType用于表示事件事件对象的pygame对象。有多种方法可以访问排队的事件，从简单地检查事件的存在到直接将它们从堆栈中获取。事件队列还提供了一些简单的筛选，它可以通过阻止队列中的某些事件类型来稍微提高性能。使用 pygame.event.set_allowed()控制队列pygame.event.set_blocked()上允许哪些事件并控制队列上允许哪些事件来更改此过滤。默认情况下，所有事件类型都可以放在队列中。

用于与事件和队列交互的游戏模块

6、pygame.font 用于加载和呈现字体

字体模块允许将TrueType字体呈现到新的Surface对象中。它接受任何UCS-2字符（“ u0001”至“ uFFFF”）。该模块是可选的，并且需要SDL_ttf作为依赖项。 在尝试使用pygame.fontpygame模块之前，应该测试该模块是否可用并进行了初始化。

使用字体完成的大多数工作都是通过使用实际的Font对象完成的。模块本身仅具有用于初始化模块和使用创建字体对象的例程pygame.font.Font()。

您可以使用该pygame.font.SysFont() 功能从系统加载字体。还有一些其他功能可帮助您查找系统字体。

用于加载和呈现字体的游戏模块

7、pygame.image 加载和存储图片

图像模块是pygame的必需依赖项，但仅可选地支持任何扩展文件格式。默认情况下，它只能加载未压缩的 BMP图像。当构建具有完整图像支持的pygame.image.load() 功能时，该功能可以支持以下格式。

• JPG
• PNG
• GIF （非动画）
• BMP
• PCX
• TGA （未压缩）
• TIF
• LBM（和PBM）
• PBM（和PGM，PPM）
• XPM

保存图像仅支持有限的一组格式。您可以保存为以下格式。

• BMP
• TGA
• PNG
• JPEG

用于图像传输的游戏模块

8、pygame.joystick 用于与操纵杆，游戏手柄和轨迹球进行交互

操纵杆模块管理计算机上的操纵杆设备。游戏杆设备包括轨迹球和视频游戏风格的游戏手柄，该模块允许使用多个按钮和“帽子”。计算机可以一次管理多个操纵杆。

游戏杆类的每个实例代表一个插入计算机的游戏设备。如果游戏板上有多个操纵杆，则操纵杆对象实际上可以代表该单个游戏设备上的多个操纵杆。

为了快速初始化操纵杆模块并获取操纵杆实例列表，请使用以下代码：

pygame.joystick.init()
joysticks = [pygame.joystick.Joystick(x) for x in range(pygame.joystick.get_count())]

操纵杆将生成以下事件类型

JOYAXISMOTION JOYBALLMOTION JOYBUTTONDOWN JOYBUTTONUP JOYHATMOTION

为了使某些方法正常工作，需要频繁地抽取事件队列。因此，请定期调用pygame.event.get，pygame.event.wait或pygame.event.pump之一。

游戏模块，用于与操纵杆、游戏垫和跟踪球进行交互。

9、pygame.key 读取键盘按键

此模块包含用于处理键盘的功能。

在pygame.event与事件和队列交互pygame的模块队列中获得pygame.KEYDOWN和pygame.KEYUP 当按下和释放键盘按钮事件。这两个事件都有 key和mod属性。

• key：一个整数ID，代表键盘上的每个键
• mod： 事件发生时处于按下状态的所有修改键的位掩码

该pygame.KEYDOWN事件具有其他属性unicode和 scancode。

• unicode：一个字符串，即输入的完全翻译后的字符，其中考虑了shift和撰写键
• scancode：特定于平台的键代码，可能因键盘而异，但对于选择诸如多媒体键之类的奇怪键非常有用

游戏模块与键盘一起工作

10、pygame.mixer 声音

此模块包含用于加载声音对象和控制播放的类。混合器模块是可选的，取决于SDL_mixer。您的程序应在使用前测试pygame.mixer用于加载和播放声音的pygame模块是否可用并已初始化。

混音器模块的声道数量有限，无法播放声音。通常程序会告诉pygame开始播放音频，然后它会自动选择一个可用频道。默认值为8个并发通道，但是复杂的程序可以更精确地控制通道数量及其使用。

所有声音播放都混合在后台线程中。当您开始播放声音对象时，它将在声音继续播放时立即返回。单个声音对象也可以多次主动播放。

混音器还具有特殊的流媒体频道。这用于音乐播放，可通过pygame.mixer.musicpygame模块进行访问以控制流音频模块。

混合器模块必须像其他pygame模块一样被初始化，但是它有一些额外的条件。该pygame.mixer.init()函数采用几个可选参数来控制播放速率和样本大小。Pygame将默认设置为合理的值，但是pygame无法执行声音重采样，因此应将混音器初始化为与音频资源的值匹配。

用于控制流音频的游戏模块

11、pygame.mouse 鼠标

鼠标功能可用于获取鼠标设备的当前状态。这些功能还可以更改鼠标的系统光标。

设置显示模式后，事件队列将开始接收鼠标事件。按下和释放鼠标按钮时会生成pygame.MOUSEBUTTONDOWN和 pygame.MOUSEBUTTONUP事件。这些事件包含一个按钮属性，表示按下哪个按钮。鼠标滚轮滚动时将生成pygame.MOUSEBUTTONDOWN和 pygame.MOUSEBUTTONUP事件。滚轮向上滚动时，按钮设置为4；滚轮向下滚动时，按钮设置为5。每当鼠标移动时，都会生成一个pygame.MOUSEMOTION事件。鼠标的移动分为小而准确的运动事件。当鼠标移动时，许多运动事件将被放置在队列中。无法从事件队列中正确清除鼠标动作事件是事件队列填满的主要原因。

如果隐藏了鼠标光标，并且输入被捕获到当前显示，则鼠标将进入虚拟输入模式，在该模式下，鼠标的相对移动将永远不会因屏幕的边界而停止。查看功能 pygame.mouse.set_visible()并pygame.event.set_grab()进行配置。

游戏模块与鼠标一起工作

12、pygame.movie 播放视频

要播放视频中的音乐，pygame.movie模块需要对音频接口的完全控制，不能初始化mixer模块。因此要这样完成初始化

pygame.init()
pygame.mixer.quit()
或者只初始化 pygame.display.init()
movie = pygame.movie.Movie('filename') 指定文件名载入视频。视频的格式可以为mpeg1。视频文件不会马上全部载入内存，而是在播放的时候一点一点的载入内存。
movie.set_display(pygame.display.set_mode((640,480))) 指定播放的surface。
movie.set_volume(value) 指定播放的音量。音量的值value的取值范围为0.0到1.0。
movie.play() 播放视频。这个函数会立即返回，视频在后台播放。这个函数可以带一个参数loops，指定重复次数。 正在播放的视频可以用
movie.stop() 停止播放。
movie.pause() 暂停播放。
movie.skip(seconds) 使视频前进seconds秒钟。
NOTE：在某些XWindow下，可能需要配置环境变量： export SDL_VIDEO_YUV_HWACCEL=0

13、pygame.music 播放音频

音乐模块与pygame.mixerpygame模块紧密相关，用于加载和播放声音。使用音乐模块控制混音器中音乐的播放。

音乐播放和常规声音播放之间的区别在于，音乐是流式传输的，永远不会一次全部加载。混音器系统一次仅支持一个音乐流。

请注意，MP3支持有限。在某些系统上，不支持的格式可能会使程序崩溃e.g。Debian Linux。考虑OGG改为使用。

14、pygame.overlay 访问高级视频叠加

叠加层对象提供了对访问硬件视频叠加层的支持。视频叠加层不使用标准RGB像素格式，并且可以使用多种分辨率的数据来创建单个图像。

Overlay对象表示对显示硬件的较低级别访问。要使用该对象，您必须了解视频覆盖的技术细节。

叠加格式确定使用的像素数据的类型。并非所有硬件都支持所有类型的覆盖格式。以下是可用格式类型的列表：

YV12_OVERLAY, IYUV_OVERLAY, YUY2_OVERLAY, UYVY_OVERLAY, YVYU_OVERLAY

width和height参数控制覆盖图像数据的大小。覆盖图像可以以任何尺寸显示，而不仅仅是覆盖分辨率。

覆盖对象始终可见，并始终显示在常规显示内容的上方。

15、pygame.rect 管理矩形区域

PyGames使用RECT对象来存储和操作矩形区域。可以从左边、顶部、宽度和高度值的组合创建RECT。还可以从已经是RECT的python对象或具有名为“rect”的属性创建Rect。

任何需要rect参数的pyGames函数也会接受这些值中的任何一个来构造RECT。这样就可以更容易地动态创建Rect作为函数的参数。

更改RECT的位置或大小的RECT函数将返回RECT的新副本。原始的RECT没有被修改。有些方法有一个替代的“就地”版本，它只返回原来的RECT。这些“就地”方法用“IP”后缀表示。

RECT对象具有多个虚拟属性，可用于移动和对齐RECT：

x,y
top, left, bottom, right
topleft, bottomleft, topright, bottomright
midtop, midleft, midbottom, midright
center, centerx, centery
size, width, height
w,h

所有这些属性都可以分配给：

rect1.right = 10
rect2.center = (20,30)

分配给大小、宽度或高度会改变矩形的尺寸；所有其他赋值都会移动该矩形而不调整它的大小。注意，有些属性是整数，而另一些属性是整数对。

如果RECT具有非零宽度或高度，它将返回True进行非零测试。有些方法返回0大小的RECT来表示无效的矩形。

rect对象的坐标都是整数。大小值可以编程为负值，但对于大多数操作来说，这些值都是非法的。

其他矩形之间有几个碰撞测试。大多数python容器都可以搜索到与单个RECT的碰撞。

RECT覆盖的区域不包括像素的最右边和最底部的边缘。如果一个RECT的底部边框是另一个RECT的顶部边框(即矩形1.底部=矩形2.top)，则两者在屏幕上完全相遇，但不重叠，并且rect1.colliderect(rect2)返回假。

*新的玩法1.9.2：*RECT类可以被子类化。方法，例如copy()和move()将识别这一点并返回子类的实例。但是，子类的__init__()方法不被调用，并且__new__()假设没有争论。因此，如果需要复制任何额外的属性，则应该重写这些方法。

用于存储直角坐标的吡咯对象

直角(左，顶，宽，高)->正向

(左，上)，(宽，高)->

重排(宾语)->重述

16、pygame.sndarray 操作声音数据

函数在NumPy数组和声音对象之间进行转换。只有当游戏可以使用外部NumPy包时，此模块才可用。

声音数据是由每秒数千个样本组成的，每个样本都是特定时刻波的振幅。例如，在22 kHz格式中，阵列的单元号5是5/22000秒后的波幅。

每个示例都是8位或16位整数，这取决于数据格式。一个立体声文件每个样本有两个值，而一个单一声音文件只有一个。

用于访问声音样本数据的游戏模块

17、pygame. sprite 操作移动图像

这个模块包含了几个在游戏中使用的简单类。有主Sprite类和几个包含Sprite的Group类。在使用pyGames时，这些类的使用完全是可选的。这些类相当轻量级，只为大多数游戏中常见的代码提供了一个起点。

Sprite类将用作游戏中不同类型对象的基类。还有一个基类只存储精灵。游戏可以创建新类型的Group类，这些类可以对它们包含的特别定制的Sprite实例进行操作。

基本Sprite类可以将它包含的Sprite绘制到曲面中。这个Group.draw()方法要求每个Sprite都有一个Surface.image属性和Surface.rect。这个Group.clear()方法需要这些相同的属性，并且可以用来擦除所有带有背景的Sprite。还有更先进的团体：pygame.sprite.RenderUpdates()和pygame.sprite.OrderedUpdates().

最后，该模块包含多个碰撞功能。这些帮助在具有相交边界矩形的多个组中找到精灵。为了找到碰撞，雪碧必须有一个Surface.rect属性分配。

这些组是为高效地去除和添加雪碧而设计的。他们还允许廉价的测试，看看是否一个雪碧已经存在于一个集团。给定的雪碧可以存在于任意数量的组中。游戏可以使用一些组来控制对象的呈现，并使用一组完全独立的组来控制交互或玩家的移动。与其向派生的Sprite类添加类型属性或bools，不如考虑将Sprite保留在有组织的组中。这将允许更容易地查找稍后的游戏。

精灵和组管理它们与add()和remove()方法。这些方法可以接受一个或多个成员资格目标。这些类的默认初始化器还接受单个目标或初始成员资格的列表。从组中重复添加和删除相同的雪碧是安全的。

虽然可以设计不从下面的Sprite和抽象组类派生的sprite和group类，但强烈建议在添加Sprite或Group类时扩展它们。

精灵不是线安全的。所以，如果使用线程，请自己锁定它们。

带有基本游戏对象类的游戏模块

18、pygame.surface 管理图像和屏幕

游戏曲面用于表示任何图像。该表面具有固定的分辨率和像素格式。具有8位像素的表面使用调色板映射到24位颜色.

打电话pygame.Surface()用于表示图像的游戏对象若要创建新的图像对象，请执行以下操作。表面将被清除到所有黑色。唯一需要的参数是大小。没有额外的参数，Surface将以与显示Surface最匹配的格式创建。

像素格式可以通过传递位深度或现有曲面来控制。标志参数是图面附加功能的位掩码。您可以传递这些标志的任何组合：

HWSURFACE    creates the image in video memory
SRCALPHA     the pixel format will include a per-pixel alpha

这两个标志只是一个请求，可能不可能对所有的显示和格式。

高级用户可以组合一组具有深度值的位掩码。掩码是一组由4个整数组成的集合，表示像素中的哪些位将代表每种颜色。正常曲面不应要求掩码参数。

曲面可以有许多额外的属性，如alpha平面，彩色键，源矩形裁剪。这些功能主要影响曲面如何被切割到其他表面。Blit例程将尝试在可能的情况下使用硬件加速，否则它们将使用高度优化的软件闪存方法。

游戏中支持三种透明度：彩色键、表面阿尔法和像素阿尔法。表面alpha可以混合色键，但是每像素alpha的图像不能使用其他模式。颜色键透明度使单个颜色值透明。任何与彩色键匹配的像素都不会被绘制。表面α值是改变整个图像透明度的单个值。曲面α为255是不透明的，值为0是完全透明的。

每个像素的alpas是不同的，因为它们存储每个像素的透明度值。这允许最精确的透明度效果，但也是最慢的。每像素阿尔法不能混合表面α和色键。

对于表面的像素访问有支持。硬件表面的像素访问速度慢，不建议使用。可以使用get_at()和set_at()职能。这些方法对于简单的访问是很好的，但是在处理像素时会非常慢。如果您计划做大量像素级的工作，建议使用pygame.PixelArray用于曲面直接像素访问的PYGAME对象，它提供了一个类似于表面视图的数组。对于涉及到的数学操作，请尝试pygame.surfarray使用数组接口访问表面像素数据的pyGames模块模块(它非常快，但需要NumPy)。

任何直接访问曲面像素数据的函数都需要对该曲面进行锁()。lock()和unlock()表面本身没有帮助。但是，如果一个函数多次被调用，那么这个曲面的多重锁定和解锁就会有很多开销。最好在多次调用函数之前手动锁定曲面，然后在完成时解锁。所有需要锁定表面的函数都会在它们的文档中这样说。记住，只有在必要的时候才能把表面锁上。

表面像素以单个数字的形式存储在内部，其中包含所有的颜色编码。使用map_rgb()和unmap_rgb()若要在单个红色、绿色和蓝色值之间转换为该曲面的打包整数，请执行以下操作。

曲面也可以引用其他曲面的部分。这些都是用subsurface()方法。任何一种表面的改变都会影响到另一种表面。

每个曲面都包含一个裁剪区域。默认情况下，剪辑区域覆盖整个曲面。如果更改，所有绘图操作只会影响较小的区域。

用于表示图像的游戏对象

表面((宽度，高度)，标志=0，深度=0，掩膜=无)->表面

表面((宽，高)，旗=0，面)->面

19、pygame.surfarray 管理点阵图像数据

函数来转换游戏表面和阵列之间的像素数据。只有当游戏可以使用外部NumPy包时，此模块才能发挥作用。

每个像素都存储为一个整数值来表示红色、绿色和蓝色。这些8位图像使用的是一个查看颜色图的值。具有较高深度的像素使用位填充过程将三个或四个值放置到一个数字中。

数组由X首先是轴，然后是Y轴心。将像素视为单个整数的数组称为2D数组。该模块还可以将红色、绿色和蓝色的颜色值分离成不同的索引。这些类型的数组称为3D数组，最后一个索引为红色为0，绿色为1，蓝色为2。

使用数组接口访问表面像素数据的pyGames模块

20、pygame.time 管理时间和帧信息

游戏的时间以毫秒为单位(1/1000秒)。大多数平台的时间分辨率限制在10毫秒左右。此分辨率以毫秒为单位，以TIMER_RESOLUTION常量。

用于监测时间的游戏模块

21、pygame.transform 缩放和移动图像

曲面变换是移动像素或调整像素大小的操作。所有这些函数都需要一个曲面来操作，并返回一个新的曲面。

有些转换被认为是破坏性的。这意味着，每次执行它们时，它们都会丢失像素数据。常见的例子是调整大小和旋转。因此，与其继续多次变换图像，不如对原始表面进行再变换。(例如，假设您正在动画一个弹跳弹簧，它扩展并收缩。如果将大小更改逐步应用于前面的图像，则会丢失详细信息。相反，始终从原始图像开始，并且缩放到所需的大小。)

可转换曲面的py对策模块

欢迎关注公众号，原创不易，转载请注明来源哦????