Pillow ImageOps 模块
下面给你一个 Pillow（PIL Fork）中 ImageOps 模块 的完整入门指南，包含所有核心功能、参数详解、代码示例、批量处理、高级技巧及常见应用场景。
（基于 Pillow ≥ 9.0，Python 3.8+）
1. 安装 Pillow
pip install --upgrade pillow2. 基本导入
from PIL import Image, ImageOps3. ImageOps 核心功能一览
| 函数 | 作用 | 关键参数 |
|---|---|---|
invert(img) | 反相（负片效果） | 无 |
grayscale(img) | 转灰度图 | 无 |
posterize(img, bits) | 色阶减少（海报化） | bits（1~8） |
solarize(img, threshold=128) | 曝光过度效果 | threshold |
equalize(img, mask=None) | 直方图均衡化 | mask 可局部 |
autocontrast(img, cutoff=0, ignore=None) | 自动对比度 | cutoff 百分比 |
flip(img) | 上下翻转 | 无 |
mirror(img) | 左右镜像 | 无 |
crop(img, border) | 裁剪边框 | border（左、上、右、下） |
pad(img, size, method=..., color=..., centering=...) | 智能填充 | 多种方法 |
fit(img, size, method=..., bleed=0, centering=...) | 智能缩放+裁剪 | 适配尺寸 |
expand(img, border, fill=0) | 扩展画布 | border 四元组 |
deform(img, deformer, ...) | 几何变形 | 自定义 |
exif_transpose(img) | 自动按 EXIF 旋转 | 无 |
4. 基础用法示例
img = Image.open("photo.jpg")
# 灰度 + 反相
gray = ImageOps.grayscale(img)
inverted = ImageOps.invert(gray)
# 自动对比度
auto = ImageOps.autocontrast(img, cutoff=2)
# 海报化（减少颜色）
poster = ImageOps.posterize(img, bits=3) # 2^3 = 8 种颜色/通道
# 上下翻转
flipped = ImageOps.flip(img)
# 左右镜像
mirrored = ImageOps.mirror(img)
inverted.save("inverted.jpg")5. 核心函数详解 + 示例
5.1 autocontrast 自动对比度
# 去除最亮/最暗 2% 像素
enhanced = ImageOps.autocontrast(img, cutoff=2)
# 忽略背景色（如纯白）
enhanced = ImageOps.autocontrast(img, ignore=(255, 255, 255))5.2 equalize 直方图均衡化
equalized = ImageOps.equalize(img) # 增强暗部细节
# 局部均衡化（只处理人脸）
mask = Image.new("L", img.size, 0)
draw = ImageDraw.Draw(mask)
draw.rectangle((100, 100, 300, 300), fill=255)
local_eq = ImageOps.equalize(img, mask=mask)5.3 fit 智能适配（缩放+裁剪）
# 缩放到 800x600，居中裁剪
thumbnail = ImageOps.fit(img, (800, 600), method=Image.LANCZOS, centering=(0.5, 0.5))5.4 pad 智能填充（保持比例）
# 填充到 1000x1000，背景色 #f0f0f0，居中
padded = ImageOps.pad(img, (1000, 1000), color="#f0f0f0", centering=(0.5, 0.5))
method选项：
Image.NEAREST,BILINEAR,BICUBIC,LANCZOS（推荐）
6. 高级技巧
6.1 批量处理 + 自动旋转
import os
from PIL import Image, ImageOps
def batch_process(input_dir, output_dir):
os.makedirs(output_dir, exist_ok=True)
for f in os.listdir(input_dir):
if f.lower().endswith(('.jpg', '.jpeg', '.png')):
path = os.path.join(input_dir, f)
img = Image.open(path)
# 自动按 EXIF 旋转
img = ImageOps.exif_transpose(img)
# 自动对比度 + 锐化
img = ImageOps.autocontrast(img, cutoff=1)
img = img.filter(ImageFilter.SHARPEN)
img.save(os.path.join(output_dir, f), quality=95)
batch_process("raw", "processed")6.2 制作九宫格（pad + fit）
def make_grid(images, grid_size=(3,3), cell_size=(300,300), bg="white"):
w, h = grid_size
canvas = Image.new("RGB", (w*cell_size[0], h*cell_size[1]), bg)
for i, img in enumerate(images[:w*h]):
resized = ImageOps.fit(img, cell_size, Image.LANCZOS)
x = (i % w) * cell_size[0]
y = (i // w) * cell_size[1]
canvas.paste(resized, (x, y))
return canvas6.3 艺术效果：曝光 + 海报化
def artistic_effect(img):
# 1. 曝光
solar = ImageOps.solarize(img, threshold=100)
# 2. 海报化
poster = ImageOps.posterize(solar, bits=4)
# 3. 反相
return ImageOps.invert(poster.convert("L")).convert("RGB")7. 完整示例：一键美化 + 缩略图
from PIL import Image, ImageOps, ImageFilter
def smart_thumbnail(input_path, size=(800, 600), output_path=None):
img = Image.open(input_path)
# 1. 自动旋转
img = ImageOps.exif_transpose(img)
# 2. 自动对比度
img = ImageOps.autocontrast(img, cutoff=1)
# 3. 智能适配（缩放+裁剪）
img = ImageOps.fit(img, size, method=Image.LANCZOS)
# 4. 轻微锐化
img = img.filter(ImageFilter.SHARPEN)
output = output_path or f"thumb_{size[0]}x{size[1]}_{os.path.basename(input_path)}"
img.save(output, quality=90, optimize=True)
print(f"已保存: {output}")
# 使用
smart_thumbnail("DSC_1234.jpg", (800, 600))8. exif_transpose 自动旋转（手机照片必备）
img = Image.open("iphone_photo.jpg") # 横拍但显示竖直
correct = ImageOps.exif_transpose(img) # 自动纠正方向
correct.save("fixed.jpg")常见 EXIF Orientation 值：
- 1: 正常
- 3: 180°
- 6: 顺时针 90°
- 8: 逆时针 90°
9. 常见问题 & 解决方案
| 问题 | 原因 | 解决 |
|---|---|---|
autocontrast 没效果 | 图像动态范围已饱和 | 先 equalize 再 autocontrast |
fit 变形 | 原图比例与目标不符 | 使用 fit（裁剪）而非 thumbnail（拉伸） |
invert 报错 | 图像不是 RGB 或 L | 先 img.convert("RGB") |
exif_transpose 没旋转 | 图片无 EXIF 或被清除 | 使用 piexif 手动处理 |
10. 官方文档
- https://pillow.readthedocs.io/en/stable/reference/ImageOps.html
一键脚本：imageops_tool.py
#!/usr/bin/env python3
import argparse
from PIL import Image, ImageOps
def main():
parser = argparse.ArgumentParser(description="ImageOps 工具箱")
parser.add_argument("input")
parser.add_argument("-o", "--output")
parser.add_argument("--flip", action="store_true")
parser.add_argument("--mirror", action="store_true")
parser.add_argument("--invert", action="store_true")
parser.add_argument("--gray", action="store_true")
parser.add_argument("--auto", action="store_true", help="自动对比度")
parser.add_argument("--fit", nargs=2, type=int, metavar=('W','H'))
args = parser.parse_args()
img = Image.open(args.input)
img = ImageOps.exif_transpose(img)
if args.gray: img = ImageOps.grayscale(img)
if args.invert: img = ImageOps.invert(img.convert("RGB"))
if args.flip: img = ImageOps.flip(img)
if args.mirror: img = ImageOps.mirror(img)
if args.auto: img = ImageOps.autocontrast(img, cutoff=1)
if args.fit: img = ImageOps.fit(img, args.fit, Image.LANCZOS)
output = args.output or args.input
img.save(output, quality=95)
print(f"处理完成: {output}")
if __name__ == "__main__":
main()使用示例：
python imageops_tool.py photo.jpg --auto --fit 800 600 -o thumb.jpg需要我帮你实现 自动证件照、九宫格拼接、艺术海报生成、智能裁剪人像 等功能吗？直接说需求，我给你完整代码！