安装
首先我们需要安装pygame，如果已经安装好python和pip的，只需要在命令行工具中执行：
pip install pygame
111.png
- 安装好后我们可以使用import pygame来确认pygame有咩有装成功。如下图所示，这样我们就可以知道pygame是安装成功的啦，且它的版本是1.9.6。
Pygame常用模块
| 模块名 | 功能 |
|---|---|
| pygame.cdrom | 访问光驱 |
| pygame.display | 访问显示设备 |
| pygame.draw | 绘制形状、线和点 |
| pygame.cursors | 加载光标 |
| pygame.event | 管理事件 |
| pygame.font | 使用字体 |
| pygame.image | 加载和存储图片 |
| pygame.joystick | 使用游戏手柄或者类似的东西 |
| pygame.key | 读取键盘按键 |
| pygame.mixer | 声音 |
| pygame.mouse | 鼠标 |
| pygame.movie | 播放视频 |
| pygame.music | 播放音频 |
| pygame.overlay | 访问高级视频叠加 |
| pygame.rect | 管理矩形区域 |
| pygame.scrap | 本地剪贴板访问 |
| pygame.sndarray | 操作声音数据 |
| pygame.sprite | 操作移动图像 |
| pygame.surface | 管理图像和屏幕 |
| pygame.surfarray | 管理点阵图像数据 |
| pygame.time | 管理时间和帧信息 |
| pygame.transform | 缩放和移动图像 |
cdrom模块的常用方法
| 方法名 | 功能 |
|---|---|
| pygame.cdrom.init() | 初始化 cdrom 模块，该方法将扫描系统内所有的 CD 设备 |
| pygame.cdrom.quit() | 还原 cdrom 模块，在调用该方法后，现存的任何 CD 对象都将停止工作 |
| pygame.cdrom.get_init() | 如果 cdrom 模块初始化完成，则返回 true，否则返回 false |
| pygame.cdrom.get_count() | 返回系统中 cd 驱动器的个数 |
display模块的常用方法
| 方法名 | 功能 |
|---|---|
| pygame.display.init() | 初始化display模块 |
| pygame.display.quit() | 结束display模块 |
| pygame.display.get_init() | 如果display模块已经被初始化，则返回True |
| pygame.display.set_mode() | 初始化一个准备显示的界面 |
| pygame.display.get_surface() | 获取当前的Surface对象 |
| pygame.display.flip() | 更新整个待显示的Surface对象到屏幕上 |
| pygame.display.update() | 更新部分内容显示到屏幕上，如果没有参数，则与flip功能相同(上一条) |
draw绘图
| 方法名 | 功能 |
|---|---|
| pygame.draw.rect(surface,color,Rect,width=0) | 绘制一个矩形框 |
| pygame.draw.polygon(surface,color,pointlist,width=0) | 绘制一个多边形 |
| pygame.draw.circle(surface,color,pos,radius,width=0) | 绘制一个圆 |
| pygame.draw.ellipse(surface,color,Rect,width=0) | 绘制一个椭圆 |
| pygame.draw.arc(surface,color,Rect,start_angle,stop_angle,width=1) | 绘制一条弧线 |
| pygame.draw.line(surface,color,start_pos,end_pos,width=1) | 绘制一条线段 |
| pygame.draw.lines(surface,color,closed,pointlist,width=1) | 绘制一条折线 |
| pygame.draw.aaline(surface,color,start_pos,end_pos,width=1) | 绘制一根平滑的线 |
| pygame.draw.aalines(surface,color,closed,pointlist,width=1) | 一系列平滑的线 |
cursors加载光标
| 方法名 | 功能 |
|---|---|
| pygame.cursors.compile() | 由纯字符串创建二进制光标数据 |
| pygame.cursors.load_xbm() | 由一个xbm 文件载入光标数据 |
event事件
| 方法名 | 功能 |
|---|---|
| pygame.event.get() | 获取事件的返回值，使用event.type进行区分 |
| pygame.event.wait() | 等待发生一个事件才会继续下去 |
| pygame.event.poll() | 会根据现在的情形返回一个真实的事件 |
| pygame.event.set_blocked(事件名) | 过滤 |
| pygame.event.set_allowed() | 允许事件 |
绘制文字
pygame.font.Font(filename, size)
返回一个特定字体对象，可使用该特定字体去定义文本
- filename：字体文件的文件名。如果file参数设置为None则默认采用系统自带字体，如果自带字体文件无法打开就会报错。
- size：字体的高height，单位为像素；
pygame.font.Font.render(text, antialias, color, background=None)
返回一个surface对象（字体的渲染成的图像）
- text：要显示的文字；
- antialias： 为True时文本图像显示更光滑，为False时文本图像显示有锯齿状；
- color：字体颜色；
- background：背景颜色（可选参数），默认为小黑屏；
image图像
| 方法名 | 功能 |
|---|---|
| pygame.image.load() | 从文件加载新图片 |
| pygame.image.save() | 将图像保存到磁盘上 |
| pygame.image.get_extended() | 检测是否支持载入扩展的图像格式 |
| pygame.image.tostring() | 将图像转换为字符串描述 |
| pygame.image.fromstring() | 将字符串描述转换为图像 |
| pygame.image.frombuffer() | 创建一个与字符串描述共享数据的 Surface 对象 |
mouse鼠标
| 方法名 | 功能 |
|---|---|
| pygame.mouse.get_pressed() | 获取鼠标按钮的状态 |
| pygame.mouse.get_pos() | 获取鼠标光标位置 |
| pygame.mouse.get_rel() | 获取鼠标移动的数量 |
| pygame.mouse.set_pos() | 设置鼠标光标位置 |
| pygame.mouse.set_visible() | 隐藏或显示鼠标光标 |
| pygame.mouse.get_focused() | 检查显示是否接收了鼠标输入 |
| pygame.mouse.set_cursor() | 为系统鼠标光标设置图像 |
mixer播放音频
| 方法名 | 功能 |
|---|---|
| pygame.mixer.music.load() | 载入一个音乐文件用于播放 |
| pygame.mixer.music.play() | 开始播放音乐流 |
| pygame.mixer.music.rewind() | 重新开始播放音乐 |
| pygame.mixer.music.stop() | 结束音乐播放 |
| pygame.mixer.music.pause() | 暂停音乐播放 |
| pygame.mixer.music.unpause() | 恢复音乐播放 |
| pygame.mixer.music.fadeout() | 淡出的效果结束音乐播放 |
| pygame.mixer.music.set_volume() | 设置音量 |
| pygame.mixer.music.get_volume() | 获取音量 |
| pygame.mixer.music.get_busy() | 检查是否正在播放音乐 |
| pygame.mixer.music.set_pos() | 设置播放的位置 |
| pygame.mixer.music.get_pos() | 获取播放的位置 |
| pygame.mixer.music.queue() | 将一个音乐文件放入队列中，并排在当前播放的音乐之后 |
| pygame.mixer.music.set_endevent() | 当播放结束时发出一个事件 |
| pygame.mixer.music.get_endevent() | 获取播放结束时发送的事件 |
Surface对象的常用方法
| 方法名 | 功能 |
|---|---|
| pygame.Surface.blit() | 将一个图像画到另一个图像上 |
| pygame.Surface.convert() | 转换图像的像素格式 |
| pygame.Surface.convert_alpha() | 转化图像的像素格式，包含alpha通道的转换 |
| pygame.Surface.fill() | 使用颜色填充Surface |
| pygame.Surface.get_rect() | 获取Surface的矩形区域 |
time时间
| 方法名 | 功能 |
|---|---|
| pygame.time.get_ticks() | 获取以毫秒为单位的时间 |
| pygame.time.wait() | 暂停程序一段时间 |
| pygame.time.delay() | 暂停程序一段时间 |
| pygame.time.set_timer() | 在事件队列上重复创建一个事件 |
| pygame.time.Clock() | 创建一个对象来帮助跟踪时间 |
transform缩放和移动图像
| 方法名 | 功能 |
|---|---|
| pygame.transform.flip | 垂直和水平翻转 |
| pygame.transform.scale | 调整大小到新的分辨率 |
| pygame.transform.rotate | 旋转图像 |
| pygame.transform.rotozoom | 过滤的比例和旋转 |
| pygame.transform.scale2x | 专业图像倍增器 |
| pygame.transform.smoothscale | 将表面平滑地缩放到任意大小 |
| pygame.transform.chop | 获取内部区域已删除的图像副本 |
| pygame.transform.laplacian | 找到表面中的边缘 |
| pygame.transform.average_surfaces | 从许多表面找到平均表面 |
| pygame.transform.average_color | 找到曲面的平均颜色 |
| pygame.transform.threshold | 查找表面中的哪些像素和多少像素在'search_color'或'search_surf'的阈值内 |
Pygame里常用的事件
| 事件 | 产生途径 | 参数 |
|---|---|---|
| QUIT | 用户按下关闭按钮 | none |
| ACTIVEEVENT | Pygame被激活或者隐藏 | gain, state |
| KEYDOWN | 键盘被按下 | unicode, key, mod |
| KEYUP | 键盘被放开 | key, mod |
| MOUSEMOTION | 鼠标移动 | pos, rel, buttons |
| MOUSEBUTTONDOWN | 鼠标按下 | pos, button |
| MOUSEBUTTONUP | 鼠标放开 | pos, button |
| VIDEORESIZE | Pygame窗口缩放 | size, w, h |
