PIL 中的 Image 模块

本文是节选自 PIL handbook online 并做了一些简单的翻译

只能保证自己看懂，不保证翻译质量。欢迎各位给出意见。

------------------------------------------------------

    Image 模块提供了一个同名类（Image），也提供了一些工厂函数，包括从文件中载入图片和创建新图片。例如，以下的脚本先载入一幅图片，将它旋转 45 度角，并显示出来：

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

    下面这个脚本则创建了当前目录下所有以 .jpg 结尾的图片的缩略图。

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, Image.ANTIALIAS)
    im.save(file + ".thumbnail", "JPEG")

    Image 类中的函数。

0.    new : 这个函数创建一幅给定模式（mode）和尺寸（size）的图片。如果省略 color 参数，则创建的图片被黑色填充满，如果 color 参数是 None 值，则图片还没初始化。

Image.new( mode, size ) => image
Image.new( mode, size, color ) => image

1.    open : 打开并识别所提供的图像文件。不过，使用这函数的时候，真正的图像数据在你进行数据处理之前并没有被读取出来。可使用 load 函数进行强制加载。 mode 参数可以省略，但它只能是 "r" 值。

Image.open( infile ) => image
Image.open( infile, mode ) => image

2.    blend : 使用两幅给出的图片和一个常量 alpha 创建新的图片。两幅图片必须是同样的 size 和 mode 。

Image.blend( image1, image2, alpha ) => image
 # 结果 与 运算过程
# out = image1 * ( 1.0 - alpha ) + image2 * alpha

3.    composite : 使用两幅给出的图片和一个与 alpha 参数相似用法的 mask 参数，其值可为："1", "L", "RGBA" 。两幅图片的 size 必须相同。

Image.composite( image1, image2, mask ) => image

4.    eval : 使用带一个参数的函数作用于给定图片的每一个像素。如果给定的图片有超过一个的 频段（band），则该函数也会作用于每一个频段。注意，该函数是每一个像素计算一次，所以不能使用一些随机组件或其他的生成器。

Image.eval( image, function ) => image

5.    frombuffer : （PIL 1.1.4 中新添加的）使用标准 "raw" 解码器在像素数据或是对象缓存中创建一个图像副本。不是所有的模式都支持这种用法。支持的 mode 有"L", "RGBX", "RGBA", "CMYK"。

Image.frombuffer( mode, size, data ) => image

6.    fromstring : 注意，这个函数只对像素数据进行解码，而不是一整张图片。如果你有一整张字符串格式的图片，使用 StringIO 对其进行包装并用 open 函数载入它。

# 使用字符串类型的像素数据和标准解码器 "raw" 来创建图像
 Image.fromstring( mode, size, data ) => image

 # 同上。不过允许你使用其他 PIL 支持的像素解码器。
 Image.fromstring( mode, size, data, decoder, parameters ) => image

7.    merge : 使用一系列单一频段(band)的图像来创建新的一幅图像。频段是以一些图像组成的元组或列表，所有的 band 必须有相同大小的 size 。

Image.merge( mode, bands ) =>image

    Image 类中的方法：

0.    convert : 返回一个转换后的图像的副本。

# If mode is omitted, a mode is chosed so that all information in the image and the palette can be representedwithout a palette .
# when from a colour image to black and white, the library uses the ITU-R 601-2 luma transfrom:
# L = R * 299/1000 + G * 587/1000 + B * 114/1000
 im.convert( mode ) => image

 # Converts an "RGB" image to "L" or "RGB" using a conversion matrix. The matrix is 4- or 16-tuple.
 im.convert( mode, matrix ) => image

    下面是一个例子：转换 RGB 为 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)

1.    copy : 复制图像。如果你希望粘贴一些东西进图像里面的话可以使用这个方法，但仍然会保留原图像。

im.copy() => image

2.    crop : 返回图像某个给定区域。box 是一个 4 元素元组，定义了 left, upper, right, lower 像素坐标。使用这个方法的时候，如果改变原始图像，可能会，也可能不会改变裁剪生成的图像。创建一个完全的复制，裁剪复制的时候使用 load 方法。

im.crop( box ) => image

3.    draft : 按给出的 mode 和 size 进行配置。可以使用这个方法将彩色JPEG图片转为灰度图。

im.draft(mode, size)

4.    filter : 返回图像使用滤波器后的副本。可以看 这里 获取更多有用的滤波器。

im.filter( filter ) => image

5.    fromstring : 和前面的函数是一样的功能，不过这个方法是将数据载入到当前图像。

im.fromstring( data ) 
im.fromstring( data, decoder, parameters )

6.    getbands : 返回一个元组，包含每一个 band 的名字，比如，在一幅 RGB 格式的图像上使用 getbands 则返回（"R", "G", "B"）。

im.getbands(  ) => tuple of strings

7.    getbbox : 计算图像边框值，返回一个 4-元组 ，值为（左，上，右，下）。

im.getbbox()  => 4-tuple or None

8.    getcolors : 在 1.1.5 版本中新添加的。返回一个未排序列表，其元素是元组（count, color）。the count is the number of times the corresponding color occurs in the image 。If the maxcolors value is exceeded, the method stops counting and returns None。

im.getcolors() => a list of (count, color) tuples or None
im.getcolors( maxcolors ) => a list of (count, color) tuples or None

9.    getdata : 返回一个图像内容的像素值序列。不过，这个返回值是 PIL 内部的数据类型，只支持确切的序列操作符，包括迭代器和基本序列方法。我们可以通过 list(im.getdata())  为其生成普通的序列。

im.getdata() => sequence

10.    getextrema : 返回一个 2-元组 ，值为图像的最小最大值。在当前PIL版本中，仅支持单一频段(single-band)的图像。

im.getextrema() => 2-tuple

11.    getpixel : 返回指定位置的像素，如果所打开的图像是多层次的图片，那这个方法就返回一个元组。

im.getpixel( xy ) => value or tuple

12.    histogram : 返回图像直方图，值为像素计数组成的列表。如果有参数 mask ，则返回图像所有部分的直方图。

im.histogram() => list

im.histogram( mask ) => list

13.    load : 版本 1.1.6 新添加的。load 返回对象的像素值，可以用来修改像素值。

im.load()

 #
 pix = im.load()
 print pix[x, y]
pix[x, y] = value

14.    paste : 1). 粘贴新图片至图片中，box 参数可以为 2-元组（upper, left）或是 4-元组（left, upper, right, lower），或者是 None（0, 0）。2). 功能同上。不过是将指定位置填充为某种颜色。

im.paste( image, box )

im.paste( colour, box )

im.paste( image, box, mask )

im.paste( colour, box, mask )

15.    point : 

im.point( bable ) => image
im.point( function ) => image

  ------------

未完待续。