pygamePygame中⽂⽂档
pygame | Pygame中⽂⽂档
pygame
Pygame 最顶层的包。
函数 & 属性
pygame.init() — 初始化所有导⼊的 pygame 模块 pygame.quit() — 卸载所有导⼊的 pygame 模块
<() — 标准 pygame 异常模块
pygame.set_error() — 设置当前错误信息
<_sdl_version() — 获得 SDL 的版本号
<_sdl_byteorder() — 获得 SDL 的字节顺序
pygame 包是可供使⽤的最顶层的包。Pygame 被分成许多⼦模块，但是并不会影响程序使⽤ Pygame。
为了⽅便，在 pygame 中绝⼤多数的顶级变量被放⼊名为“pygame.locals”的模块中。意思是说这些变量可通过以下⽅式导⼊：
1. import pygame
针织圆机
2. from pygame.locals import *
当你导⼊ pygame 后，所有可⽤的 pygame ⼦模块都将⾃动被导⼊。需要注意的是，⼀些 pygame 模块是“可选的”，并且可能⽆法使⽤。以防万⼀，Pygame 将提供了⼀个占位符对象替代原来的模块，这个对象可⽤来测试某些功能（变量）是否可⽤。
函数 & 属性详解
pygame.init()
初始化所有导⼊的 pygame 模块。
init() -> (numpass, numfail)
初始化所有导⼊的 pygame 模块，如果有模块导⼊失败也不会显⽰异常，但是将返回⼀个元组，第⼀个元素为成功导⼊的模块数，第⼆个元素为导⼊失败的个数。
也许你想分开初始化不同的模块，以提⾼你程序的运⾏速度，或者不加载暂时⽤不到的模块。
重复调⽤ init() ⽅法是没问题的，也不会有任何负⾯影响。即使你已经调⽤了 pygame.quit() 卸载所有模块也是可以的。
pygame.quit()
卸载所有导⼊的 pygame 模块。
quit() -> None
卸载所有之前被初始化的 pygame 模块。当 python 解释器关闭时，这个⽅法将被⽆条件地调⽤，所以你的程序并不需要调⽤这个⽅法，除⾮你想要终⽌ pygame 资源，并继续执⾏其他功能。多次执⾏这个⽅法也是没有问题的。
注意：调⽤这个⽅法 pygame.quit() 会结束所有模块，但不会结束你的程序。建议⽤正常结束 python 程序的⽅法来结束 pygame 程序。
标准的 pygame 异常。
(message)
当 pygame 或 SDL 操作失败时，将会引发异常。你可以捕获任何可预见的问题并处理异常。报告异常时，会同时显⽰问题的描述信息。
它是 RuntimeError 异常的⼦类，⽤于捕获这些异常。
地理课件<_error()
得到当前错误信息。
get_error() -> errorstr
获取 SDL 维护的⼀个内部错误消息。当标准 () 标准 pygame 异常引发时，这些信息将会提供给你。
其实你很少会使⽤到这个⽅法的啦。
pygame.set_error()
设置当前错误信息。
set_error(error_msg) -> None
设置 SDL 维护的⼀个内部错误消息。当标准 () 标准 pygame 异常引发时，这些信息将会提供给你。
其实你很少会使⽤到这个⽅法的啦。
<_sdl_version()挠度计算公式
获得 SDL 的版本号。
get_sdl_version() -> major, minor, patch
返回 SDL 库有关版本的 3 个数字。这个版本是在编译时⽣成的。这个⽅法可⽤来得知哪个元件是不能正常使⽤的。
Pygame 1.7.0 新添加的⽅法。
<_sdl_byteorder()
获得 SDL 的字节顺序。
获得 SDL 的字节顺序。
get_sdl_byteorder() -> int
获得 SDL 库的字节顺序。返回 LIL_ENDIAN 表⽰⼩端字节顺序；返回 BIG_ENDIAN 表⽰⼤端字节顺序。
Pygame 1.8 新添加的⽅法。
注册⼀个函数，这个函数将在 pygame 退出时被调⽤。
巴布尔
register_quit(callable) -> None
当调⽤ pygame.quit() 结束所有模块时，所有通过 register_quit() ⽅法注册过的函数将被调⽤。这⼀切都是⾃动执⾏的。
⼀般的 pygame ⽤户⽤不到这个⽅法。
核心交换机对 unicode 或字节对象进⾏编码。
encode_string([obj [, encoding [, errors [, etype]]]]) -> bytes or None
obj：
传⼊ unicode 类型 -> 编码
传⼊ bytes 类型 -> 不变
传⼊其他类型 -> 返回 None
没有传递 obj 参数 -> 引起 SyntaxError 异常
encoding (string)：如果存在则进⾏编码，默认是 unicode_escape。
errors (string)：指定如何处理⽆法编码的内容，默认使⽤反斜杠（\）代替。
etype (exception type)：指定编码错误引发的异常类型。默认为 UnicodeEncodeError，由 PyUnicode_AsEncodedString() 返回。对于默认的编码和错误值不应该有编码错误。
这个函数被⽤于编码⽂件路径的时候，⽀持使⽤关键字参数。
Pygame 1.9.2 新增加的⽅法（主要⽤于单元测试）。
将 unicode 或 bytes 对象编码为⽂件系统路径。
encode_file_path([obj [, etype]]) -> bytes or None
obj：
传⼊ unicode 类型 -> 编码
传⼊ bytes 类型 -> 不变
传⼊其他类型 -> 返回 None
没有传递 obj 参数 -> 引起 SyntaxError 异常
etype（异常类型）：若给出，则出现异常时报相应编码错误，默认为 UnicodeEncodeError，由 PyUnicode_AsEncodedString() 返回。
这个函数被⽤于编码⽂件路径的时候，结果由 filesystemencoding() 返回，⽀持使⽤关键字参数。
vba宏语言Pygame 1.9.2 新增加的⽅法（主要⽤于单元测试）。
豫公网安备41160202000603
站长QQ:729038198
关于我们
投诉建议