Pygame/pygame

(重定向自Pygame/version

pygame

顶层 pygame 包

pygame 分为多个子模块。

出于便利,大多数 pygame 顶层变量被放在了 pygame.locals 模块中。

当你 import pygame 时,所有可用的子模块会被自动导入。

注意:一些子模块是可选的,有可能不可用。这种情况下,那里会有一个占位对象,而不是模块,你可以检测其可用性。

本节原文

pygame.init()

初始化所有被导入的 pygame 模块

init() → (成功模块数, 失败模块数)

初始化成功和失败的模块数将组成元组被返回;如果有模块初始化失败,不会导致异常。

多次调用本方法是安全的。

pygame.quit()

反初始化所有被初始化的 pygame 模块

quit() → 无

当 Python 解释器关闭时,该方法会被自动调用,所以一般无需手动调用,除非你想关闭 pygame 并继续执行程序。

多次调用本方法也是安全的。

pygame.get_init()

如果 pygame 已初始化,返回真 (1.9.5+)

get_init() → 布尔

pygame.error

标准 pygame 异常

本异常在 pygame 或 SDL 操作失败时引发。你可以捕获并处理此异常。该异常总是带有一段英文描述信息。

本异常是 RuntimeError 的子类。

pygame.get_error()

获取当前错误信息

get_error() → 错误信息

SDL 管理着一个内部错误信息。这个信息通常会被 pygame.error 传递,因此这个函数很少有用。

pygame.set_error()

设置当前错误信息

set_error(error_msg错误信息) -> None

SDL 管理着一个内部错误信息。这个信息通常会被 pygame.error 传递,因此这个函数很少有用。

pygame.get_sdl_version()

获取 SDL 版本号

get_sdl_version() → 主版本号, 次版本号, 补丁号

返回 SDL 库的版本号(而不是 pygame 的,见下文),以三个整数组成的元组的形式;该版本号是编译时建立的。

该版本号可以用于检测哪些功能在 pygame 中可用,哪些不可用。

pygame.get_sdl_byteorder()

获取 SDL 字节序

get_sdl_byteorder() → 整数

获取 SDL 字节序。对于小字节序(低字节在前)返回1234,对于大字节序(高字节在前)返回4321。

pygame.register_quit()

注册一个会在退出时被调用的函数

register_quit(callable可调用对象) → None

当 pygame.quit() 被调用,所有注册的退出函数被调用。pygame 模块会在被初始化时自动调用,因此这个函数很少有用。

pygame.encode_string()

编码一个字符串或字节串对象

encode_string(obj对象 [, encoding编码 [, errors错误处理 [, etype异常类型]]]) → 字节串或无

  • obj: 如果是 Unicode 字符串,编码;如果是字节串,直接返回;如果是其它对象,返回无;如果未提供,引发语法错误。
  • encoding (字符串,可选): 要使用的编码,默认值为 'unicode_escape' (转换为\uXXXX)。
  • errors (字符串,可选): 处理无法编码的字符的方式,默认值为 'backslashreplace' (转换为\uXXXX)。
  • etype (异常类型,可选): 编码失败时引起的异常。默认值为 UnicodeEncodeError (Unicode 编码错误)。

该函数用于对文件路径进行编码。

pygame.encode_file_path()

编码一个字符串或字节串对象为文件系统路径 (1.9.2+)

encode_file_path(obj对象 [, etype异常类型]) → 字节串或无

  • obj: 如果是 Unicode 字符串,编码;如果是字节串,直接返回;如果是其它对象,返回无;如果未提供,引发语法错误。
  • etype (异常类型,可选): 编码失败时引起的异常。默认值为 UnicodeEncodeError (Unicode 编码错误)。

该函数用于在 pygame 中使用 sys.getfilesystemencoding() 所返回的编码器对文件路径进行编码。

pygame.version

包含版本信息的小模块

本模块被自动包含于 pygame 包中,可被用于检查安装的 pygame 是何种版本。

本节原文

pygame.version.ver

版本号字符串

ver = '1.9.6'

pygame.version.vernum

版本号整数元组

vernum = (1, 9, 6)

该版本信息可以轻易的进行比较,例如:assert pygame.version.vernum >= (1,9,0)

从 1.9.6 开始,该属性是一个 PygameVersion 对象,其仍旧可以当做元组来使用;但是,转换为字符串时为 '1.9.6'。

pygame.version.rev

编译版本号

rev = 'a6f89747b551+'

主要用于测试版本;1.9.4 和 1.9.6 正式版本的该属性只是一个空字符串。

pygame 文档中文翻译
常用ColordisplaydraweventfontimagekeylocalsmixermouseRectSurfacetimemusicpygame
高级cursorsjoystickmaskspritetransformBufferProxyfreetypegfxdrawmidiOverlayPixelArraypixelcopysndarraysurfarraymath
其它cameracdromscraptestssurfarrayversion
链接官网英文文档日文译文