跳转至

Pillow 教程

Pillow 教程展示了如何在 Python 中使用 Pillow 来处理图像。

Pillow

Pillow 是 Python 图像库（PIL），它增加了对打开，操作和保存图像的支持。 当前版本标识并读取大量格式。 有意将写支持限制为最常用的交换和表示格式。

显示图片

在第一个示例中，我们读取图像文件并在外部程序中显示它。

show_image.py 
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
#!/usr/bin/python3

from PIL import Image
import sys

try:
    tatras = Image.open("tatras.jpg")

except IOError:
    print("Unable to load image")
    sys.exit(1)

tatras.show()

该程序读取 JPG 图像并将其显示在外部应用中。

1
from PIL import Image

在 PIL 模块中，我们包含Image类。

1
tatras = Image.open("tatras.jpg")

Image.open()方法读取图像文件。Pillow 可以读取 30 多种不同的文件格式。

1
tatras.show()

show()方法主要用于调试目的。 它将图像保存到一个临时文件中并在外部程序中显示。 在 Linux 上可以是 ImageMagic，在 Windows 上可以是 Paint。

Pillow 的基本图像信息

Pillow 使我们可以获得有关图像的一些基本信息。

basic_info.py 
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
#!/usr/bin/python3

from PIL import Image
import sys

try:
    tatras = Image.open("tatras.jpg")

except IOError:
    print("Unable to load image")
    sys.exit(1)

print("Format: {0}\nSize: {1}\nMode: {2}".format(tatras.format, 
    tatras.size, tatras.mode))

该示例使用 Pillow 打印有关图像的基本信息。

1
2
print("Format: {0}\nSize: {1}\nMode: {2}".format(tatras.format, 
    tatras.size, tatras.mode))

我们打印图像格式，大小和模式。

1
2
3
4
$ ./basic_info.py 
Format: JPEG
Size: (350, 232)
Mode: RGB

这是程序的输出。

图像模糊

ImageFilter模块包含一组预定义的过滤器的定义，可以与filter()方法一起使用。

blur_image.py 
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
#!/usr/bin/python3

from PIL import Image, ImageFilter
import sys

try:
    img = Image.open("tatras.jpg")

except IOError:
    print("Unable to load image")    
    sys.exit(1)

blurred = img.filter(ImageFilter.BLUR)

blurred.save("blurred.png")

该程序加载图像，从原始图像创建模糊图像，然后将新图像保存在磁盘上。

1
from PIL import Image, ImageFilter

我们导入Image和ImageFilter模块。

1
blurred = img.filter(ImageFilter.BLUR)

我们将ImageFilter.BLUR应用于原始图像； 该操作将返回一个新的修改图像。

1
blurred.save("blurred.png")

使用save()方法，我们将模糊的图像保存在磁盘上。

用 Pillow 转换图像

使用save()方法，我们可以将图像转换为其他格式。

convert2png.py 
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
#!/usr/bin/python3

from PIL import Image
import sys

try:
    tatras = Image.open("tatras.jpg")

except IOError:
    print("Unable to load image")
    sys.exit(1)

tatras.save('tatras.png', 'png')

该程序读取 JPG 图像并将其转换为 PNG 格式。

1
tatras.save('tatras.png', 'png')

save()方法的第二个参数指定图像格式。

灰度图像

使用Image.convert()方法，我们可以产生黑白图像。

grayscale.py 
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
#!/usr/bin/python3

from PIL import Image
import sys

try:
    tatras = Image.open("tatras.jpg")

except IOError:
    print("Unable to load image")
    sys.exit(1)

grayscale = tatras.convert('L')
grayscale.show()

该程序读取图像并将其转换为灰度图像。

1
grayscale = tatras.convert('L')

convert()方法的第一个参数是 mode； “ L”模式是黑白的。

用 Pillow 裁剪图像

Image.crop()裁剪图像。

crop_image.py 
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
#!/usr/bin/python3

from PIL import Image
import sys

try:
    tatras = Image.open("tatras.jpg")

except IOError:
    print("Unable to load image")
    sys.exit(1)

cropped = tatras.crop((100, 100, 350, 350))
cropped.save('tatras_cropped.jpg')

该程序将裁剪图像。 裁剪后的图像保存在磁盘上。

1
cropped = tatras.crop((100, 100, 350, 350))

crop()方法采用 4 个元组来定义左，上，右和下像素坐标。

用 Pillow 旋转图像

Image.rotate()返回图像的旋转副本。

rotate_image.py 
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
#!/usr/bin/python3

from PIL import Image
import sys

try:
    tatras = Image.open("tatras.jpg")

except IOError:
    print("Unable to load image")
    sys.exit(1)

rotated = tatras.rotate(180)
rotated.save('tatras_rotated.jpg')

该程序将图像旋转 180 度并将新创建的图像保存在磁盘上。

在 Tkinter 中显示图像

以下程序在 Tkinter 程序中显示图像。

show_tkinter.py 
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
#!/usr/bin/python3
# -*- coding: utf-8 -*-

from PIL import Image, ImageTk
from tkinter import Tk
from tkinter.ttk import Frame, Label
import sys

class Example(Frame):

    def __init__(self):
        super().__init__()   

        self.loadImage() 
        self.initUI()

    def loadImage(self):
        try:
            self.img = Image.open("tatrs.jpg")

        except IOError:
            print("Unable to load image")
            sys.exit(1)

    def initUI(self):

        self.master.title("Label")

        tatras = ImageTk.PhotoImage(self.img)
        label = Label(self, image=tatras)

        # reference must be stored
        label.image = tatras

        label.pack()
        self.pack()

    def setGeometry(self):

        w, h = self.img.size
        self.master.geometry(("%dx%d+300+300") % (w, h))

def main():

    root = Tk()
    ex = Example()
    ex.setGeometry()
    root.mainloop()  

if __name__ == '__main__':
    main()

该程序在 Tkinter 工具箱的Label小部件中显示图像。

1
from PIL import Image, ImageTk

ImageTk是 Tkinter 兼容的照片图像。 它可以在 Tkinter 需要图像对象的任何地方使用。

1
tatras = ImageTk.PhotoImage(self.img)

我们创建照片图像。

1
label = Label(self, image=tatras)

将照片图像提供给标签窗口小部件的image参数。

1
label.image = tatras

为了不被垃圾收集，必须存储图像参考。

1
2
w, h = self.img.size
self.master.geometry(("%dx%d+300+300") % (w, h))

窗口的大小适合图像大小。

从 URL 读取图像

下一个示例从 URL 读取图像。

read_from_url.py 
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
#!/usr/bin/python3

from PIL import Image
import requests
import sys

url = 'https://i.ytimg.com/vi/vEYsdh6uiS4/maxresdefault.jpg'

try:
    resp = requests.get(url, stream=True).raw

except requests.exceptions.RequestException as e:  
    sys.exit(1)

try:
    img = Image.open(resp)

except IOError:
    print("Unable to open image")
    sys.exit(1)

img.save('sid.jpg', 'jpeg')

该示例从 URL 读取图像并将其保存在磁盘上。

1
import requests

我们使用requests库下载图像。

1
resp = requests.get(url, stream=True).raw

我们将图像读取为原始数据。

1
img = Image.open(resp)

Image是从响应对象创建的。

1
img.save('sid.jpg', 'jpeg')

图像被保存。

Pillow 绘制图像

Pillow 具有一些基本的 2D 图形功能。 ImageDraw模块为Image对象提供简单的 2D 图形。 我们可以创建新图像，注释或修饰现有图像，以及即时生成图形以供 Web 使用。

draw2image.py 
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
#!/usr/bin/python3

from PIL import Image, ImageDraw

img = Image.new('RGBA', (200, 200), 'white')    
idraw = ImageDraw.Draw(img)

idraw.rectangle((10, 10, 100, 100), fill='blue')

img.save('rectangle.png')

该示例创建一个新图像，并在图像上绘制一个蓝色矩形。

1
img = Image.new('RGBA', (200, 200), 'white')

创建一个新的Image。 图像模式为“ RGBA”。 尺寸为 200×200，背景为白色。

1
idraw = ImageDraw.Draw(img)

根据图像，我们创建ImageDraw对象。 现在我们可以在图像上执行一些绘制操作。

1
idraw.rectangle((10, 10, 100, 100), fill='blue')

使用rectangle()方法，我们在图像上绘制了一个蓝色矩形。

用 Pillow 创建水印

以下示例创建一个水印。

watermark.py 
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
#!/usr/bin/python3

from PIL import Image, ImageDraw, ImageFont
import sys

try:
    tatras = Image.open("tatras.jpg")

except:
    print("Unable to load image")
    sys.exit(1)

idraw = ImageDraw.Draw(tatras)
text = "High Tatras"

font = ImageFont.truetype("arial.ttf", size=18)

idraw.text((10, 10), text, font=font)

tatras.save('tatras_watermarked.png')

我们使用ImageDraw模块创建水印。

1
font = ImageFont.truetype("arial.ttf", size=18)

我们创建 18 大小的 Arial 字体。

1
idraw.text((10, 10), text, font=font)

水印是通过text()方法创建的。 文本的默认颜色是白色。 我们使用创建的字体。

在本教程中，我们使用了 Python Pillow 库。