PIL包（剩余模块的自动锁定）#

对于文档尚未移植或编写的模块，可以在此处找到参考。

PIL 模块#

exception PIL.UnidentifiedImageError[源代码]#

基类：OSError

在 PIL.Image.open() 如果图像无法打开和识别。

如果PNG图像引发此错误，则设置 ImageFile.LOAD_TRUNCATED_IMAGES 设置为True可能最终允许打开图像。该设置将忽略丢失的数据和校验和失败。

BdfFontFile 模块#

解析X位图分布格式（BDF）

class PIL.BdfFontFile.BdfFontFile(fp)[源代码]#

基类：FontFile

X11 BDF格式的字体文件插件。

PIL.BdfFontFile.bdf_char(f)[源代码]#

ContainerIO 模块#

class PIL.ContainerIO.ContainerIO(file, offset, length)[源代码]#

基类：object

提供对现有文件（例如TAR文件）的一部分的读访问的file对象。

isatty()[源代码]#
read(n=0)[源代码]#

读取数据。

参数:

n -- 要读取的字节数。如果省略或为零，则读取直到区域结束。

返回:

8位字符串。

readline()[源代码]#

阅读一行文字。

返回:

8位字符串。

readlines()[源代码]#

阅读多行文本。

返回:

8位字符串的列表。

seek(offset, mode=0)[源代码]#

移动文件指针。

参数:

  • offset -- 偏移量（字节）。

  • mode -- 开始位置。区域开始使用0，当前偏移使用1，区域结束使用2。不能将指针移动到定义区域之外。

tell()[源代码]#

获取当前文件指针。

返回:

从区域开始的偏移量，以字节为单位。

FontFile 模块#

class PIL.FontFile.FontFile[源代码]#

基类：object

栅格字体文件处理程序的基类。

bitmap = None#
compile()[源代码]#

创建度量和位图

save(filename)[源代码]#

保存字体

PIL.FontFile.puti16(fp, values)[源代码]#

写入网络顺序（big-endian）16位序列

GdImageFile 模块#

备注

无法自动识别此格式，因此该类未注册为与一起使用 PIL.Image.open() . 要打开gd文件，请使用 PIL.GdImageFile.open() 而是函数。

警告

GD格式不是为数据交换而设计的。此实现仅用于方便和演示目的。

class PIL.GdImageFile.GdImageFile(fp=None, filename=None)[源代码]#

基类：ImageFile

GD未压缩格式的图像插件。请注意，标准不支持此格式 PIL.Image.open() 功能。要使用此插件，必须导入 PIL.GdImageFile 模块并使用 PIL.GdImageFile.open() 功能。

format = 'GD'#
format_description = 'GD uncompressed images'#
PIL.GdImageFile.open(fp, mode='r')[源代码]#

从gd图像文件加载纹理。

参数:

  • fp -- gd文件名或打开的文件句柄。

  • mode -- 可选模式。在这个版本中，如果给出了模式参数，那么它必须是“r”。

返回:

图像实例。

抛出:

OSError -- 如果无法读取图像。

GimpGradientFile 模块#

将曲线段转换为调色板值的工具（源于GIMP中的相应代码，由federicomena Quintero编写。有关详细信息，请参见GIMP发行版。）

PIL.GimpGradientFile.EPSILON = 1e-10#
class PIL.GimpGradientFile.GimpGradientFile(fp)[源代码]#

基类：GradientFile

GIMP渐变格式的文件处理程序。

class PIL.GimpGradientFile.GradientFile[源代码]#

基类：object

getpalette(entries=256)[源代码]#
gradient = None#
PIL.GimpGradientFile.SEGMENTS = [<function linear>, <function curved>, <function sine>, <function sphere_increasing>, <function sphere_decreasing>]#
PIL.GimpGradientFile.curved(middle, pos)[源代码]#
PIL.GimpGradientFile.linear(middle, pos)[源代码]#
PIL.GimpGradientFile.sine(middle, pos)[源代码]#
PIL.GimpGradientFile.sphere_decreasing(middle, pos)[源代码]#
PIL.GimpGradientFile.sphere_increasing(middle, pos)[源代码]#

GimpPaletteFile 模块#

class PIL.GimpPaletteFile.GimpPaletteFile(fp)[源代码]#

基类：object

GIMP调色板格式的文件处理程序。

getpalette()[源代码]#
rawmode = 'RGB'#

ImageDraw2 模块#

（实验性）WCK风格的绘图界面操作

参见

PIL.ImageDraw

class PIL.ImageDraw2.Pen(color, width=1, opacity=255)[源代码]#

基类：object

存储轮廓颜色和宽度。

class PIL.ImageDraw2.Brush(color, opacity=255)[源代码]#

基类：object

存储填充颜色

class PIL.ImageDraw2.Font(color, file, size=12)[源代码]#

基类：object

存储TrueType字体和颜色

class PIL.ImageDraw2.Draw(image, size=None, color=None)[源代码]#

基类：object

（实验）WCK风格的绘图界面

flush()[源代码]#
render(op, xy, pen, brush=None)[源代码]#
settransform(offset)[源代码]#

设置变换偏移。

arc(xy, start, end, *options)[源代码]#

在给定的边界框内，在起始角和结束角之间绘制圆弧（圆轮廓的一部分）。

参见

PIL.ImageDraw.ImageDraw.arc()

chord(xy, start, end, *options)[源代码]#

等同于 arc() ，但用直线连接端点。

参见

PIL.ImageDraw.ImageDraw.chord()

ellipse(xy, *options)[源代码]#

在给定的边界框内绘制椭圆。

参见

PIL.ImageDraw.ImageDraw.ellipse()

line(xy, *options)[源代码]#

在中的坐标之间绘制一条线 xy 名单。

参见

PIL.ImageDraw.ImageDraw.line()

pieslice(xy, start, end, *options)[源代码]#

与圆弧相同，但也在端点和边界框中心之间绘制直线。

参见

PIL.ImageDraw.ImageDraw.pieslice()

polygon(xy, *options)[源代码]#

绘制多边形。

多边形轮廓由给定坐标之间的直线以及最后一个坐标和第一个坐标之间的直线组成。

参见

PIL.ImageDraw.ImageDraw.polygon()

rectangle(xy, *options)[源代码]#

绘制矩形。

参见

PIL.ImageDraw.ImageDraw.rectangle()

text(xy, text, font)[源代码]#

在给定位置绘制字符串。

参见

PIL.ImageDraw.ImageDraw.text()

textbbox(xy, text, font)[源代码]#

返回给定文本的边框(以像素为单位)。

返回:

(left, top, right, bottom) 包围盒

参见

PIL.ImageDraw.ImageDraw.textbbox()

textlength(text, font)[源代码]#

返回给定文本的长度(以像素为单位)。这是以下文本应偏移量。

参见

PIL.ImageDraw.ImageDraw.textlength()

ImageTransform 模块#

class PIL.ImageTransform.AffineTransform(data)[源代码]#

基类：Transform

定义仿射图像转换。

这个函数接受一个6元组（a、b、c、d、e、f），其中包含来自仿射变换矩阵的前两行。对于输出图像中的每个像素（x，y），从输入图像中的一个位置（a x+b y+c，d x+e y+f）获取新值，四舍五入到最近的像素。

此功能可用于缩放、平移、旋转和剪切原始图像。

见 transform()

参数:

matrix -- 包含仿射变换矩阵前两行的6元组（A、B、C、D、E、F）。

method = 0#
class PIL.ImageTransform.ExtentTransform(data)[源代码]#

基类：Transform

定义转换以从图像中提取子区域。

将一个矩形（由两个角定义）从图像映射到给定大小的矩形。生成的图像将包含从角点之间采样的数据，这样输入图像中的（x0，y0）将在输出图像中结束于（0,0），而（x1，y1）将在大小上结束。

此方法可用于裁剪、拉伸、收缩或镜像当前图像中的任意矩形。它比裁剪稍慢，但大约和相应的调整大小操作一样快。

见 transform()

参数:

bbox -- 一个4元组（X0、Y0、X1、Y1），指定输入图像坐标系中的两个点。见 坐标系 .

method = 1#
class PIL.ImageTransform.MeshTransform(data)[源代码]#

基类：Transform

定义网格图像转换。网格变换由一个或多个单独的四元变换组成。

见 transform()

参数:

data -- （bbox，quad）元组的列表。

method = 4#
class PIL.ImageTransform.QuadTransform(data)[源代码]#

基类：Transform

定义四图像转换。

将图像中的四边形（由四个角定义的区域）映射到给定大小的矩形。

见 transform()

参数:

xy -- 一个8元组（X0、Y0、X1、Y1、X2、Y2、X3、Y3），包含源四边形的左上角、左下角、右下角和右上角。

method = 3#
class PIL.ImageTransform.Transform(data)[源代码]#

基类：ImageTransformHandler

getdata()[源代码]#
transform(size, image, **options)[源代码]#

PaletteFile 模块#

class PIL.PaletteFile.PaletteFile(fp)[源代码]#

基类：object

Teragon样式调色板文件的文件处理程序。

getpalette()[源代码]#
rawmode = 'RGB'#

PcfFontFile 模块#

class PIL.PcfFontFile.PcfFontFile(fp, charset_encoding='iso8859-1')[源代码]#

基类：FontFile

X11 PCF格式的字体文件插件。

name = 'name'#
PIL.PcfFontFile.sz(s, o)[源代码]#

PngImagePlugin.iTXt 等级#

class PIL.PngImagePlugin.iTXt(text, lang=None, tkey=None)[源代码]#

基类：str

字符串的子类，允许itxt块在保留额外信息的同时看起来像字符串

__new__(cls, text, lang, tkey)[源代码]#
参数:

  • value -- 此键的值

  • lang -- 语言代码

  • tkey -- 密钥名的UTF-8版本

PngImagePlugin.PngInfo 等级#

class PIL.PngImagePlugin.PngInfo[源代码]#

基类：object

PNG块容器（用于保存（pnginfo=）

add(cid, data, after_idat=False)[源代码]#

附加任意块。小心使用。

参数:

  • cid -- 字节字符串，4个字节长。

  • data -- 编码数据的字节字符串

  • after_idat -- 与私密块一起使用。块是否应在IDAT之后写入

add_itxt(key, value, lang='', tkey='', zip=False)[源代码]#

附加一个itxt块。

参数:

  • key -- 拉丁文-1可编码文本密钥名称

  • value -- 此键的值

  • lang -- 语言代码

  • tkey -- 密钥名的UTF-8版本

  • zip -- 压缩标志

add_text(key, value, zip=False)[源代码]#

附加文本块。

参数:

  • key -- 拉丁文-1可编码文本密钥名称

  • value -- 此键、文本或 PIL.PngImagePlugin.iTXt 实例

  • zip -- 压缩标志

TarIO 模块#

class PIL.TarIO.TarIO(tarfile, file)[源代码]#

基类：ContainerIO

提供对TAR文件中给定成员的读访问的文件对象。

close()[源代码]#

WalImageFile 模块#

本阅读器基于可从以下网站获得的规范：https://www.flipcode.com/archives/Quake_2_BSP_File_Format.shtml并用google找到的几个示例文件进行了测试。

备注

无法自动识别此格式，因此读取器未注册为与一起使用 PIL.Image.open() . 要打开WAL文件，请使用 PIL.WalImageFile.open() 而是函数。

class PIL.WalImageFile.WalImageFile(fp=None, filename=None)[源代码]#

基类：ImageFile

format = 'WAL'#
format_description = 'Quake2 Texture'#
load()[源代码]#

根据切片列表加载图像数据

PIL.WalImageFile.open(filename)[源代码]#

从Quake2 Wal纹理文件加载纹理。

默认情况下，将“地震2”标准调色板附加到纹理。要覆盖调色板，请使用 PIL.Image.Image.putpalette() 方法。

参数:

filename -- wal文件名或打开的文件句柄。

返回:

图像实例。