Pillow

Python 图像处理库,安装名为 Pillow,导入路径为 PIL。

安装与准备

python -m pip install Pillow
from PIL import Image, ImageOps, ImageDraw

# 生成一张测试图;已有 input.png 时可跳过这一行
Image.new("RGB", (640, 480), "#dbeafe").save("input.png")

先运行以上准备代码,后续示例按顺序使用 input.png 和读入的 image。

常用用法

打开、检查与保存

with Image.open("input.png") as source:
    print(source.size, source.mode, source.format)
    image = source.convert("RGB")

image.save("output.jpg", quality=90)

size 是 (宽, 高);convert 创建转换后的图像,可在文件关闭后继续使用。见图像教程。

缩放与缩略图

resized = image.resize((320, 240), resample=Image.Resampling.LANCZOS)
resized.save("resized.png")

thumb = image.copy()
thumb.thumbnail((160, 160), resample=Image.Resampling.LANCZOS)
thumb.save("thumbnail.png")
print(thumb.size)  # 本例为 (160, 120)

resize 按给定尺寸生成新图,可能改变比例;thumbnail 保持比例、只缩小,并原地修改图像。

裁剪、旋转与颜色转换

crop = image.crop((80, 60, 400, 300))  # 左、上、右、下;不包含右下边界
rotated = image.rotate(30, expand=True)
gray = image.convert("L")            # 灰度
rgba = image.convert("RGBA")         # 带透明通道
crop.save("crop.png")

expand=True 扩大旋转后的画布,避免仅保留原画布范围。

与 NumPy 数组互转

此小节另需 python -m pip install numpy。

import numpy as np

pixels = np.array(image)  # 创建可写副本,RGB 图像为 (高, 宽, 3)
pixels[0, 0] = [255, 0, 0]
changed = Image.fromarray(pixels)
changed.save("red-pixel.png")

数组使用 (高, 宽, 通道),与 Pillow 的 (宽, 高) 次序不同。

进阶与不常用用法

纠正手机照片的 EXIF 方向

with Image.open("input.png") as source:
    upright = ImageOps.exif_transpose(source).convert("RGB")
upright.save("upright.jpg", quality=90)

有些照片依赖 EXIF 标签描述方向,读入后先纠正再处理;见 exif_transpose。

半透明图层叠加

base = image.convert("RGBA")
overlay = Image.new("RGBA", base.size, (0, 0, 0, 0))
draw = ImageDraw.Draw(overlay)
draw.rectangle((20, 20, 200, 100), fill=(30, 80, 150, 120))
combined = Image.alpha_composite(base, overlay)
combined.save("overlay.png")

两张图需要尺寸一致,且为相同的 RGBA 或 LA 模式;见 alpha_composite。

固定尺寸封面:裁切或补边

cover = ImageOps.fit(image, (300, 300), method=Image.Resampling.LANCZOS)
padded = ImageOps.pad(
    image, (300, 300), method=Image.Resampling.LANCZOS, color="white",
)
cover.save("cover.png")
padded.save("padded.png")

fit 保持比例并裁切以填满;pad 保持比例、补边保留完整内容。见ImageOps。

易错点

  • thumbnail() 原地修改并返回 None,不要写 image = image.thumbnail(...)。
  • JPEG 不保留透明通道。需要透明时保存 PNG;要白底 JPEG 时先把透明图合成到白色背景上。
  • 文件关闭后还要使用原图时,应在上下文内 .copy() 或转换并加载数据。
  • Pillow 的 RGB 通道顺序与 OpenCV 常见的 BGR 顺序不同,互转时要核对。

官方文档

应用于项目

手写数字识别 从 NumPy 核心实现到 PyTorch 对照,按六阶段组织手写数字识别的模块、知识与实践。