目录
pygame.init
()
功能:初始化所有导入的pygame模块
属性:init() -> (numpass, numfail)
- 初始化所有导入的pygame模块。如果模块失败,则不会引发异常,但成功和失败的inits的总数将作为元组返回。
- 可以手动初始化各个模块,但是pygame.init()更加便利。
- 单个模块的init()函数在失败时将引发异常。
- 重复的调用init()不产生任何效果。
pygame.
quit
()
功能:取消初始化所有pygame模块
属性:quit() -> None
- 当Python解释器关闭时,无论如何都会调用此方法,除非希望终止其pygame资源和运行。
- 重复的调用没有效果。
注意:调用pygame.quit()取消初始化所有pygame模块不会退出程序。
pygame.
get_init
()
功能:如果pygame当前已初始化,则返回True
属性:get_init() -> bool
New in pygame 1.9.5.
exception pygame.
error
功能:标志pygame异常
返回:raise pygame.error(message)
说明:
- 每当pygame或SDL操作失败时都会引发此异常。您可以捕获任何预期的问题并处理错误。异常总是由关于问题的描述性消息引发。
- 派生自RuntimeError异常,该异常也可用于捕获这些引发的错误。
pygame.
get_sdl_version
()
功能:获取SDL的版本号
属性:get_sdl_version() -> major, minor, patch
返回SDL库的三个版本号。此版本是在编译时生成的。它可用于检测哪些功能可能通过pygame可用,哪些不可用。
New in pygame 1.7.0.
pygame.
get_sdl_byteorder
()
功能:获取SDL的字节顺序
属性:get_sdl_byteorder() -> int
返回SDL库的字节顺序。它返回1234作为小字节顺序,4321作为大字节顺序。
New in pygame 1.8.
pygame.
encode_string
()
功能:编码Unicode或bytes对象
属性:encode_string([obj [, encoding [, errors [, etype]]]]) -> bytes or None
- obj:如果是Unicode,则编码;如果是bytes,则返回未更改;如果有其他内容,则返回无;如果没有给定,则引发SyntaxError。
-
encoding (string):如果存在,则使用编码。默认值为'unicode_escape'。
-
errors (string):如果给定,如何处理不可编码字符。默认值为'backslashreplace'。
- etype (异常类型):如果给定,则为编码错误引发的异常类型。默认值为
UnicodeEncodeError
,由PyUnicode_AsEncodedString()
返回。对于默认编码和错误值,不应存在编码错误。 - 此函数用于编码文件路径。支持关键字参数。
New in pygame 1.9.2: (主要用于单元测试)
pygame.
encode_file_path
()
功能:将Unicode或bytes对象编码为文件系统路径
属性:encode_file_path([obj [, etype]]) -> bytes or None
- obj:如果是Unicode,则编码;如果是bytes,则返回未更改;如果有其他内容,则返回无;如果没有给定,则引发SyntaxError。
- etype (异常类型):如果给定,则为编码错误引发的异常类型。默认值为
UnicodeEncodeError
,由PyUnicode_AsEncodedString()
返回。对于默认编码和错误值,不应存在编码错误。 - 此函数用于对pygame中的文件路径进行编码。编码是由
sys.getfilesystemencoding()
返回到编解码器。支持关键字参数。
New in pygame 1.9.2: (主要用于单元测试)
整理自:http://www.pygame.org/docs/ref/pygame.html#module-pygame.version