Image 模块

这个 Image 模块提供了一个同名的类,用于表示PIL图像。该模块还提供许多工厂功能,包括从文件加载图像和创建新图像的功能。

实例

打开、旋转和显示图像(使用默认查看器)

下面的脚本加载图像,将其旋转45度,并使用外部查看器(通常是UNIX上的xv,以及Windows上的paint程序)显示它。

from PIL import Image
im = Image.open("bride.jpg")
im.rotate(45).show()

创建缩略图

下面的脚本创建当前目录中所有JPEG图像的漂亮缩略图,保留最大分辨率为128x128的纵横比。

from PIL import Image
import glob, os

size = 128, 128

for infile in glob.glob("*.jpg"):
    file, ext = os.path.splitext(infile)
    im = Image.open(infile)
    im.thumbnail(size)
    im.save(file + ".thumbnail", "JPEG")

功能

PIL.Image.open(fp, mode='r')[源代码]

打开并标识给定的图像文件。

这是一个懒惰的操作;此函数标识文件,但文件保持打开状态,并且在尝试处理数据(或调用 load() 方法)。见 new() . 见 Pillow中的文件处理 .

参数
  • fp -- 文件名(字符串)、pathlib.path对象或文件对象。文件对象必须实现 read()seek()tell() 方法,并以二进制模式打开。

  • mode -- 模式。如果给出,这个参数必须是“r”。

返回

Image 对象。

引发

IOError -- 如果找不到文件,或者无法打开和标识图像。

警告

以防止由“引起的潜在DoS攻击” decompression bombs “(即恶意文件,将其解压缩为大量数据,并设计为通过耗尽大量内存而崩溃或造成中断), Pillow 将发出一个 DecompressionBombWarning 如果图像超过某个限制。如果需要,可以将警告转换为错误 warnings.simplefilter('error', Image.DecompressionBombWarning) 或者完全被压制 warnings.simplefilter('ignore', Image.DecompressionBombWarning) . 也见 the logging documentation 将警告输出到日志工具而不是stderr。

图像处理

PIL.Image.alpha_composite(im1, im2)[源代码]

IM1上的α复合IM2。

参数
  • im1 -- 第一张图片。必须具有模式rgba。

  • im2 -- 第二张图片。必须具有模式rgba,并且大小与第一个图像相同。

返回

Image 对象。

PIL.Image.blend(im1, im2, alpha)[源代码]

通过使用常量alpha在两个输入图像之间插入来创建新图像。::

out = image1 * (1.0 - alpha) + image2 * alpha
参数
  • im1 -- 第一张图片。

  • im2 -- 第二张图片。必须与第一个图像具有相同的模式和大小。

  • alpha -- 插值α因子。如果alpha为0.0,则返回第一个图像的副本。如果alpha为1.0,则返回第二个图像的副本。alpha值没有限制。如有必要,将结果裁剪到允许的输出范围内。

返回

Image 对象。

PIL.Image.composite(image1, image2, mask)[源代码]

通过使用透明蒙版混合图像来创建合成图像。

参数
  • image1 -- 第一张图片。

  • image2 -- 第二张图片。必须与第一个图像具有相同的模式和大小。

  • mask -- 掩模图像。此图像可以具有模式“1”、“l”或“rgba”,并且必须与其他两个图像具有相同的大小。

PIL.Image.eval(image, *args)[源代码]

对给定图像中的每个像素应用函数(应采用一个参数)。如果图像有多个波段,则对每个波段应用相同的功能。请注意,该函数对每个可能的像素值进行一次评估,因此不能使用随机组件或其他生成器。

参数
  • image -- 输入图像。

  • function -- 一个函数对象,采用一个整型参数。

返回

Image 对象。

PIL.Image.merge(mode, bands)[源代码]

将一组单波段图像合并为新的多波段图像。

参数
  • mode -- 用于输出图像的模式。见: 模式 .

  • bands -- 包含输出图像中每个波段一个单波段图像的序列。所有带区的大小必须相同。

返回

Image 对象。

构建图像

PIL.Image.new(mode, size, color=0)[源代码]

创建具有给定模式和大小的新图像。

参数
  • mode -- 用于新图像的模式。见: 模式 .

  • size -- 以像素为单位包含(宽度、高度)的2元组。

  • color -- 图像要使用什么颜色。默认为黑色。如果给定,对于单波段模式,这应该是一个整数或浮点值,对于多波段模式,这应该是一个元组(每个波段一个值)。创建RGB图像时,还可以使用ImageColor模块支持的颜色字符串。如果颜色为“无”,则图像不会初始化。

返回

Image 对象。

PIL.Image.fromarray(obj, mode=None)[源代码]

从导出数组接口的对象(使用缓冲区协议)创建图像内存。

如果 obj 不是连续的,则调用tobytes方法并 frombuffer() 使用。

如果你有一张麻木的图片:

from PIL import Image
import numpy as np
im = Image.open('hopper.jpg')
a = np.asarray(im)

然后可以将其转换为Pillow图像:

im = Image.fromarray(a)
参数
  • obj -- 带数组接口的对象

  • mode -- 要使用的模式(如果没有将由类型决定)请参见: 模式 .

返回

图像对象。

1.1.6 新版功能.

PIL.Image.frombytes(mode, size, data, decoder_name='raw', *args)[源代码]

从缓冲区中的像素数据创建图像内存的副本。

最简单的形式是,这个函数接受三个参数(模式、大小和未压缩的像素数据)。

您还可以使用PIL支持的任何像素解码器。有关可用解码器的详细信息,请参阅部分 Writing Your Own File Decoder .

请注意,此函数只解码像素数据,而不是整个图像。如果在字符串中包含整个图像,请将其包装为 BytesIO 对象与使用 open() 加载它。

参数
  • mode -- 图像模式。见: 模式 .

  • size -- 图像大小。

  • data -- 包含给定模式的原始数据的字节缓冲区。

  • decoder_name -- 使用什么解码器。

  • args -- 给定解码器的其他参数。

返回

Image 对象。

PIL.Image.fromstring(*args, **kw)[源代码]
PIL.Image.frombuffer(mode, size, data, decoder_name='raw', *args)[源代码]

在字节缓冲区中创建引用像素数据的图像内存。

此功能类似于 frombytes() ,但尽可能使用字节缓冲区中的数据。这意味着对原始缓冲区对象的更改将反映在此图像中)。并非所有模式都可以共享内存;支持的模式包括“l”、“rgbx”、“rgba”和“cmyk”。

请注意,此函数只解码像素数据,而不是整个图像。如果您有一个字符串中的整个图像文件,请用 BytesIO 对象与使用 open() 加载它。

在当前版本中,用于“原始”解码器的默认参数与用于 frombytes() . 这是一个bug,可能会在将来的版本中修复。如果执行此操作,当前版本将发出警告;要禁用该警告,应提供完整的参数集。详情见下文。

参数
  • mode -- 图像模式。见: 模式 .

  • size -- 图像大小。

  • data -- 包含给定模式的原始数据的字节或其他缓冲区对象。

  • decoder_name -- 使用什么解码器。

  • args -- 给定解码器的其他参数。对于默认编码器(“raw”),建议您提供完整的参数集::frombuffer(模式、大小、数据,“raw”,模式,0,1)

返回

Image 对象。

1.1.4 新版功能.

正在注册插件

注解

这些函数供插件作者使用。应用程序作者可以忽略它们。

PIL.Image.register_open(id, factory, accept=None)[源代码]

注册图像文件插件。应用程序代码中不应使用此函数。

参数
  • id -- 图像格式标识符。

  • factory -- 图像文件工厂方法。

  • accept -- 一种可选功能,可用于快速拒绝具有另一种格式的图像。

PIL.Image.register_decoder(name, decoder)[源代码]

注册图像解码器。应用程序代码中不应使用此函数。

参数
  • name -- 解码器的名称

  • decoder -- 返回imagefile.pydecoder对象的可调用(模式,参数)

4.1.0 新版功能.

PIL.Image.register_mime(id, mimetype)[源代码]

注册图像mime类型。应用程序代码中不应使用此函数。

参数
  • id -- 图像格式标识符。

  • mimetype -- 此格式的图像mime类型。

PIL.Image.register_save(id, driver)[源代码]

注册图像保存功能。应用程序代码中不应使用此函数。

参数
  • id -- 图像格式标识符。

  • driver -- 以这种格式保存图像的函数。

PIL.Image.register_encoder(name, encoder)[源代码]

注册图像编码器。应用程序代码中不应使用此函数。

参数
  • name -- 编码器的名称

  • encoder -- 返回imagefile.pyencoder对象的可调用(模式,参数)

4.1.0 新版功能.

PIL.Image.register_extension(id, extension)[源代码]

注册图像扩展名。应用程序代码中不应使用此函数。

参数
  • id -- 图像格式标识符。

  • extension -- 用于此格式的扩展名。

图像类

class PIL.Image.Image[源代码]

此类表示图像对象。创造 Image 对象,使用适当的工厂功能。几乎没有任何理由直接调用图像构造函数。

的实例 Image 类具有以下方法。除非另有说明,否则所有方法都返回 Image 类,保存生成的图像。

Image.alpha_composite(im, dest=(0, 0), source=(0, 0))[源代码]

image.alpha_复合的“就地”模拟。将图像合成到该图像上。

参数
  • im -- 要在此图像上合成的图像

  • dest -- 可选的2个元组(左上角),指定此(目标)图像中的左上角。

  • source -- 覆盖源图像中左上角的可选2(左,上)元组,或源矩形边界的4个元组(左,上,右,下)

性能说明:目前没有在核心层中就地实现。

Image.convert(mode=None, matrix=None, dither=None, palette=0, colors=256)[源代码]

返回此图像的转换副本。对于“P”模式,此方法通过调色板转换像素。如果省略了模式,则会选择一个模式,以便可以在不使用调色板的情况下表示图像和调色板中的所有信息。

当前版本支持“l”、“rgb”和“cmyk”之间的所有可能转换。 matrix 参数只支持“L”和“RGB”。

将彩色图像转换为灰度(模式“L”)时,库使用ITU-R 601-2 Luma转换:

L = R * 299/1000 + G * 587/1000 + B * 114/1000

将灰度(“L”)或“RGB”图像转换为双层(模式“1”)图像的默认方法是使用Floyd Steinberg抖动来近似原始图像的亮度级别。如果“抖动”为“无”,则所有大于128的值都设置为255(白色),所有其他值都设置为0(黑色)。要使用其他阈值,请使用 point() 方法。

当从“rgba”转换为“p”时,不使用 matrix 参数,这将操作传递给 quantize()ditherpalette 被忽略。

参数
  • mode -- 请求的模式。见: 模式 .

  • matrix -- 可选的转换矩阵。如果给定,则应该是包含浮点值的4或12元组。

  • dither -- 抖动方法,从模式“RGB”转换为“P”或从“RGB”或“L”转换为“1”时使用。可用方法为无或Floydsteinberg(默认)。注意,当 matrix 供应。

  • palette -- 从模式“rgb”转换为“p”时使用的调色板。可用的调色板是Web或自适应的。

  • colors -- 要用于自适应调色板的颜色数。默认为256。

返回类型

Image

返回

Image 对象。

以下示例将RGB图像(根据ITU-R 709线性校准,使用D65亮度)转换为CIE XYZ颜色空间:

rgb2xyz = (
    0.412453, 0.357580, 0.180423, 0,
    0.212671, 0.715160, 0.072169, 0,
    0.019334, 0.119193, 0.950227, 0)
out = im.convert("RGB", rgb2xyz)
Image.copy()[源代码]

复制此图像。如果要将内容粘贴到图像中,但仍保留原始内容,请使用此方法。

返回类型

Image

返回

Image 对象。

Image.crop(box=None)[源代码]

返回此图像中的矩形区域。框是定义左、上、右和下像素坐标的四元组。见 坐标系 .

注意:在Pillow3.4.0之前,这是一个懒惰的操作。

参数

box -- 裁剪矩形,作为(左、上、右、下)元组。

返回类型

Image

返回

Image 对象。

这将使用提供的坐标裁剪输入图像:

from PIL import Image

im = Image.open("hopper.jpg")

# The crop method from the Image module takes four coordinates as input.
# The right can also be represented as (left+width)
# and lower can be represented as (upper+height).
(left, upper, right, lower) = (20, 20, 100, 100)

# Here the image "im" is cropped and assigned to new variable im_crop
im_crop = im.crop((left, upper, right, lower))
Image.draft(mode, size)[源代码]

配置图像文件加载器,使其返回尽可能接近给定模式和大小的图像版本。例如,可以使用此方法在加载彩色jpeg时将其转换为灰度,或者从PCD文件中提取128x192版本。

请注意,此方法修改了 Image 对象就位。如果图像已经加载,则此方法无效。

注意:此方法不适用于大多数图像。它目前仅用于jpeg和pcd图像。

参数
  • mode -- 请求的模式。

  • size -- 请求的大小。

Image.filter(filter)[源代码]

使用给定的筛选器筛选此图像。有关可用筛选器的列表,请参阅 ImageFilter 模块。

参数

filter -- 过滤内核。

返回

Image 对象。

这将使用来自 ImageFilter 模块:

from PIL import Image, ImageFilter

im = Image.open("hopper.jpg")

# Blur the input image using the filter ImageFilter.BLUR
im_blurred = im.filter(filter=ImageFilter.BLUR)
Image.getbands()[源代码]

返回一个包含此图像中每个带区的名称的元组。例如, getbands 在RGB图像上返回(“R”、“G”、“B”)。

返回

包含带区名称的元组。

返回类型

tuple

这有助于获取输入图像的带区:

from PIL import Image

im = Image.open("hopper.jpg")
print(im.getbands())  # Returns ('R', 'G', 'B')
Image.getbbox()[源代码]

计算图像中非零区域的边界框。

返回

边界框作为定义左、上、右和下像素坐标的四元组返回。见 坐标系 . 如果图像完全为空,则此方法返回“无”。

这有助于获取输入图像的边界框坐标:

from PIL import Image

im = Image.open("hopper.jpg")
print(im.getbbox())
# Returns four coordinates in the format (left, upper, right, lower)
Image.getcolors(maxcolors=256)[源代码]

返回此图像中使用的颜色列表。

参数

maxcolors -- 最大颜色数。如果超过此数字,此方法将不返回任何值。默认限制为256色。

返回

(计数、像素)值的未排序列表。

Image.getdata(band=None)[源代码]

将此图像的内容作为包含像素值的序列对象返回。序列对象被展平,因此行1的值直接位于行0的值之后,依此类推。

注意,这个方法返回的sequence对象是一个内部PIL数据类型,它只支持特定的sequence操作。要将其转换为普通序列(例如用于打印),请使用**list(im.getdata())**。

参数

band -- 返回哪个乐队。默认值是返回所有带区。要返回单个波段,请传递索引值(例如0,从“rgb”图像中获取“r”波段)。

返回

类似序列的物体。

Image.getextrema()[源代码]

获取图像中每个波段的最小和最大像素值。

返回

对于单波段图像,包含最小和最大像素值的2元组。对于多波段图像,每个波段包含一个2元组的元组。

Image.getpalette()[源代码]

以列表形式返回图像调色板。

返回

如果图像没有调色板,则显示颜色值列表[R、G、B…]或无。

Image.getpixel(xy)[源代码]

返回给定位置的像素值。

参数

xy -- 坐标,以(x,y)表示。见 坐标系 .

返回

像素值。如果图像是多层图像,则此方法返回元组。

Image.histogram(mask=None, extrema=None)[源代码]

返回图像的直方图。柱状图以像素计数列表的形式返回,每个像素值对应一个源图像。如果图像有多个波段,则所有波段的柱状图都会连接起来(例如,“RGB”图像的柱状图包含768个值)。

该方法将二级图像(模式“1”)作为灰度(“L”)图像处理。

如果提供了遮罩,该方法将返回图像中遮罩图像非零部分的直方图。遮罩图像必须与图像具有相同的大小,并且是双层图像(模式“1”)或灰度图像(“L”)。

参数

mask -- 一个可选的面具。

返回

包含像素计数的列表。

Image.offset(xoffset, yoffset=None)[源代码]
Image.paste(im, box=None, mask=None)[源代码]

将另一个图像粘贴到此图像中。box参数要么是给出左上角的2元组,要么是定义左、上、右和下像素坐标的4元组,要么是无(与(0,0)相同)。见 坐标系 . 如果给定4元组,则粘贴图像的大小必须与区域的大小匹配。

如果模式不匹配,则粘贴的图像将转换为此图像的模式(请参见 convert() 详细方法)。

源可以是包含像素值的整数或元组,而不是图像。然后,该方法用给定的颜色填充该区域。创建RGB图像时,还可以使用ImageColor模块支持的颜色字符串。

如果给定了遮罩,则此方法仅更新遮罩指示的区域。您可以使用“1”、“l”或“rgba”图像(在后一种情况下,alpha带用作遮罩)。如果遮罩为255,则按原样复制给定图像。如果遮罩为0,则保留当前值。中间值将两个图像混合在一起,包括它们的alpha通道(如果有的话)。

alpha_composite() 如果你想结合图像的阿尔法通道。

参数
  • im -- 源图像或像素值(整数或元组)。

  • box -- 一个可选的4元组,给出要粘贴到的区域。如果使用2元组,则将其视为左上角。如果省略或没有,则源将粘贴到左上角。如果将图像作为第二个参数提供,而没有第三个参数,则框默认为(0,0),第二个参数将解释为遮罩图像。

  • mask -- 可选的遮罩图像。

Image.point(lut, mode=None)[源代码]

通过查找表或函数映射此图像。

参数
  • lut -- 一个查找表,包含图像中每个波段的256个(或65536个,如果self.mode==“i”和mode==“l”)值。可以改用函数,它应采用单个参数。对每个可能的像素值调用一次函数,结果表将应用于图像的所有带区。

  • mode -- 输出模式(默认与输入相同)。在当前版本中,只有当源图像具有模式“L”或“P”,并且输出具有模式“1”或源图像模式为“I”,并且输出模式为“L”时,才能使用此选项。

返回

Image 对象。

Image.putalpha(alpha)[源代码]

添加或替换此图像中的alpha层。如果图像没有alpha层,它将转换为“la”或“rgba”。新层必须是“l”或“1”。

参数

alpha -- 新的alpha层。这可以是与此图像大小相同的“l”或“1”图像,也可以是整数或其他颜色值。

Image.putdata(data, scale=1.0, offset=0.0)[源代码]

将像素数据复制到此图像。此方法将数据从序列对象复制到图像中,从左上角(0,0)开始,一直复制到图像或序列结束。比例和偏移值用于调整序列值: 像素=值*比例+偏移.

参数
  • data -- 序列对象。

  • scale -- 可选的比例值。默认值为1.0。

  • offset -- 可选的偏移值。默认值为0.0。

Image.putpalette(data, rawmode='RGB')[源代码]

将调色板附加到此图像。图像必须是“p”、“p a”、“l”或“la”图像,调色板序列必须包含768个整数值,其中每组三个值代表对应像素索引的红色、绿色和蓝色值。您可以使用8位字符串代替整数序列。

参数
  • data -- 调色板序列(列表或字符串)。

  • rawmode -- 调色板的原始模式。

Image.putpixel(xy, value)[源代码]

修改给定位置的像素。对于单波段图像,颜色以单个数值表示,对于多波段图像,颜色以元组表示。除此之外,p图像还接受rgb和rgba元组。

请注意,此方法相对较慢。要进行更广泛的更改,请使用 paste()ImageDraw 模块代替。

参见:

参数
  • xy -- 像素坐标,表示为(x,y)。见 坐标系 .

  • value -- 像素值。

Image.quantize(colors=256, method=None, kmeans=0, palette=None, dither=1)[源代码]

使用指定的颜色数将图像转换为“p”模式。

参数
  • colors -- 所需的颜色数,<=256

  • method -- 0=中值切割1=最大覆盖2=快速八叉树3=libImageQuant

  • kmeans -- 整数

  • palette -- 量化到给定的调色板 PIL.Image.Image .

  • dither -- 抖动方法,从模式“RGB”转换为“P”或从“RGB”或“L”转换为“1”时使用。可用方法为无或Floydsteinberg(默认)。默认值:1(传统设置)

返回

新形象

Image.resize(size, resample=0, box=None)[源代码]

返回此图像的已调整大小的副本。

参数
  • size -- 以像素为单位的请求大小,作为2元组:(宽度、高度)。

  • resample -- 可选的重新采样过滤器。这可能是 PIL.Image.NEARESTPIL.Image.BOXPIL.Image.BILINEARPIL.Image.HAMMINGPIL.Image.BICUBICPIL.Image.LANCZOS . 如果省略,或者图像具有模式“1”或“P”,则设置为 PIL.Image.NEAREST . 见: 过滤器 .

  • box -- 一个可选的4元组的浮点数,给出了应该缩放的源图像区域。值应在(0,0,宽度,高度)矩形内。如果省略或没有,则使用整个源。

返回

Image 对象。

这将调整给定图像的大小 (width, height)(width/2, height/2)

from PIL import Image

im = Image.open("hopper.jpg")

# Provide the target width and height of the image
(width, height) = (im.width // 2, im.height // 2)
im_resized = im.resize((width, height))
Image.remap_palette(dest_map, source_palette=None)[源代码]

重写图像以重新排序调色板。

参数
  • dest_map -- 原始调色板中的索引列表。例如 [1,0] 将交换一个两项调色板,list(range(256))是标识转换。

  • source_palette -- 字节或无。

返回

Image 对象。

Image.rotate(angle, resample=0, expand=0, center=None, translate=None, fillcolor=None)[源代码]

返回此图像的旋转副本。此方法返回此图像的副本,围绕其中心逆时针旋转给定的度数。

参数
  • angle -- 逆时针角度。

  • resample -- 可选的重新采样过滤器。这可能是 PIL.Image.NEAREST (使用最近的邻居) PIL.Image.BILINEAR (2x2环境中的线性插值),或 PIL.Image.BICUBIC (4x4环境中的三次样条插值)。如果省略,或者图像具有模式“1”或“P”,则设置为 PIL.Image.NEAREST . 见 过滤器 .

  • expand -- 可选扩展标志。如果为真,则展开输出图像,使其足够大以容纳整个旋转图像。如果为false或省略,则使输出图像与输入图像大小相同。请注意,展开标志假定围绕中心旋转,不进行平移。

  • center -- 可选旋转中心(2元组)。原点是左上角。默认为图像的中心。

  • translate -- 可选的后旋转翻译(2元组)。

  • fillcolor -- 旋转图像外部区域的可选颜色。

返回

Image 对象。

这将使输入图像旋转 theta 逆时针度数:

from PIL import Image

im = Image.open("hopper.jpg")

# Rotate the image by 60 degrees counter clockwise
theta = 60
# Angle is in degrees counter clockwise
im_rotated = im.rotate(angle=theta)
Image.save(fp, format=None, **params)[源代码]

在给定文件名下保存此图像。如果未指定格式,则可以从文件扩展名确定要使用的格式(如果可能)。

关键字选项可用于向编写器提供附加说明。如果一个作家不认识一个选项,它就会被默默地忽略。可用选项在 image format documentation 对于每个作家。

可以使用文件对象而不是文件名。在这种情况下,必须始终指定格式。文件对象必须实现 seektellwrite 方法,并以二进制模式打开。

参数
  • fp -- 文件名(字符串)、pathlib.path对象或文件对象。

  • format -- 可选格式替代。如果省略,则使用的格式由文件扩展名决定。如果使用的是文件对象而不是文件名,则应始终使用此参数。

  • params -- 图像编写器的额外参数。

返回

没有

引发
  • ValueError -- 如果无法从文件名确定输出格式。使用“格式”选项解决此问题。

  • IOError -- 如果无法写入文件。文件可能已创建,并且可能包含部分数据。

Image.seek(frame)[源代码]

查找此序列文件中的给定帧。如果在序列结尾之外查找,该方法将引发 EOFError 例外。打开序列文件时,库自动查找第0帧。

tell() .

参数

frame -- 帧编号,从0开始。

引发

EOFError -- 如果调用试图在序列结束后查找。

Image.show(title=None, command=None)[源代码]

显示此图像。此方法主要用于调试目的。

在UNIX平台上,此方法将图像保存到临时PPM文件中,并调用 显示eogxv 实用程序,取决于可以找到哪一个。

在MacOS上,此方法将图像保存到临时PNG文件中,并使用本机预览应用程序打开它。

在Windows上,它将图像保存到一个临时的BMP文件中,并使用标准的BMP显示实用程序来显示它(通常是绘制)。

参数
  • title -- 在可能的情况下,用于图像窗口的可选标题。

  • command -- 用于显示图像的命令

Image.split()[源代码]

将此图像拆分为单独的带区。此方法从图像返回单个图像带的元组。例如,分割一个“RGB”图像将创建三个新图像,每个新图像包含一个原始带区(红色、绿色、蓝色)的副本。

如果你只需要一个乐队, getchannel() 方法更方便快捷。

返回

包含条带的元组。

Image.getchannel(channel)[源代码]

返回包含源图像的单个通道的图像。

参数

channel -- 返回哪个通道。可以是索引(“rgb”的“r”通道为0)或通道名称(“rgb a”的alpha通道为a”)。

返回

处于“L”模式的图像。

4.3.0 新版功能.

Image.tell()[源代码]

返回当前帧号。见 seek() .

返回

帧编号,从0开始。

Image.thumbnail(size, resample=3)[源代码]

将此图像制作成缩略图。此方法修改图像以包含不大于给定大小的自身缩略图版本。此方法计算适当的缩略图大小以保留图像的方面,调用 draft() 方法来配置文件读取器(如果适用),并最终调整图像的大小。

请注意,此函数修改 Image 对象就位。如果还需要使用全分辨率图像,请将此方法应用于 copy() 原始图像的。

参数
  • size -- 请求的大小。

  • resample -- 可选的重新采样过滤器。这可能是 PIL.Image.NEARESTPIL.Image.BILINEARPIL.Image.BICUBICPIL.Image.LANCZOS . 如果省略,则默认为 PIL.Image.BICUBIC . 是 PIL.Image.NEAREST 2.5.0版之前)

返回

没有

Image.tobitmap(name='image')[源代码]

返回转换为x11位图的图像。

注解

此方法仅适用于模式“1”图像。

参数

name -- 用于位图变量的名称前缀。

返回

包含x11位图的字符串。

引发

ValueError -- 如果模式不是“1”

Image.tobytes(encoder_name='raw', *args)[源代码]

以字节对象的形式返回图像。

警告

此方法从内部存储器返回原始图像数据。对于压缩图像数据(如PNG、JPEG),请使用 save() ,内存中的数据带有一个bytesio参数。

参数
  • encoder_name -- 使用什么编码器。默认使用标准的“原始”编码器。

  • args -- 编码器的额外参数。

返回类型

A bytes object.

Image.tostring(*args, **kw)[源代码]
Image.transform(size, method, data=None, resample=0, fill=1, fillcolor=None)[源代码]

转换此图像。此方法创建具有给定大小和与原始图像相同模式的新图像,并使用给定的转换将数据复制到新图像。

参数
  • size -- 输出大小。

  • method -- 转换方法。这是其中之一 PIL.Image.EXTENT (切出矩形分区) PIL.Image.AFFINE (仿射变换) PIL.Image.PERSPECTIVE (透视变换) PIL.Image.QUAD (将四边形映射到矩形),或 PIL.Image.MESH (在一个操作中映射多个源四边形)。也可能是 ImageTransformHandler 对象::类示例(image.ImageTransformHandler):def转换(大小、方法、数据、重采样、填充=1):返回结果它也可能是具有 getdata() 返回提供新的 methoddata 值::类示例(对象):def getdata(self):method=image.extent data=(0,0,100,100)返回方法,数据

  • data -- 转换方法的额外数据。

  • resample -- 可选的重新采样过滤器。它可以是 PIL.Image.NEAREST (使用最近的邻居) PIL.Image.BILINEAR (2x2环境中的线性插值),或 PIL.Image.BICUBIC (4x4环境中的三次样条插值)。如果省略,或者图像具有模式“1”或“P”,则设置为 PIL.Image.NEAREST .

  • fill -- 如果 method 是一个 ImageTransformHandler 对象,这是传递给它的参数之一。否则,它是未使用的。

  • fillcolor -- 输出图像中转换外部区域的可选填充颜色。

返回

Image 对象。

Image.transpose(method)[源代码]

转置图像(以90度的步幅翻转或旋转)

参数

method -- 什么之中的一个 PIL.Image.FLIP_LEFT_RIGHTPIL.Image.FLIP_TOP_BOTTOMPIL.Image.ROTATE_90PIL.Image.ROTATE_180PIL.Image.ROTATE_270PIL.Image.TRANSPOSEPIL.Image.TRANSVERSE .

返回

返回此图像的翻转或旋转副本。

这将使用 Image.FLIP_LEFT_RIGHT 方法。

from PIL import Image

im = Image.open("hopper.jpg")

# Flip the image from left to right
im_flipped = im.transpose(method=Image.FLIP_LEFT_RIGHT)
# To flip the image from top to bottom,
# use the method "Image.FLIP_TOP_BOTTOM"
Image.verify()[源代码]

验证文件的内容。对于从文件读取的数据,此方法尝试确定文件是否已损坏,而不实际解码图像数据。如果此方法发现任何问题,则会引发适当的异常。如果使用此方法后需要加载图像,则必须重新打开图像文件。

Image.fromstring(*args, **kw)[源代码]
Image.load()[源代码]

为图像分配存储空间并加载像素数据。在正常情况下,不需要调用此方法,因为当首次访问打开的图像时,Image类会自动加载该图像。

如果与图像相关联的文件是通过 Pillow 打开的,那么此方法将关闭它。例外情况是如果图像有多个帧,在这种情况下,文件将保持打开状态以进行查找操作。见 Pillow中的文件处理 更多信息。

返回

图像访问对象。

返回类型

PixelAccess 等级 or PIL.PyAccess

Image.close()[源代码]

如果可能,关闭文件指针。

此操作将破坏图像核心并释放其内存。之后图像数据将无法使用。

此函数仅用于关闭未被 load() 方法。见 Pillow中的文件处理 更多信息。

属性

的实例 Image 类具有以下属性:

PIL.Image.filename

源文件的文件名或路径。仅使用工厂功能创建的图像 open 具有文件名属性。如果输入是类似文件的对象,则将文件名属性设置为空字符串。

类型

:py:class:string

PIL.Image.format

源文件的文件格式。对于库本身创建的图像(通过工厂函数或通过对现有图像运行方法),此属性设置为 None .

类型

string or None

PIL.Image.mode

图像模式。这是一个指定图像使用的像素格式的字符串。典型值为“1”、“l”、“rgb”或“cmyk”。请参见 模式 完整的列表。

类型

string

PIL.Image.size

图像大小(像素)。大小以2元组(宽度、高度)表示。

类型

(width, height)

PIL.Image.width

图像宽度,以像素为单位。

类型

int

PIL.Image.height

图像高度,以像素为单位。

类型

int

PIL.Image.palette

调色板表(如有)。如果模式为“P”或“PA”,则这应该是 ImagePalette 班级。否则,应将其设置为 None .

类型

ImagePalette or None

PIL.Image.info

保存与图象有关的数据的字典。文件处理程序使用此字典传递从文件中读取的各种非图像信息。有关详细信息,请参阅各种文件处理程序的文档。

大多数方法在返回新图像时忽略字典;由于键没有标准化,因此方法不可能知道操作是否影响字典。如果以后需要这些信息,请保留对从open方法返回的信息字典的引用。

除非另有说明,否则本词典不影响保存文件。

类型

dict