pygame之pygame模块

pygame-最顶层的Pygame模块

pygame.init—初始化所有导入的pygame模块

pygame.quit—卸载掉导入的pygame模块

pygame.error—标准pygame异常

pygame.get_error—得到当前的错误信息

pygame.set_error—设置当前的错误信息

pygame.get_sdl_version—得到SDL的版本号

pygame.get_sdl_byteorder—获取SDL的字节顺序

pygame.register_quit—在pygame退出时注册一个函数

pygame.encode_string—编码一个Unicode或字节对象

pygame.encode_file_path—将Unicode或字节对象编码为文件系统路径

pygame包代表了其他人使用的顶层包。Pygame本身被分解成许多子模块，但这并不影响使用Pygame的程序。为了方便起见，pygame中的大多数顶级变量都被放置在名为“pygame.localas”的模块中,这是用来和pygame一起使用的。本地间谍游戏的常数导入，除了“导入pygame”之外。当你导入pygame的时候，所有可用的pygame子模块都是自动导入的。请注意，一些pygame模块被认为是“可选的”，并且可能无法使用。在这种情况下，pygame将提供一个占位符对象，而不是模块，后者可用于测试可用性。

pygame.init() 初始化所有导入的pygame模块

init() -> (numpass, numfail)

初始化所有导入的pygame模块。如果一个模块失败，将不会出现异常，但是如果成功且失败了，那么它的总数量将作为一个元组返回。您总是可以手动初始化各个模块，但是pygame.init（）初始化所有导入的pygame模块，这是一种方便的方法来启动一切。个别模块的init（）函数将在失败时引发异常。您可能想要分别初始化不同的模块以加速您的程序，或者不使用您的游戏所没有的东西。可以安全地调用init（）不止一次：重复调用将没有效果。即使你有pygame.quit（）所有的模块，这也是正确的。

pygame.quit() 卸载所有pygame模块

 quit() -> None

取消先前已初始化的所有pygame模块。当Python解释器关闭时，不管怎样，这个方法都被调用，所以您的程序不需要它，除非它想要终止它的pygame资源并继续。调用这个函数是安全的：重复调用没有效果。注意，pygame.quit（）取消初始化所有pygame模块不会退出您的程序。考虑让您的程序以与普通python程序结束相同的方式结束。

pygame.get_error() 获取当前的错误消息

get_error() -> errorstr

SDL维护一个内部错误消息。当pygame.error（）标准pygame异常被提出时，通常会给您这个消息。你很少需要调用这个函数。

pygame.set_error() 设置当前错误消息

set_error(error_msg) -> None

pygame.get_sdl_version() 获得SDL的版本号

get_sdl_version() -> major, minor, patch

返回SDL库的三个版本号。这个版本是在编译时构建的。它可以用来检测哪些功能可能无法通过pygame获得。

pygame.get_sdl_byteorder() 获取SDL的字节顺序

get_sdl_byteorder() -> int

返回SDL库的字节顺序。它返回lilendian，为小的endian字节顺序和bigendian，为大的endian字节顺序。

pygame.register_quit() 在pygame退出时运行一个函数

register_quit(callable) -> None

当pygame.quit（）取消所有pygame模块的初始化时，所有注册的退出函数都被调用。Pygame模块在初始化时自动完成。对于普通的pygame用户来说，这个功能是不需要的。

pygame.encode_string() 编码一个Unicode或字节对象

encode_string([obj [, encoding [, errors [, etype]]]]) -> bytes or None

obj:如果Unicode编码;如果字节,返回一成不变的;如果有其他的，不要返回;如果没有给出，就会提高语法错误。

encoding （字符串）：如果存在，编码要使用。默认值是“unicode_escape”。

errors （字符串）：如果给定，如何处理不可编码字符。默认值是“backslashreplace”。

etype（例外类型）：如果给定，则为编码错误增加异常类型。默认的是UnicodeEncodeError，由pyunicodeasencodedstring（）返回。对于默认的编码和错误值，应该没有编码错误。

这个函数用于编码文件路径。支持关键字参数。

pygame.encode_file_path() 将Unicode或字节对象编码为文件系统路径

encode_file_path([obj [, etype]]) -> bytes or None

obj:如果Unicode编码;如果字节,返回一成不变的;如果有其他的，不要返回;如果没有给出，就会提高语法错误。

etype（例外类型）：如果给定，则为编码错误增加异常类型。默认的是UnicodeEncodeError，由pyunicodeasencodedstring（）返回。

这个函数用于在pygame中编码文件路径。编码是由sys.getfilesystemencoding（）返回的编解码器。支持关键字参数。

pygame.version.ver 返回的版本号作为字符串

pygame.version.vernum 返回版本的整型元组

pygame.version.rev 构建库的版本修订