Pillow ImageFont 模块
ImageFont 模块则是 Pillow 中专门用于处理字体和文本渲染的核心组件。
ImageFont 模块允许开发者在图像上添加各种风格的文本内容，是进行图像标注、生成验证码、创建水印等功能的必备工具。
核心功能
ImageFont 模块主要提供以下功能：
- 加载 TrueType 和 OpenType 字体文件
- 创建字体对象并设置字体大小
- 计算文本在图像中的尺寸和布局
- 与
ImageDraw模块配合实现文本渲染
主要方法详解
以下是 ImageFont 模块中最常用的方法及其说明：
| 方法名称 | 参数说明 | 返回值 | 功能描述 |
|---|---|---|---|
truetype(font=None, size=10, index=0, encoding='', layout_engine=None) |
font: 字体文件路径size: 字体大小(像素)index: 字体索引encoding: 编码方式layout_engine: 布局引擎 |
ImageFont 对象 |
加载 TrueType 或 OpenType 字体文件 |
load(filename) |
filename: 字体文件路径 |
ImageFont 对象 |
加载位图字体(PIL 专用格式) |
load_path(filename) |
filename: 字体文件路径 |
ImageFont 对象 |
从指定路径加载字体文件 |
getsize(text, direction=None, features=None, language=None) |
text: 要测量的文本direction: 文本方向features: OpenType 特性language: 语言代码 |
(width, height) 元组 | 获取文本渲染后的尺寸 |
getmask(text, mode='', direction=None, features=None, language=None) |
同上 | Image 对象 |
获取文本的位图掩码 |
getbbox(text, direction=None, features=None, language=None) |
同上 | (left, top, right, bottom) 元组 | 获取文本的边界框 |
基本使用示例
加载字体并绘制文本
实例
from PIL import Image, ImageDraw, ImageFont
# 创建一个空白图像
image = Image.new('RGB', (400, 200), color='white')
# 加载字体
font = ImageFont.truetype('arial.ttf', size=40)
# 创建绘图对象
draw = ImageDraw.Draw(image)
# 绘制文本
draw.text((50, 80), 'Hello Pillow!', font=font, fill='black')
# 保存图像
image.save('text_image.png')
# 创建一个空白图像
image = Image.new('RGB', (400, 200), color='white')
# 加载字体
font = ImageFont.truetype('arial.ttf', size=40)
# 创建绘图对象
draw = ImageDraw.Draw(image)
# 绘制文本
draw.text((50, 80), 'Hello Pillow!', font=font, fill='black')
# 保存图像
image.save('text_image.png')
获取文本尺寸
实例
text = "Sample Text"
width, height = font.getsize(text)
print(f"文本宽度: {width}, 文本高度: {height}")
width, height = font.getsize(text)
print(f"文本宽度: {width}, 文本高度: {height}")
高级特性
使用 OpenType 特性
实例
font = ImageFont.truetype('arial.ttf', size=40)
draw.text((50, 80), 'Hello', font=font, fill='black', features=['-liga'])
draw.text((50, 80), 'Hello', font=font, fill='black', features=['-liga'])
多语言支持
实例
# 中文文本渲染
font = ImageFont.truetype('msyh.ttc', size=30)
draw.text((50, 120), '你好，世界!', font=font, fill='blue')
font = ImageFont.truetype('msyh.ttc', size=30)
draw.text((50, 120), '你好，世界!', font=font, fill='blue')
文本方向控制
实例
# 从右到左的文本
draw.text((300, 80), 'سلام', font=font, fill='red', direction='rtl')
draw.text((300, 80), 'سلام', font=font, fill='red', direction='rtl')
注意事项
- 字体文件路径：确保提供的字体文件路径正确，否则会抛出
IOError - 字体大小：字体大小以像素为单位，不是点(pt)
- 性能考虑：频繁创建字体对象会影响性能，建议复用字体对象
- 跨平台兼容性：不同操作系统可能默认安装的字体不同，部署时需考虑字体打包
总结
ImageFont 模块为 Python 图像处理提供了强大的文本渲染能力。通过合理使用这个模块，开发者可以轻松实现各种文本相关的图像处理需求。掌握 ImageFont 的使用是进行专业级图像处理的重要一步。
点我分享笔记