深入探索 Python Pillow：ImageDraw 模块全方位实战指南

2026-02-09 04:42:11 0条评论 2次阅读 0人点赞

在日常的图像处理任务中，我们经常不仅需要编辑现有的图片，还需要从零开始创建图形，或者在图片上添加标注、水印和几何形状。虽然 Python 的 Pillow 库以其强大的图像处理能力著称，但许多开发者往往只停留在简单的裁剪和滤镜上，而忽略了它内置的绘图引擎。这正是 ImageDraw 模块大显身手的地方。

在这篇文章中，我们将深入探索 Pillow 的 ImageDraw 模块。我们将学习如何利用它直接在图像上绘制各种形状、线条以及格式化的文本。无论你是想为 Web 应用生成动态验证码，还是为数据可视化添加自定义图例，亦或是批量处理照片水印，掌握这个模块都将极大地扩展你的图像处理工具箱。让我们抛开那些枯燥的理论，直接通过实际的代码示例，看看我们能用它创造出什么。

1 准备工作：理解绘图上下文
2 创建绘图对象
3 绘制矩形：构建视觉区块
4 绘制椭圆与圆形：几何之美
5 绘制线条：连接与指引
6 绘制多边形：封闭区域
7 进阶形状：圆弧、弓形与饼图
8 在图像上书写文字：水印与标注
9 总结与最佳实践

准备工作：理解绘图上下文

在开始动笔之前，我们需要先准备好“画布”。在 Pillow 的世界里，一切绘图操作都发生在一个“图像对象”上。但是，图像对象本身只负责存储像素数据，它并不知道如何画线或画圆。这就是为什么我们需要引入 ImageDraw 模块的原因。

你可以把 ImageDraw 想象成一组手持画笔的指令集。为了让这些指令生效，我们必须明确告诉它们：“请在这张特定的纸上作画”。这个过程我们称之为“创建绘图对象”。

让我们先加载一张图片，并在这个基础上进行操作。假设我们有一张名为 example.png 的图片（为了演示方便，你可以准备一张纯色或风景照）。

from PIL import Image, ImageDraw

# 打开本地图像文件
# 注意：请确保图片路径正确，或者使用绝对路径
img = Image.open("example.png")

# 显示原始图像
display(img.show())

> 实战提示：在进行任何绘图操作前，强烈建议保留原始图像对象的副本。因为 Pillow 的大多数操作都是直接修改内存中的像素对象，一旦绘制完成，原始背景就被覆盖了，无法轻易撤销（除非你重新加载图片）。

创建绘图对象

正如我们在前面提到的，要执行任何绘图操作，我们必须先创建一个与目标图像关联的 Draw 对象。这就像是在画布上方覆盖了一层透明的胶片，我们所有的笔触都会印在这层胶片上，并最终融合到下方的图像中。

# 创建绘图对象，将其与我们的图像关联
draw = ImageDraw.Draw(img)

现在，变量 INLINECODE7ced00c5 就成了我们的画笔。后续所有的形状、线条和文字，都将通过调用这个对象的方法来实现。INLINECODEf7ce8f9e 模块提供了丰富的方法，让我们从最基础的形状开始。

绘制矩形：构建视觉区块

矩形是计算机图形学中最基础的形状之一，常用于绘制按钮边框、背景色块或高亮区域。在 Pillow 中，我们可以使用 rectangle() 方法来实现。

语法解析

ImageDraw.rectangle(xy, fill=None, outline=None, width=1)

xy: 这是一个关键参数。它接受一个元组 INLINECODE97beadff，分别定义了矩形左上角和右下角的坐标。请注意，坐标系的原点 INLINECODE65c1d28b 位于图像的左上角，X 轴向右增长，Y 轴向下增长。
fill: 定义矩形内部填充的颜色。我们可以使用字符串（如 INLINECODE09ed39c4）或 RGB 元组（如 INLINECODE6c194455）。如果留空，矩形将是透明的。
outline: 定义矩形边框的颜色。
width: 定义边框的粗细，默认为 1 个像素。

代码示例

让我们在图像上绘制一个绿色的矩形，并加上白色的边框。

from PIL import Image, ImageDraw

# 为了演示，我们创建一个白色的空白画布
img = Image.new("RGB", (400, 400), "white")
draw = ImageDraw.Draw(img)

# 定义矩形坐标 (left, top, right, bottom)
shape = (50, 50, 300, 300)

# 绘制矩形
# fill: (0, 127, 0) 是一种深绿色
# outline: (255, 255, 255) 是白色
draw.rectangle(
    xy=shape,
    fill=(0, 127, 0),
    outline=(255, 255, 255),
    width=5
)

img.show()

运行结果解析：你将看到一个 300×300 像素的深绿色方块，带有 5 像素宽的白色边框。这种技术常用于在图片上创建带有圆角（需要结合遮罩）或直角的半透明覆盖层。

绘制椭圆与圆形：几何之美

圆形和椭圆通常用于强调图像中的某个部分，或者仅仅是为了装饰。Pillow 使用同一个方法 ellipse() 来处理这两种形状，区别完全取决于你定义的边界框。

核心概念：边界框

INLINECODE7f70e200 方法并不直接让你定义圆心和半径，而是让你定义一个边界框（Bounding Box）。想象有一个矩形框，圆或椭圆就被“挤压”在这个框内。如果你传入的 INLINECODEa425be32 参数是一个正方形（宽高相等），那么画出来的就是一个完美的圆形；如果是长方形，画出来的就是椭圆。

代码示例

from PIL import Image, ImageDraw

img = Image.new("RGB", (400, 400), "white")
draw = ImageDraw.Draw(img)

# 情况 1: 绘制正圆（使用正方形边界框）
# 坐标 (50, 50, 150, 150) 宽高都是 100
draw.ellipse(
    xy=(50, 50, 150, 150),
    fill=(0, 127, 0),
    outline="blue",
    width=5
)

# 情况 2: 绘制椭圆（使用长方形边界框）
# 坐标 (200, 50, 380, 150) 宽 180, 高 100
draw.ellipse(
    xy=(200, 50, 380, 150),
    fill="lightblue",
    outline="purple",
    width=3
)

img.show()

应用场景：这种技术在制作仪表盘界面或给人像照片添加“聚光灯”效果时非常有用。

绘制线条：连接与指引

线条是构建复杂图形的基石。INLINECODEeb412de7 提供了 INLINECODE80777366 方法，它可以绘制直线段。虽然听起来简单，但它是绘制箭头、折线图甚至复杂多边形的必要组成部分。

语法解析

ImageDraw.line(xy, fill=None, width=0)

注意，这里的 INLINECODE5afa3aed 参数不再是两个点，而是一个包含至少两个坐标点的序列 INLINECODEc2d42189。方法会按顺序连接这些点。如果 xy 中只有两个点，它就是一条直线；如果有多个点，它就是一条折线。

joint 参数（在较新版本中可用）：控制线条连接处的样式（如圆形连接或斜角连接），这能让折线的转角更平滑。

代码示例

from PIL import Image, ImageDraw

img = Image.new("RGB", (300, 300), "white")
draw = ImageDraw.Draw(img)

# 绘制一条简单的直线
draw.line(
    xy=(50, 50, 250, 50), # 从 (50,50) 到 (250,50)
    fill="black",
    width=2
)

# 绘制一条折线（包含三个点）
draw.line(
    xy=[(50, 100), (150, 200), (250, 100)],
    fill="red",
    width=5
)

img.show()

绘制多边形：封闭区域

多边形是由至少三条线段组成的封闭形状。与折线不同的是，多边形会自动将最后一个点连接回第一个点，从而形成一个可填充的区域。

语法与注意事项

ImageDraw.polygon(xy, fill=None, outline=None)

注意：在 INLINECODE47d7b361 方法中，INLINECODE6a295f11 参数通常是被忽略的（取决于 Pillow 版本），因此边框的宽度默认为 1 个像素。如果你需要很粗的边框，可能需要先用粗线条绘制，再填充颜色，或者升级到最新版本的 Pillow 查看支持情况。

代码示例：绘制菱形

from PIL import Image, ImageDraw

img = Image.new("RGB", (300, 300), "white")
draw = ImageDraw.Draw(img)

# 定义菱形的四个顶点
points = [(150, 50), (250, 150), (150, 250), (50, 150)]

draw.polygon(
    xy=points,
    fill=(255, 165, 0), # 橙色
    outline=(0, 0, 0)     # 黑色边框
)

img.show()

进阶形状：圆弧、弓形与饼图

除了基础形状，ImageDraw 还提供了更高级的几何绘图能力，主要用于数据可视化或绘制特殊的 UI 元件。

1. Arc (圆弧)

圆弧是椭圆的一部分。

ImageDraw.arc(xy, start, end, fill=None, width=1)

start, end: 起始角度和结束角度（0-360度）。

2. Chord (弓形)

弓形是一条圆弧及其两端点连线围成的区域。

ImageDraw.chord(xy, start, end, fill=None, outline=None, width=1)

3. Pieslice (饼形扇区)

这就像我们吃的披萨的一角。

ImageDraw.pieslice(xy, start, end, fill=None, outline=None, width=1)

综合示例

from PIL import Image, ImageDraw

img = Image.new("RGB", (400, 400), "white")
draw = ImageDraw.Draw(img)

# 定义边界框
bbox = (50, 50, 350, 350)

# 绘制一个 0 到 90 度的饼图
draw.pieslice(
    xy=bbox,
    start=0,
    end=90,
    fill="lightblue",
    outline="black",
    width=2
)

img.show()

在图像上书写文字：水印与标注

语法解析

ImageDraw.text(xy, text, fill=None, font=None, anchor=None)

font: 这是一个 ImageFont 对象。如果你不提供它，Pillow 将使用默认的位图字体（非常小且难看）。为了获得最佳效果，我们几乎总是需要加载 TrueType 字体。

实战：加载字体并绘制文字

在 Pillow 中加载字体需要使用 ImageFont 模块。为了确保代码在不同系统上都能运行，我们可以尝试加载系统自带字体，或者处理字体未找到的异常。

from PIL import Image, ImageDraw, ImageFont
import os

# 创建一个深色背景的图片，这样白色文字更清晰
img = Image.new("RGB", (600, 200), color="#333333")
draw = ImageDraw.Draw(img)

# --- 字体加载策略 ---
# 尝试加载字体，这里使用 Windows 常见的 Arial 字体作为示例
# 在实际部署中，建议将 .ttf 文件随脚本一起部署
font_path = "arial.ttf" 
font_size = 36

try:
    # 加载 TrueType 字体
    font = ImageFont.truetype(font_path, font_size)
except IOError:
    # 如果找不到字体文件，回退到默认字体（注意：默认字体不支持 size 参数调整）
    print("警告：未找到指定字体文件，将使用默认字体。")
    font = ImageFont.load_default()

# --- 文字绘制 ---
text_content = "Hello, Pillow! 你好，Python。"

# anchor="mm" 表示使用文本的中心点作为坐标参考
# 这样文字 (300, 100) 就会正好位于图片中心
draw.text(
    xy=(300, 100),
    text=text_content,
    font=font,
    fill="#00FF00", # 亮绿色
    anchor="mm"
)

img.show()

常见错误与解决方案

字体找不到 (INLINECODE6987f284)：这是最常见的问题。在 Linux 服务器上，通常没有像 Windows 那样的 Arial 字体。解决方法是将 INLINECODEcd271522 字体文件放在你的项目文件夹中，并使用相对路径加载。
文字乱码：如果你的字体不支持中文字符集（例如使用纯英文字体渲染中文），文字就会显示为方框（□）。解决方法是确保加载的 .ttf 文件包含中文 Glyphs（如 SimHei, SimKai 等）。

总结与最佳实践

通过这篇文章，我们系统地学习了如何使用 Python 的 Pillow 库中的 ImageDraw 模块。从简单的矩形、圆形到复杂的文字渲染，我们现在拥有了在代码中自动生成和修改图像内容的强大能力。

关键要点回顾：

Draw 对象：永远记得先创建 ImageDraw.Draw(img) 对象。
坐标系统：牢记 (0,0) 在左上角，所有的形状绘制都基于边界框或坐标点列表。
颜色处理：熟练使用 RGB 元组 (r, g, b) 来控制填充和边框颜色。
字体管理：在处理文字时，显式加载 TrueType 字体是保证视觉效果一致性的关键。

下一步建议：

既然你已经掌握了静态绘图，我建议你尝试结合 Pillow 的 ImageEnhance 模块，或者尝试编写一个简单的脚本，自动为一整个文件夹的图片添加带有透明度的 Logo 水印。这将是对你所学知识的一次极好的实战演练。祝你在 Python 图形编程的道路上玩得开心！

投稿给我们	如何建站？
vps是什么？	如何安装宝塔？
如何通过博客赚钱？	便宜wordpress托管方案
免费wordpress主题	这些都是免费方案

豆丁博客

深入探索 Python Pillow：ImageDraw 模块全方位实战指南

准备工作：理解绘图上下文

创建绘图对象

绘制矩形：构建视觉区块

语法解析

代码示例

绘制椭圆与圆形：几何之美

核心概念：边界框

代码示例

绘制线条：连接与指引

语法解析

代码示例

绘制多边形：封闭区域

语法与注意事项

代码示例：绘制菱形

进阶形状：圆弧、弓形与饼图

1. Arc (圆弧)

2. Chord (弓形)

3. Pieslice (饼形扇区)

综合示例

在图像上书写文字：水印与标注

语法解析

实战：加载字体并绘制文字

常见错误与解决方案

总结与最佳实践

相关文章美国1G带宽/1T流量高速vps $17.99/年