# Pillow Tutorial

**Repository Path**: liufumore/pillow-tutorial

## Basic Information

- **Project Name**: Pillow Tutorial
- **Description**: pillow库的讲义和教程
- **Primary Language**: Python
- **License**: Apache-2.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-07-31
- **Last Updated**: 2026-08-01

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 2026-Pillow 图像处理教程

> Python Pillow 图像处理从入门到高级的系列教程，包含完整的图文讲解、可运行的代码实例与配套 Jupyter Notebook。

![Python](https://img.shields.io/badge/Python-3.7%2B-blue) ![License](https://img.shields.io/badge/License-Apache%202.0-green)

Pillow 是 Python 生态中最流行的图像处理库，是经典 Python Imaging Library (PIL) 的友好分支。本项目以教程形式系统讲解 Pillow 的安装、基础操作、绘图、滤镜增强与高级合成，每章均配有中文图文文档、代码实例和可直接运行的 Jupyter Notebook。

---

## 目录结构

```
2026-Pillow/
├── 01-Pillow/            # 第1章 Pillow 导论
├── 02-Pillow/            # 第2章 Pillow 简介
├── 03-Pillow/            # 第3章 Pillow 安装
├── 04-Pillow/            # 第4章 Pillow 入门实例
├── 05-Pillow/            # 第5章 Pillow 图像基本操作
├── 06-Pillow/            # 第6章 Pillow 绘图与中文乱码处理
├── 07-Pillow/            # 第7章 Pillow 常用模块与方法
├── 08-Pillow/            # 第8章 Pillow 高级图像处理
├── PillowProject01/      # 实战练习项目（全部 Notebook 与输出图汇总）
├── LICENSE               # Apache License 2.0
└── README.md
```

---

## 章节内容

| 章节 | 文档 | 配套 Notebook | 核心内容 |
| :--- | :--- | :--- | :--- |
| 01 导论 | [pillow导论.md](01-Pillow/pillow导论.md) | pillow-01 | Pillow 是什么、与其他库对比、第一个实例 |
| 02 简介 | [Pillow简介.md](02-Pillow/Pillow简介.md) | — | 核心特点、19 个主要模块、与 PIL 对比、发展历史 |
| 03 安装 | [Pillow安装.md](03-Pillow/Pillow安装.md) | pillow-03 | pip / conda / 虚拟环境 / 源码安装、验证与排错 |
| 04 入门实例 | [Pillow入门实例.md](04-Pillow/Pillow入门实例.md) | pillow-04 | 打开/保存/格式转换、缩放裁剪旋转、滤镜、绘制、缩略图+水印 |
| 05 基本操作 | [Pillow图像基本操作.md](05-Pillow/Pillow图像基本操作.md) | pillow-05 | 12 项综合实例：翻转、灰度、增强、合并、多格式多质量保存 |
| 06 绘图中文 | [Pillow绘图中文乱码.md](06-Pillow/Pillow绘图中文乱码.md) | pillow-06 | 中文字体加载、居中/多行排版、文字样式、水印、海报制作 |
| 07 常用模块 | [Pillow常用模块与方法.md](07-Pillow/Pillow常用模块与方法.md) | pillow-07 | 19 个模块功能速查表与常用方法示例 |
| 08 高级处理 | [Pillow高级图像处理.md](08-Pillow/Pillow高级图像处理.md) | pillow-08 | 自定义卷积核、Sobel/USM 边缘检测、混合模式、蒙版与复杂合成 |

### 08 高级图像处理亮点

- **滤镜与增强**：内置滤镜、ImageEnhance 四要素增强、自定义卷积核（锐化/浮雕/高斯模糊）
- **边缘检测**：Sobel 算子、USM 高频增强锐化
- **绘制与文字**：基本图形、复杂形状、字体样式与描边
- **图像合成**：paste 叠加、blend 混合、alpha 通道处理、多种混合模式（正片叠底、滤色、叠加等）
- **蒙版应用**：径向/水平/垂直渐变蒙版、多边形蒙版、文本蒙版、棋盘格/噪点/流体等图案混合

---

## 环境要求

- Python 3.7 或更高版本
- Pillow（安装方式见 [第3章](03-Pillow/Pillow安装.md)）

```bash
pip install pillow
```

如需运行涉及自定义卷积核的示例，另需安装 NumPy：

```bash
pip install numpy
```

---

## 快速开始

### 方式一：运行 Jupyter Notebook（推荐）

```bash
pip install jupyter
jupyter notebook PillowProject01/pillow-04.ipynb
```

逐章执行：

```bash
jupyter notebook PillowProject01/   # 打开全部 8 个实战 Notebook
```

### 方式二：运行文档中的代码实例

每个章节的 Markdown 文档都包含完整的可直接运行的代码，以第 4 章为例：

```python
from PIL import Image, ImageEnhance

# 打开图像
img = Image.open("04-Pillow/img/tiger.jpeg")

# 图像信息
print("格式:", img.format, "尺寸:", img.size, "模式:", img.mode)

# 滤镜与增强
blurred = img.filter(ImageFilter.BLUR)          # 模糊
bright = ImageEnhance.Brightness(img).enhance(1.5)  # 提亮 50%

# 保存
img.save("example.png")
```

> 测试图片 `tiger.jpeg` 位于 [04-Pillow/img/](04-Pillow/img/) 与 [PillowProject01/](PillowProject01/)，可直接复制到工作目录使用。

---

## 实战项目 PillowProject01

[PillowProject01/](PillowProject01/) 汇总了全部章节的实战代码与产物：

- **Notebook**：`pillow-01` ~ `pillow-08`，与章节一一对应
- **测试图片**：tiger.jpeg、test.jpg 及多张示例图
- **输出目录** [output/](PillowProject01/output/)：裁剪、旋转、翻转、滤镜、格式转换等 17 张处理结果
- **综合成果**：带水印照片、活动海报、中文输出、缩略图等

---

## 相关资源

- [Pillow 官网](https://python-pillow.github.io/)
- [Pillow 官方文档](https://pillow.readthedocs.io/en/stable/)
- [Pillow GitHub 仓库](https://github.com/python-pillow/Pillow)

---

## 许可证

本项目基于 [Apache License 2.0](LICENSE) 开源。