Pillow: искажённый китайский текст при рисовании

Добавление текста на изображение — распространённое требование в обработке изображений, например добавление водяных знаков на изображения, создание постеров и т. д. Pillow предоставляетImageDrawмодуль для реализации этой функциональности.

Основные шаги

Основные шаги для добавления текста на изображение следующие:

  1. Открыть или создать изображение
  2. Создать объект ImageDraw
  3. Указать шрифт
  4. Используйтеtext()метод для добавления текста
  5. Сохраните изображение

Пример

Пример

from PIL import Image, ImageDraw, ImageFont

# 1. Создайте новое изображение
image = Image.new('RGB', (400, 200), color=(255, 255, 255))

# 2. Создайте объект ImageDraw
draw = ImageDraw.Draw(image)

# 3. Укажите шрифт (здесь используется шрифт по умолчанию)
# Примечание: шрифт по умолчанию может не поддерживать китайские символы
font = ImageFont.load_default()

# 4. Добавьте текст
draw.text((10, 10), "Hello, Pillow!", fill="black", font=font)

# 5. Сохраните изображение
image.save('output.png')

Добавление китайских шрифтов

По умолчанию стандартный шрифт Pillow не поддерживает китайские символы.

Чтобы добавить китайский текст на изображение, нам нужно использовать файл шрифта, поддерживающий китайский язык (обычно в формате .ttf или .otf).

Получение китайских шрифтов

Китайские шрифты можно получить из следующих источников:

  1. Используйте китайские шрифты, входящие в систему (например, simsun.ttc в Windows)

  2. Скачайте с сайтов бесплатных шрифтов (например, Source Han Sans, Alibaba PuHuiTi и т. д.).

  3. Покупайте коммерческие шрифты (обратите внимание на вопросы авторского права)

Скачивание библиотеки китайских шрифтов с открытым исходным кодом:https://github.com/wordshub/free-font。

Пример кода использования китайских шрифтов

Пример

from PIL import Image, ImageDraw, ImageFont

# 1. Создайте новое изображение
image = Image.new('RGB', (400, 200), color=(255, 255, 255))

# 2. Создайте объект ImageDraw
draw = ImageDraw.Draw(image)

# 3. Укажите китайский шрифт
# Примечание: замените его путем к файлу шрифта, который существует в вашей системе
font_path = "SimHei.ttf"  # Путь к шрифту SimHei
font_size = 20
font = ImageFont.truetype(font_path, font_size)

# 4. Добавить китайский текст
draw.text((10, 10), "Hello, Pillow!", fill="red", font=font)

# 5. Сохраните изображение
image.save('chinese_output.png')

Вывод выглядит следующим образом, китайский отображается корректно:


Продвинутые методы компоновки текста

Управление положением текста

text()Первый параметр метода — это координата (x, y), которая указывает положение верхнего левого угла текста. Мы можем управлять положением текста с помощью вычислений.

Пример

from PIL import Image, ImageDraw, ImageFont

# 1. Создайте новое изображение
image = Image.new('RGB', (400, 200), color=(255, 255, 255))

# 2. Создайте объект ImageDraw
draw = ImageDraw.Draw(image)

# 3. Укажите китайский шрифт
# Примечание: замените его путем к файлу шрифта, который существует в вашей системе
font_path = "SimHei.ttf"  # Путь к шрифту SimHei
font_size = 20
font = ImageFont.truetype(font_path, font_size)

# 4. Добавить китайский текст
# Выровнять текст по центру
text = "Текст по центру"
bbox = draw.textbbox((0, 0), text, font=font)
text_width = bbox[2] - bbox[0]
text_height = bbox[3] - bbox[1]
image_width, image_height = image.size
x = (image_width - text_width) / 2
y = (image_height - text_height) / 2
draw.text((x, y), text, fill="red", font=font)

# 5. Сохраните изображение
image.save('chinese_output.png')

Вывод выглядит следующим образом, текст выровнен по центру:

Обработка многострочного текста

Pillow сам по себе не поддерживает автоматический перенос строк напрямую, но мы можем реализовать его вручную:

Пример

from PIL import Image, ImageDraw, ImageFont

# 1. Создайте новое изображение
image = Image.new('RGB', (400, 200), color=(255, 255, 255))

# 2. Создайте объект ImageDraw
draw = ImageDraw.Draw(image)

# 3. Укажите китайский шрифт
# Примечание: замените его путем к файлу шрифта, который существует в вашей системе
font_path = "SimHei.ttf"  # Путь к шрифту SimHei
font_size = 20
font = ImageFont.truetype(font_path, font_size)

# 4. Добавить китайский текст
# Многострочный вывод
# Китайский текст для отображения
text = Это относительно длинный фрагмент текста, и нам нужно разбить его на несколько строк для лучшей читаемости.
max_width = 200  # Максимальная ширина строки (в пикселях)

lines = []         # Сохранить текст после разбиения на строки
current_line = ""  # Текущая обрабатываемая строка

# Пройти по тексту посимвольно, чтобы определить, нужен ли перенос строки
for char in text:
    test_line = current_line + char
    # Вычислить ширину текущей строки, чтобы определить, превышает ли она максимальную ширину
    if draw.textbbox((0, 0), test_line, font=font)[2] <= max_width:
        current_line = test_line
    else:
        lines.append(current_line)  # Текущая строка заполнена, добавить её в результат
        current_line = char         # Новая строка начинается с текущего символа
if current_line:
    lines.append(current_line)      # Добавить последнюю строку

y_text = 10  # Начальная координата y
# Рисовать текст построчно
for line in lines:
    draw.text((10, y_text), line, fill="red", font=font)
    bbox = draw.textbbox((0, 0), line, font=font)
    line_height = bbox[3] - bbox[1]  # Вычислить высоту текущей строки
    y_text += line_height            # Обновить координату y, чтобы подготовиться к рисованию следующей строки

# 5. Сохраните изображение
image.save('chinese_output.png')

Вывод следующий:

Настройки стиля текста

Мы можем задавать стили текста с помощью файлов шрифтов или возможностей Pillow:

Пример

from PIL import Image, ImageDraw, ImageFont

# 1. Создайте новое изображение
image = Image.new('RGB', (400, 200), color=(255, 255, 255))

# 2. Создайте объект ImageDraw
draw = ImageDraw.Draw(image)

# 3. Укажите китайский шрифт
# Примечание: замените его путем к файлу шрифта, который существует в вашей системе
font_path = "SimHei.ttf"  # Путь к шрифту SimHei
font_size = 20
font = ImageFont.truetype(font_path, font_size)
# 4. Добавить китайский текст

# Установить цвет текста
draw.text((10, 10), "Цветной текст", fill=(255, 0, 0), font=font)  # Красный

# Добавить обводку текста (реализуется многократной отрисовкой)
text = "Текст с обводкой"
position = (50, 50)
# Сначала нарисовать чёрный фон (обводку)
for x_offset in [-1, 0, 1]:
    for y_offset in [-1, 0, 1]:
        if x_offset != 0 or y_offset != 0:
            draw.text((position[0]+x_offset, position[1]+y_offset), text, fill="black", font=font)
# Затем нарисовать белый передний план
draw.text(position, text, fill="white", font=font)

# 5. Сохраните изображение
image.save('chinese_output.png')

Вывод следующий:


Примеры практического применения

Добавление водяного знака на изображение

Пример

from PIL import Image, ImageDraw, ImageFont, ImageEnhance

# 1. Создайте новое изображение

# Открыть исходное изображение
original_image = Image.open("tiger.jpeg")

# Создать прозрачный слой для водяного знака
watermark = Image.new("RGBA", original_image.size, (0, 0, 0, 0))
draw = ImageDraw.Draw(watermark)

# Установить шрифт водяного знака
font_path = "SimHei.ttf"  # Путь к шрифту SimHei
font_size = 60
font = ImageFont.truetype(font_path, font_size)
# Добавить текст водяного знака
text = WWW.example.com Добавить тестовый водяной знак
bbox = draw.textbbox((0, 0), text, font=font)
text_width = bbox[2] - bbox[0]
text_height = bbox[3] - bbox[1]
x = original_image.width - text_width - 20
y = original_image.height - text_height - 20
draw.text((x, y), text, fill=(255, 0, 0, 128), font=font)  # Полупрозрачный красный

# Объединить водяной знак и исходное изображение
watermarked_image = Image.alpha_composite(
    original_image.convert("RGBA"),
    watermark
)

# Сохранить результат
watermarked_image.save("watermarked_photo.png")

Эффект выглядит следующим образом:

Создание постера

Пример

from PIL import Image, ImageDraw, ImageFont

# Создать фон постера
poster = Image.new("RGB", (800, 1200), (30, 30, 60))

draw = ImageDraw.Draw(poster)

# Установить шрифт заголовка
title_font = ImageFont.truetype("SimHei.ttf", 60)
# Установить шрифт основного текста
body_font = ImageFont.truetype("SimHei.ttf", 30)

# Добавить заголовок
title = Лекция по обработке изображений на Python
draw.text((50, 50), title, fill=(255, 255, 255), font=title_font)

# Добавить основной текст
content = """Дата: 15 апреля 2025
Местоположение: онлайн-переговорная
Докладчик: WWW.example.com
Содержание: используйте библиотеку Python Pillow для обработки изображений"""

y_position = 150
for line in content.split("\n"):
    draw.text((50, y_position), line, fill=(220, 220, 220), font=body_font)
    y_position += 40

# Сохранить постер
poster.save("event_poster.png")

Эффект выглядит следующим образом:

С помощью описанных выше методов и примеров вы сможете легко добавлять китайские шрифты в Pillow. Не забывайте учитывать вопросы авторского права на шрифты в практических приложениях и при необходимости настраивать стили и положение текста.

Другие расширения