39.11. imgfile — 支持 SGI imglib 文件 — Python 文档

39.11. 图像文件 — 支持 SGI imglib 文件

自 2.6 版起已弃用：imgfile 模块已在 Python 3 中删除。

imgfile 模块允许 Python 程序访问 SGI imglib 图像文件（也称为 .rgb 文件）。 该模块还远未完成，但无论如何都提供了，因为在某些情况下有足够的功能。 目前，不支持颜色图文件。

该模块定义了以下变量和函数：

exception imgfile.error

所有错误都会引发此异常，例如不受支持的文件类型等。

imgfile.getsizes(file)

此函数返回一个元组 (x, y, z)，其中 x 和 y 是以像素为单位的图像大小，z 是每个像素的字节数. 目前仅支持 3 字节 RGB 像素和 1 字节灰度像素。

imgfile.read(file)

此函数读取并解码指定文件上的图像，并将其作为 Python 字符串返回。 该字符串具有 1 字节灰度像素或 4 字节 RGBA 像素。 左下角的像素是字符串中的第一个像素。 例如，这种格式适合传递给 gl.lrectwrite()。

imgfile.readscaled(file, x, y, filter[, blur])

此函数与 read 相同，但它返回缩放到给定 x 和 y 大小的图像。 如果省略 filter 和 blur 参数，则缩放是通过简单地删除或复制像素来完成的，因此结果将不那么完美，尤其是对于计算机生成的图像。

或者，您可以指定一个过滤器，用于在缩放后平滑图像。 支持的过滤器形式有 'impulse'、'box'、'triangle'、'quadratic' 和 'gaussian'。 如果指定了过滤器 blur 是一个可选参数，指定过滤器的模糊度。 默认为 1.0。

readscaled() 不尝试保持纵横比正确，因此这是用户的责任。

imgfile.ttob(flag)

该函数设置一个全局标志，用于定义图像的扫描线是从下到上（标志为零，兼容SGI GL）还是从上到下（标志为1，兼容X）读取或写入。 默认值为零。

imgfile.write(file, data, x, y, z)

此函数将 data 中的 RGB 或灰度数据写入图像文件 file。 x 和 y 给出图像的大小，z 为 1 表示 1 字节灰度图像或 3 表示 RGB 图像（它们存储为仅使用低三个字节）。 这些是 gl.lrectread() 返回的格式。