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() 快很多，因为该函数不需要申请和拷贝任何像素数据。