pygame 会用这些函数就够了

杨利霞

8 T- ?% v7 n; E5 V* \6 p5 G2 \' @. @pygame 会用这些函数就够了
* L" P! t7 z) E1 A) }8 B2 l, Qpygame 会用这些函数就够了
: x( H' F: n9 v3 X7 r+ V( `( g
" p% i) f2 j0 m  Q借鉴了pygame的官方文档和一些中译版，对于我们实际写代码时较常用的一些函数和方法进行了整理
4 s3 s, u* e$ D5 D- @& `
, l+ X( {; T' J/ b前15个可以说是较为常用的函数，后面的由于不太常用就有所省略。
6 C1 n  J- y, a* R4 M/ m0 s
本文档只是作为参考，具体使用还请参照官方文档。如果整理的哪里有问题还希望大家指正。这里可以移步个人博客
' W3 U2 y4 q( k/ V* X' q
pygame.sprite：基本游戏对象
' ~+ y9 N, y) @; m: xpygame,event：处理事件
pygame.key：键盘按键
9 O1 B8 ~6 u+ n, X: e# Vpygame：顶层模块
pygame.time：时间模块
pygame.diaplay：控制窗口显示
; n+ a" L5 `: kpygame.Rect：图像矩形模块
; Q% C6 l* A$ {) ?+ f/ n+ d, s2 xpygame.Color：颜色模块
pygame.image：图片模块
pygame.Surface：表示图像
' e. A0 O, K+ k/ C, e2 l# G" Lpygame.mixer：声音模块
pygame.draw：绘制图像
7 z. ~' v) ]# R" fpygame.font：字体模块
4 |& Z2 {: Y2 w5 a- S& @pygame.mixer.music：音乐模块
pygame.mouse：鼠标移动
pygame.BufferProxy：缓冲对象
9 E, D+ Q) A( h. e: Fpygame.cdrom：音频光盘
pygame.PixelArray：像素数组
pygame.cursor：鼠标光标
pygame.scrap：剪切板
' R7 M# }9 y" W( f0 ^2 qpygame.andarray：音频采样
( O8 ^4 x; a6 V8 P6 u/ qpygame.transform：改变形态
pygame.tests：测试模块
+ F+ }6 B+ Z- J# ~6 j6 p! Q+ G0 Y  fpygame.freetype：计算机字体
& I9 W8 Q* u3 C  ypygame.joystick：外接设备
pygame.locals：常量定义
- j# o* R* U8 t! y' p* Zpygame.surfarray：访问像素
) Y/ n1 h0 U* D; @. I5 S4 Z% Apygame.Overlay：图像叠加
2 V. c0 a- n- e1. pygame.sprite

& K) `3 g% k' z" \该类是pygame中处理基本游戏对象类的模块
% ~! {  F. m$ k" D/ b4 L
" y) u. s! q/ u, \! Vpygame.sprite.Sprite：可见游戏对象的简单基类
$ V2 R2 t) p8 e2 t- x% Ypygame.sprite.Sprite.update：更新状态
pygame.sprite.Sprite.add：加到组中
+ C; J/ ?" Z  N2 m) G% R0 [9 y+ `2 Jpygame.sprite.Sprite.remove：从组中删除
pygame.sprite.Sprite.kill：从所有组中删除
2 a/ R. J& L0 {pygame.sprite.Sprite.groups：包含此Sprite的组列表
pygame.sprite.DirtySprite：具有更多属性和功能的Sprite的子类
pygame.sprite.Group：保存和管理多个Sprite对象的容器类
pygame.sprite.Group.copy：复制组
; F% ~" B7 p' [) `pygame.sprite.Group.add：添加到该组
pygame.sprite.Group.remove：从组中删除
) s: `% Y0 v7 }! k# Qpygame.sprite.Group.has：检测是否包含
  c+ }6 j" b+ Ppygame.sprite.Group.update：更新状态
- i7 L5 B' [* q* w1 t  |/ dpygame.sprite.Group.draw：绘制图像
; p4 Q# }& r) upygame.sprite.Group.empty：删除所有
; r1 J5 w& }; N& y# Opygame.sprite.collide_rect：使用rects检测两个sprite之间的碰撞
" z* b) d* q6 D* _9 Spygame.sprite.collode_rect_ratio：使用按比例缩放的rects检测碰撞
% k: \# v4 Z2 xpygame.sprite.collide_circle：使用圆来检测碰撞
pygame.sprite.collide_circle_ratio：使用按比例缩放的圆检测
4 t! v5 A, q2 @! W/ @pygame.sprite.collide_mask：使用蒙版检测碰撞
2. pygame.event

2 J4 Q9 t' q; D" R' G5 o# R该类是pygame中处理事件与事件队列的模块

6 ~7 n9 ?1 V# |! [- X: `" l' Q5 f: O) npygame.event.pump：让其内部自动处理事件
pygame.event.get：从队列中获取事件
pygame.event.poll：从队列中获取一个事件
pygame.event.wait：等待并从队列中获取一个事件
) a6 n2 ~9 Y* Npygame.event.peek：检测某个类型事件是否在队列中
9 R3 U1 [* J6 zpygame.event.clear：从队列中删除所有事件
- G8 P* i2 \# h! Qpygame.event.set_allowed：控制哪些事件禁止进入队列
6 [( x$ ^) a8 _& c6 [4 x5 Vpygame.event.set_blocked：控制哪些事件允许进入队列
6 p  }4 ~, c" [8 j1 z: Y6 r: cpygame.event.post：放置一个新事件进入队列
9 m+ }7 w  \; M& Wpygame.event.Event：创建一个新的事件对象
. B( R+ a6 e+ C5 ]) K事件种类：
- A) A5 k: T8 o( zQUIT：退出
KEYDOWN：按下按键
KEYUP：松开按键
MOUSEMOTION：鼠标移动
其他游戏杆、游戏手柄、追踪球事件
/ L; g/ G" }) K1 R: |支持自定义事件
3. pygame.key
* [  K4 I' L  r6 k4 d/ Q
该类是pygame处理与键盘有关的模块

% r1 ?+ \9 ?2 g' p- ?pygame.key.get_focused：窗口获得键盘输入焦点返回True
4 I2 n2 s" y' @5 t: t0 ^pygame.key.get_pressed：获取键盘所有按键的状态
key属性：pygame预定义的键盘上的键位
mod属性：pygame预定义的组合键
4. pygame

: V  T0 }- u8 M; U" b3 y该类为最顶层的模块

pygame.init：初始化导入所有pygame模块
pygame.quit：卸载所有导入的模块
5. pygame.time
3 C/ V2 i. \7 _& q
2 @5 _5 s2 W5 p% w该类是pygame中用于时间管理模块
) \2 r. O' M: Z  Z2 p" |& F' x% g' l  W
1 M( q8 h  v& y- t  Q0 f; [pygame.time.get_ticks：以毫秒为单位获取时间
. s# N5 l1 S+ R8 h4 mpygame.time.wait：暂停程序一段时间
pygame.time.delay：暂停程序一段时间
" i$ x* }! T7 q$ X1 d$ k$ v5 M  Spygame.time.Colck：创建一个对象来帮助或更新时间
. ^" J9 L; I8 B3 z' Mpygame.time.Clock.tick：更新clock对象
6. pygame.display
2 X! [' X; U1 t+ p# \  d, ~
5 w9 Y0 B" v8 ~7 j) g该类是pygame中用于控制窗口和屏幕显示的模块

pygame.display.init：初始化模块
pygame.display.quit：取消初始化
0 Y% Z2 }* A; O/ wpygame.display.get_init：判断是否初始化成功
pygame.display.set_mode：初始化一个准备显示的窗口或者屏幕
pygame.display.set_mode(resolution=(0,0), flags=0, depth=0)
resolution：传入屏幕的长宽，若为 0 则默认当前屏幕分辨率
* D1 M- ^& `$ e( Uflags：控制显示类型 可以多种类型用管道符 ‘ | ’ 组合
pygame.FULLSCREEN 创建一个全屏显示
pygame.DOUBLEBUF 双缓冲模式
pygame.HWSURFACE 硬件加速，仅在FULLSCREEN下可以使用
) P7 G3 q: ~3 s! c4 Ipygame.RESIZABLE 创建一个可调整尺寸的窗口
; P; f/ ^! Y% y) T- g) `$ rpygame.NOFRAME 创建一个没有边框和控制按钮的窗口
depth：深度参数，一般不传值
' r( i: }% y; t) }& [7 Gpygame.display.get_surface：获取当前显示的 Surface 对象
pygame.display.flip：将完整待显示的 Surface 对象更新到屏幕上
pygame.display.update：更新部分软件界面显示
pygame.display.iconify：最小化显示 Surface 对象
- o; p6 h* V2 E' fpygame.display.toggle_fullscreen：切换全屏显示和窗口显示
) M' f3 p1 k+ h) _/ U( zpygame.display.set_icon：更改显示窗口的系统头像
$ ^$ }- [6 |/ J  ppygame.display.set_caption：设置当前窗口标题
2 o1 n# a% ~; W2 `0 _: |pygame.display.get_caption：获取当前窗口标题
8 e! i& m9 [% l% ~* F7. pygame.Rect

' @7 }# g0 L0 q, V7 J/ d: y该类是pygame中直接操作对象外界矩形的模块
6 R+ u& |3 L" }) r3 o8 ~: ^+ P0 A
2 j3 ~' D7 P  z3 I0 Tpygame.Rect：创建矩形对象
1 D' d: n. F% T2 R: O7 tpygame.Rect(left, top, width, height)：根据左上角坐标和长宽创建矩形
pygame.Rect((left, top), (width, height))：根据左上角坐标和长宽创建矩形
( L0 A$ {- m! T该对象具有用来移动和对齐的参数
x, y
, l) s8 U, V" ptop, left, bottom, right
- N1 K% u. o% u6 o0 }0 e6 {7 Qtopleft, bottomleft, topright, bottomright
2 i% W+ m, \6 ]4 e% Z# p( y  Wmidtop, midleft, midbottom, midright
; _& P- x. ^: T$ L% Fcenter, centerx, centery
2 T  e. C  E: ^9 f  |( Zsize, width, height
w,h
pygame.Rect.copy：复制矩形
pygame.Rect.move：移动矩形
pygame.Rect.move(x, y)：传入偏移量
; `5 t7 e. e( U# n1 e7 tpygame.Rect.contains：测试一个矩形是否在另一个矩形内部，传入矩形对象
6 G0 F- e1 R( m2 Wpygame.Rect.collidepoint：测试一个点是否在矩形内
2 R5 x& j, r9 `2 T& x; \- p% ]pygame.Rect.colliderect：测试两个矩形是否重叠
8. pygame.Color
6 `7 j. ^# m' Q9 v6 k+ J
该类是pygame中用于描述颜色的模块

pygame.Color：返回一个颜色
Color(name)：传入名称
Color(r, g, b, a)：传入rgba参数
) L) ^* P" Z7 C/ \/ F5 y. nColor(rgbvalue)：传入rgb参数
pygame.Color.r：获取或设置其红色值
( k5 B. S2 w/ a" cpygame.Color.g：获取或设置其绿色值
2 c8 [7 ?5 t& z! @5 n5 N3 _pygame.Color.b：获取或设置其蓝色值
/ n% g4 G( P( Npygame.Color.a：获取或设置其alpha通道值
pygame.Color.cmy：获取或设置其 cmy (青、洋红和黄) 值
pygame.Color.normalize：返回标准化 RGBA 值
9. pygame.image
2 E5 M& U7 o0 L6 C3 I
该类是pygame中处理图像传输的模块
8 P" h7 @2 f! {0 p* o
pygame.image.load：从文件中加载新图像
传入文件路径和名称
, M9 s( X: M# S9 @$ \/ @支持 JPG、PNG、GIF、BMP、PCX、TGA、TIF、LBM、PBM、XPM格式
pygame.image.save：将图像保存到本地
3 n& j4 S) v, N0 o" p传入 Surface 对象和路径
支持BMP、TGA、PNG、JPEG格式
* o5 F5 w! C. ]8 {8 l& ]5 }& e10. pygame.Surface
: N+ c2 b- ~. Q9 \  V" H
& a, E" B$ z, }8 k' d0 `该类是pygame中用于表示图像的模块

pygame.Surface：创建对象
pygame.Surface((width, height), flags=0, depth=0, masks=None)
7 s' w! i: G$ l9 _/ ~, ^8 l" V6 V1 jpygame.Surface((width, height), flags=0, Surface)
pygame.Surface.blit：将一个图像绘制到另一个上方
pygame.Surface.convert：修改像素格式
5 k% t& }- f8 {5 f* B( ^pygame.Surface.copy：拷贝对象
/ D& j8 d: d; g; }7 T6 H' O% Npygame.Surface.fill：使用纯色填充对象
pygame.Surface.scroll：移动对象
: [3 r1 Y, g& a/ t8 s11. pygame.mixer
; @) f; r+ ], F
3 V4 W9 k$ i5 Y  s) R/ c该类是pygame中用来加载和播放声音的模块，默认有8个声道

pygame.mixer.init：初始化模块
) a* L" H* B7 ]. F1 y9 epygame.mixer.stop：停止播放所有声道
pygame.mixer.pause：暂停播放所有声道
* ]5 ^" Q* @# t  Q- q. ipygame.mixer.unpause：恢复暂停播放所有声道
pygame.mixer.fadeout：停止前淡出所有声音
2 {  Q- Z- K& |" ]传入时间参数，设置淡出时间
& x- t1 G: G9 _, Z12. pygame.draw
" X. F. ]8 R# f4 A1 ^. i& \
  w  N" R2 ?$ h' s该类是pygame中用于绘制图形的模块
% t  M+ t: X4 s/ j1 T! ?9 m
0 r8 Z  P0 o4 Spygame.draw.rect：绘制矩形
pygame.draw.rect(Surface, color, Rect, width=0)
$ Q$ v$ h! b$ w+ W$ K: MSurface：绘制在 Surface 对象上
) B5 W' P" n1 tcolor：传入 RGB 三元组或 RGBA 四元组
width：指定边框宽度，0 表示填充该矩形
% S/ E. q% F  N' Npygame.draw.polygon：绘制多边形
pygame.draw.polygon(Surface, color, pointlist, width=0)
pointlist：指定多边形的各个顶点
pygame.draw.circle：绘制圆形
pygame.draw.circle(Surface, color, pos, radius, width=0)
- m6 h, z, K* C2 o3 M0 Q1 apos：圆心位置
radius：半径
pygame.draw.ellipse：绘制椭圆
pygame.draw.ellipse(Surface, color, Rect, width=0)
Rect：椭圆外切矩形
pygame.draw.arc：绘制弧线
pygame.draw.arc(Surface, color, Rect, start_angle, stop_angle, width=1)
Rect：弧线所在椭圆外切矩形
angle：弧线开始和结束位置
pygame.draw.line：绘制线段
pygame.draw.line(Surface, color, start_pos, end_pos, width=1)
pygame.draw.lines：绘制多条线段
pygame.draw.lines(Surface, color, closed, pointlist, width=1)
pointlist：一系列点
( N' e- I% J" C. nclosed：若为 True 则绘制首尾相连
13. pygame.font
- z. U, U- B' b
该类是pygame中加载和表示字体的模块
' C: P$ d# W# S- Q
pygame.font.init：初始化
pygame.font.quit：退出
pygame.font.get_init：判断是否初始化
% N0 K' s' f2 O7 lpygame.font.get_font：获取所有可使用的字体
7 s2 `& T6 i. M: D: Q! Z1 F( ipygame.font.match_font：在系统中搜索字体
pygame.font.SysFont：从系统字体库冲创建一个对象
pygame.font.Font：从字体文件中创建一个对象
pygame.font.Font.render：在新的 Surface 对象上绘制文本
pygame.font.Font.size：确定字体大小
pygame.font.Font.set_underline：是否加下划线
. ]! C  k/ n5 k$ Jpygame.font.Font.set_bold：是否加粗
2 s) M9 Q* k- x! ^2 `( h9 Mpygame.font.Font.set_italic：是否设置为斜体
14. pygame.mixer.music

该类是pygame中控制音乐播放的模块，对于MP3格式的支持受限，建议OGG格式
. {: N1 Q1 u# d- T# f7 S
pygame.mixer.music.load：载入一个音乐文件
pygame.mixer.music.play：开始播放
pygame.mixer.music.play(loops=0, start=0.0)
loops：控制再循环几次，若为3则一共播放4次
. G% \" Q2 J% jstart：控制从哪里开始播放，单位为秒
pygame.mixer.music.rewind：重新开始播放
pygame.mixer.music.stop：结束播放
% M% R" J; R% O2 U6 c% L! ppygame.mixer.music.pause：暂停播放
7 e+ m8 ]9 h2 R2 _4 e: Vpygame.mixer.music.unpause：继续播放
/ r  `9 s0 b  z& P) \pygame.mixer.music.set_voiume：设置音量
4 N5 |- g. x1 U- w* Ipygame.mixer.music.get_volume：获取音量
pygame.mixer.music.set_pos：设置播放位置
传入一个浮点数，控制从什么时候开始播放
pygame.mixer.music.queue：将一个应用文件放入队列，排在当前播放的音乐之后
pygame.mixer.music.set_endevent：设置播放结束事件
pygame.mixer.music.get_endevent：获取播放结束事件
4 ?8 [$ r3 y3 E4 @1 B15. pygame.mouse
, E* E$ S* t. n5 ^
! w& P$ [1 }% H, `0 |1 h该类是pygame中与鼠标操作相关的模块

: U0 ]' M: k, B6 K, ~- Q+ j( ]pygame.mouse.get_pressed：判断鼠标按键是否被按下
9 \5 M6 m! j: ]% kpygame.mouse.get_pos：获取鼠标光标位置
9 J7 {* Z4 N) \pygame.mouse.set_pos：设置鼠标光标位置
& I. S! U- D) Jpygame.mouse.set_visible：设置鼠标光标是否隐藏
2 i6 _: h: Y( u4 ]7 l% qpygame.mouse.set_cuisor：设置鼠标光标在程序内的显示图像
pygame.mouse.get_cursor：获取鼠标光标在程序内的显示图像
16. pygame.BufferProxy

该类是 Surface对象通过数组协议导出的一个缓冲对象
' L5 D3 H8 t) h% L5 i& u
% k; {& R( {) C; K3 jpygame.BufferProxy.parent：返回该 BufferProxy 的 Surface 对象， 或者调用 BufferProxy 的对象
pygame.BufferProxy.length：返回缓冲区的长度，单位是字节。类似于len字段
pygame.BufferProxy.length：将缓冲区的数据拷贝并返回，为str或bytes对象
" S. L4 Y9 c, Ypygame.BufferProxy.write：将字节写入缓冲区
8 }# }) a2 v8 T$ S$ j17. pygame.cdrom
( N7 e" N0 @( A8 E+ G2 h# x) V5 ^
" g% D# f8 U( w+ v8 Y: V该类是pygame中使用音频cdrom的模块， cdrom 即 Compact Disc Read-only Memory 只读光盘
* q- t* Y# |* p* B
4 N5 s/ c& _1 t: p* u3 T0 gpygame.cdrom.init：初始化模块
5 D" r- s0 ^+ O5 C7 o+ Spygame.cdrom.quit：退出模块
pygame.cdrom.get_init：判断是否初始化成功，成功返回 true
9 Q% x$ j4 |3 C2 E1 m$ Kpygame.cdrom.get_count：返回 cd 驱动器的个数
pygame.cdrom.CD：管理驱动的类
$ z* s; q% c* ~+ V- A$ {& Qpygame.cdrom.CD.init：初始化
pygame.cdrom.CD.quit：退出
0 \- M4 c. T  U) Zpygame.cdrom.CD.get_init：判断是否完成初始化
5 N$ e. _& k$ g" T) s* npygame.cdrom.CD.play：开始播放
pygame.cdrom.CD.stop：停止播放
  Q. c3 p7 n& i; Dpygame.cdrom.CD.pause：暂停播放
pygame.cdrom.CD.resume：恢复播放
18. pygame.PixelArray

该类为pygame中直接处理访问像素的模块
1 R' s- o7 ?/ Z( ]3 y# E) u( l
8 Q7 d% F5 p; Cpygame.PixelArray.surface：获取使用的 surface 对象
pygame.PixelArray.itemsize：返回像素数组项字节大小
pygame.PixelArray.make_surface：根据当前 PixelArray 创建新的 surface 对象
pygame.PixelArray.extract：从 PixelArray 中提取传递颜色
19. pygame.cursors

( t' |1 S" M. }: W( V该类是pygame中使用光标资源的模块
' e1 L8 ]' \: a& v
pygame.cursors.compile：又纯字符串创建二进制光标数据
pygame.cursors.load_xbm：由xbm文件载入光标数据
/ @; V0 ~" o& Q, g5 C# Z! H20. pygame.scrap

该类是pygame中用于支持剪切板的模块

pygame.scrap.init：初始化
: y$ d% k/ p  R, L; |1 hpygame.scrap.get：从剪切板获取指定类型数据
pygame.scrap.put：将数据放入剪切板
pygame.scrap.contains：检测是否获得
( G5 q7 m# e* t21. pygame.sndarray

2 g) e) t  N8 @# R* ]该类是pygame中访问音频采样数据的模块
/ F8 p/ y0 j: V: q6 G8 R
pygame.sndarray.array：将一个音频采样复制到一个数组
. o( V- h* }, y9 E9 a) Fpygame.sndarray.make_sound：将一个数组变成一个音频对象
" [; v9 n+ S" p) x, L7 y22. pygame.transform

, d# B$ q0 `( J( c& S5 y该类是pygame中用于改变surface形态的模块
0 T  d0 C+ U) Q/ O8 D
$ K! X  P+ }2 t; ^( S* vpygame.transform.flip：垂直和水平翻转
pygame.transform.scale：调整大小到新的分辨率
pygame.transform.rotata：旋转图像
23. pygame.tests
' ^9 @* x& B3 u  Y& `
8 E& G/ q0 A: [6 P, R# e该类是pygame中用于单元测试的模块

pygame.tests.run：运行测试套件
24. pygame.freetype

0 A; J$ O1 I7 k: J% v3 q8 p& K8 f该类是pygame中用来加载和呈现计算机字体的模块，不常用
; |9 f% q: _: D/ ]! N
5 l- b' \% v2 U" R$ T8 x- g25. pygame.joystick

$ I" B8 _# v+ r3 |该类是pygame中与游戏杆、游戏手柄、追踪球交互的模块，详情参考文档

26. pygame.locals
) u% r; Z2 Z! S1 Q# c% \
该类是pygame中定义各种常量的模块
6 u/ u$ r0 W- D7 [! N) N) t, Y
% n! E0 q* t2 J$ s+ T27. pygame.surfarray

该类是pygame中使用接口访问 surface 像素的模块，不常用

28. pygame.Overlay
  V5 C! N/ K+ M2 f! p: d  s
" ]$ c. h: d/ w4 i+ K$ v8 V; P该类是pygame中用于处理视频叠加图像的模块，不常用
————————————————
版权声明：本文为CSDN博主「丁生呀」的原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接及本声明。
原文链接：https://blog.csdn.net/qq_43733805/article/details/105809241
& ~% m( n9 _9 _  l" B6 L, n