[TOC] # **pygame.image** 用于图像传输的 Pygame 模块。 ## **函数** * pygame.image.load() — 从文件加载新图片 * pygame.image.save() — 将图像保存到磁盘上 * pygame.image.get\_extended() — 检测是否支持载入扩展的图像格式 * pygame.image.tostring() — 将图像转换为字符串描述 * pygame.image.fromstring() — 将字符串描述转换为图像 * pygame.image.frombuffer() — 创建一个与字符串描述共享数据的 Surface 对象 image 模块包含了加载和保存图像的函数，同时转换为 Surface 对象支持的格式。 注意：没有 Image 类；当一个图像被成功载入后，将转换为 Surface 对象。Surface 对象允许你在上边画线、设置像素、捕获区域等。 Image 是 Pygame 相当依赖的一个模块，支持载入的图像格式如下： * JPG * PNG * GIF（无动画） * BMP * PCX * TGA（无压缩） * TIF * LBM（和 PBM） * PBM（和 PGM，PPM） * XPM 支持保存为以下格式： * BMP * TGA * PNG * JPEG 其中，保存为 PNG 和 JPEG 格式是 Pygame 1.8 新增加的。 ## **函数详解** ### **pygame.image.load()** 从文件加载新图片。 load(filename) -> Surface load(fileobj, namehint=””) -> Surface 从文件加载一张图片，你可以传递一个文件路径或一个 Python 的文件对象。 Pygame 将自动判断图像的格式（比如 GIF 或位图）并创建一个新的 Surface 对象。有时它可能需要知道文件的后缀名（比如 GIF 图像应该以 “.gif” 为后缀）。如果你传入原始文件对象，你需要传入它对应的文件名到 namehint 参数中。 返回的 Surface 对象将包含与源文件相同的颜色格式，colorkey 和 alpha 透明度通道。你通常需要调用 Surface.convert() 函数进行转换，这样可以使得在屏幕上绘制的速度更快。 对于含有 alpha 通道的图片（支持部分位置透明，像 PNG 图像），需要使用 Surface.convert\_alpha() 函数进行转换。 在某些环境下，Pygame 可能无法支持上述所有的图像格式，但至少无压缩的 BMP 格式是支持的。你可以调用 pygame.image.get\_extended() 函数，如果返回 True，说明可以加载上述的格式（包含 PNG，JPG 和 GIF）。 你应该使用 os.path.join() 提高代码的兼容性： ~~~ asurf = pygame.image.load(os.path.join('data', 'Python.png')) ~~~ ### **pygame.image.save()** 将图像保存到磁盘上。 save(Surface, filename) -> None 该函数将保存 Surface 对象到磁盘上，支持存储为 BMP，TGA，PNG 或 JPEG 格式的图像。如果 filename 没有指定后缀名，那么默认是保存为 TGA 格式。TGA 和 BMP 格式是无压缩的文件。 保存为 PNG 和 JPEG 格式是 Pygame 1.8 新增的。 ### **pygame.image.get\_extended()** 检测是否支持载入扩展的图像格式。 get\_extended() -> bool 如果 Pygame 支持上述所有的扩展图像格式，则返回 True。 ### **pygame.image.tostring()** 将图像转换为字符串描述。 tostring(Surface, format, flipped=False) -> string 将图像转换为一个字符串描述，可以被 Python 的其他图像模块通过 “fromstring” 转换回图像。一些 Python 图像模块喜欢“自下而上”的存储格式（例如 PyOpenGL）。如果 flipped 参数为 True，那么字符串将会垂直翻转以适用这类图像模块。 format 参数可以是下表中任何一个字符串。注意：只有 8 位的 Surface 对象可以使用 “P” 格式。其他格式可以用于任何 Surface 对象上。 | **字符串** | **含义** | | --- | --- | | P | 8 位调色板的 Surface 对象 | | RGB | 24 位图像 | | RGBX | 32 位图像，不留空白 | | RGBA | 32 位图像，带 alpha 通道 | | ARGB | 32 位图像，带 alpha 通道，并将 alpha 放在前边 | | RGBA\_PREMULT | 32 位图像，通过 alpha 通道缩放 | | ARGB\_PREMULT | 32 位图像，通过 alpha 通道缩放，并将 alpha 放在前边 | ### **pygame.image.fromstring()** 将字符串描述转换为图像。 fromstring(string, size, format, flipped=False) -> Surface 该函数的使用跟 pygame.image.tostring() 相似。size 参数是一对表示宽度和高度的数字。一旦新的 Surface 对象创建成功，你就可以删除字符串描述。 size 和 format 参数指定的数据需要跟字符串描述相符，否则将抛出异常。 更快地将图片转换到 Pygame，请参考 pygame.image.frombuffer() 函数。 ### **pygame.image.frombuffer()** 创建一个与字符串描述共享数据的 Surface 对象。 frombuffer(string, size, format) -> Surface 创建一个新的 Surface 对象，与字符串描述直接共享像素数据。该函数的使用跟 pygame.image.fromstring() 类似，但没法垂直翻转原始数据。 该函数的速度会比 pygame.image.fromstring() 快很多，因为该函数不需要申请和拷贝任何像素数据。