Python-Pillow 图像处理：深入理解文本锚点(anchor)参数

符汝姿

于 2025-06-03 09:03:40 发布

阅读量390

点赞数 4

CC 4.0 BY-SA版权

本文链接：https://blog.youkuaiyun.com/gitblog_00802/article/details/148392487

Python-Pillow 图像处理：深入理解文本锚点(anchor)参数

Pillow Python Imaging Library (Fork) 项目地址: https://gitcode.com/gh_mirrors/pi/Pillow

文本锚点概述

在Python-Pillow库中，ImageDraw.text()方法的anchor参数是一个强大但容易被忽视的功能，它决定了绘制文本时相对于给定坐标点(xy)的对齐方式。理解这个参数对于实现精确的文本布局至关重要。

默认情况下，Pillow使用左上角对齐方式：

水平文本：la（左-上升对齐）
垂直文本：lt（左-顶对齐）

需要注意的是，锚点功能仅支持OpenType/TrueType字体，其他类型字体可能会忽略此参数而使用默认对齐方式。

锚点参数详解

锚点参数由一个两字符的字符串组成，第一个字符表示水平对齐方式，第二个字符表示垂直对齐方式。

水平对齐选项

| 代码 | 说明 | |------|------| | l | 左对齐 - 锚点在文本左侧 | | m | 居中对齐 - 锚点在文本水平中心 | | r | 右对齐 - 锚点在文本右侧 | | s | 基线对齐（仅垂直文本） |

垂直对齐选项

| 代码 | 说明 | |------|------| | a | 上升线对齐（仅水平文本）- 锚点在首行文本的上升线 | | t | 顶部对齐（单行文本）- 锚点在文本顶部 | | m | 居中对齐 - 锚点在文本垂直中心 | | s | 基线对齐（仅水平文本）- 锚点在首行文本的基线 | | b | 底部对齐（单行文本）- 锚点在文本底部 | | d | 下降线对齐（仅水平文本）- 锚点在末行文本的下降线 |

实际应用示例

让我们通过一个具体例子来理解锚点的工作原理：

from PIL import Image, ImageDraw, ImageFont

# 创建画布和绘图对象
font = ImageFont.truetype("NotoSans-Regular.ttf", 48)
im = Image.new("RGB", (200, 200), "white")
d = ImageDraw.Draw(im)

# 绘制参考线
d.line(((0, 100), (200, 100)), "gray")  # 水平线
d.line(((100, 0), (100, 200)), "gray")  # 垂直线

# 使用ms(中-基线)对齐方式绘制文本
d.text((100, 100), "Quick", fill="black", anchor="ms", font=font)

在这个例子中：