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 顺序不同,互转时要核对。