PIL 中的 Image 模块

Bertha 。 2022-09-26 03:55 206阅读 0赞

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

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

\------------------------------------------------------

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

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

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

![ExpandedBlockStart.gif][]

![复制代码][copycode.gif]

1 
         
          from
         
          PIL 
         
          import
         
          Image 
         
          2 
         
           
         
          import
         
          glob, os 
         
          3 
         
          
         
          4 
         
          size 
         
          =
         
          
         
          128
         
          , 
         
          128
         
          
         
          5 
         
           
         
          for
         
          infile 
         
          in
         
          glob.glob(
         
          "
         
          *.jpg
         
          "
         
          ): 
         
          6 
         
          file, ext 
         
          =
         
          os.path.splitext(infile) 
         
          7 
         
          im 
         
          =
         
          Image.open(infile) 
         
          8 
         
          im.thumbnail(size, Image.ANTIALIAS) 
         
          9 
         
          im.save(file 
         
          +
         
          
         
          "
         
          .thumbnail
         
          "
         
          , 
         
          "
         
          JPEG
         
          "
         
          )

![复制代码][copycode.gif]

**Image 类中的函数**。

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

![ExpandedBlockStart.gif][]

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

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

![ExpandedBlockStart.gif][]

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

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

![ExpandedBlockStart.gif][]

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

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

![ExpandedBlockStart.gif][]

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

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

![ExpandedBlockStart.gif][]

1 
         
          Image.eval( image, function ) 
         
          =>
         
          image

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

![ExpandedBlockStart.gif][]

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

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

![ExpandedBlockStart.gif][]

1 
         
          #
         
          使用字符串类型的像素数据和标准解码器 "raw" 来创建图像
         
          
         
          2 
         
           
         
          Image.fromstring( mode, size, data ) 
         
          =>
         
          image 
         
          3 
         
          
         
          4 
         
           
         
          #
         
          同上。不过允许你使用其他 PIL 支持的像素解码器。
         
          
         
          5 
         
           
         
          Image.fromstring( mode, size, data, decoder, parameters ) 
         
          =>
         
          image

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

![ExpandedBlockStart.gif][]

1 
         
          Image.merge( mode, bands ) 
         
          =>
         
          image

**Image 类中的方法**：

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

![ExpandedBlockStart.gif][]

![复制代码][copycode.gif]

1 
         
          #
         
          If mode is omitted, a mode is chosed so that all information in the image and the palette can be representedwithout a palette .
         
          
         
          2 
         
          #
         
          when from a colour image to black and white, the library uses the ITU-R 601-2 luma transfrom:
         
          
         
          3 
         
          #
         
          L = R * 299/1000 + G * 587/1000 + B * 114/1000
         
          
         
          4 
         
           
         
          im.convert( mode ) 
         
          =>
         
          image 
         
          5 
         
          
         
          6 
         
           
         
          #
         
          Converts an "RGB" image to "L" or "RGB" using a conversion matrix. The matrix is 4- or 16-tuple.
         
          
         
          7 
         
           
         
          im.convert( mode, matrix ) 
         
          =>
         
          image

![复制代码][copycode.gif]

下面是一个例子：转换 RGB 为 XYZ 。

![ExpandedBlockStart.gif][]

1 
         
          rgb2xyz 
         
          =
         
          ( 
         
          2 
         
          
         
          0.412453
         
          , 
         
          0.357580
         
          , 
         
          0.180423
         
          , 0, 
         
          3 
         
          
         
          0.212671
         
          , 
         
          0.715160
         
          , 
         
          0.072169
         
          , 0, 
         
          4 
         
          
         
          0.019334
         
          , 
         
          0.119193
         
          , 
         
          0.950227
         
          , 0 ) 
         
          5 
         
          out 
         
          =
         
          im.convert(
         
          "
         
          RGB
         
          "
         
          , rgb2xyz)

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

![ExpandedBlockStart.gif][]

1 
         
          im.copy() 
         
          =>
         
          image

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

![ExpandedBlockStart.gif][]

1 
         
          im.crop( box ) 
         
          =>
         
          image

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

![ExpandedBlockStart.gif][]

1 
         
          im.draft(mode, size)

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

![ExpandedBlockStart.gif][]

1 
         
          im.filter( filter ) 
         
          =>
         
          image

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

![ExpandedBlockStart.gif][]

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

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

![ExpandedBlockStart.gif][]

1 
         
          im.getbands( ) 
         
          =>
         
          tuple of strings

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

![ExpandedBlockStart.gif][]

1 
         
          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。

![ExpandedBlockStart.gif][]

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

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

![ExpandedBlockStart.gif][]

1 
         
          im.getdata() 
         
          =>
         
          sequence

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

![ExpandedBlockStart.gif][]

1 
         
          im.getextrema() 
         
          =>
         
          
         
          2
         
          -
         
          tuple

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

![ExpandedBlockStart.gif][]

1 
         
          im.getpixel( xy ) 
         
          =>
         
          value 
         
          or
         
          tuple

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

![ExpandedBlockStart.gif][]

1 
         
          im.histogram() 
         
          =>
         
          list 
         
          2 
         
          
         
          3 
         
          im.histogram( mask ) 
         
          =>
         
          list

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

![ExpandedBlockStart.gif][]

1 
         
          im.load() 
         
          2 
         
          
         
          3 
         
           
         
          # 
         
          4 
         
           
         
          pix 
         
          =
         
          im.load() 
         
          5 
         
           
         
          print
         
          pix[x, y] 
         
          6 
         
          pix[x, y] 
         
          =
         
          value

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

![ExpandedBlockStart.gif][]

![复制代码][copycode.gif]

1 
         
          im.paste( image, box ) 
         
          2 
         
          
         
          3 
         
          im.paste( colour, box ) 
         
          4 
         
          
         
          5 
         
          im.paste( image, box, mask ) 
         
          6 
         
          
         
          7 
         
          im.paste( colour, box, mask )

![复制代码][copycode.gif]

15.    point :

![ExpandedBlockStart.gif][]

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

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

未完待续。

[PIL handbook online]: http://www.pythonware.com/library/pil/handbook/index.htm
[ExpandedBlockStart.gif]: /images/20220717/e7879241d3284ea6aa6374314cc7980c.png
[copycode.gif]: /images/20220717/277cb6bed32745c6b4ebcd2600d40289.png
[Link 1]: http://www.pythonware.com/library/pil/handbook/imagefilter.htm