Pillow: модуль ImageDraw

ImageDraw — это модуль в Pillow (форк PIL), библиотеке обработки изображений Python, используемый для рисования различных фигур и текста на изображениях.

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

ImageDrawОсновные возможности модуля включают:

  • Поддерживает рисование на существующих изображениях
  • Может создавать совершенно новые пустые холсты
  • Предоставляет множество примитивов рисования (точки, линии, прямоугольники, эллипсы и т. д.)
  • Поддерживает рисование текста и настройки шрифта
  • Позволяет использовать пользовательские цвета и стили рисования

Базовое использование ImageDraw

Создание объекта Draw

Прежде чем использовать ImageDraw, сначала нужно создатьImageDraw.Drawобъект, передавImageобъект в качестве основы для рисования.

Пример

from PIL import Image, ImageDraw

# Создать пустое изображение (белый фон)
image = Image.new("RGB", (400, 300), "white")

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

Рисование базовых фигур

ImageDraw поддерживает множество методов рисования, таких как:

  • Рисовать линии:line()
  • Рисовать прямоугольники:rectangle()
  • Рисовать круги/эллипсы:ellipse()
  • Рисовать многоугольники:polygon()
  • Рисовать текст:text()

Общие методы ImageDraw

Метод Описание Пример
line(xy, fill=None, width=1) Нарисовать линию,xyявляется координатным кортежем ((x1, y1, x2, y2)) draw.line([(10, 10), (100, 50)], fill="red", width=2)
rectangle(xy, fill=None, outline=None, width=1) Нарисовать прямоугольник,xy— это координаты верхнего левого и нижнего правого углов draw.rectangle([(50, 50), (150, 150)], fill="blue", outline="black")
ellipse(xy, fill=None, outline=None, width=1) Нарисовать эллипс или круг draw.ellipse([(100, 100), (200, 200)], fill="green")
polygon(xy, fill=None, outline=None) Нарисовать многоугольник draw.polygon([(50, 50), (100, 20), (150, 50)], fill="yellow")
text(xy, text, fill=None, font=None) Нарисовать текст на изображении draw.text((50, 50), "Hello Pillow!", fill="black")
arc(xy, start, end, fill=None, width=1) Нарисовать дугу draw.arc([(50, 50), (150, 150)], 0, 90, fill="red")
chord(xy, start, end, fill=None, outline=None) Нарисовать хорду (дуга + соединительная линия) draw.chord([(50, 50), (150, 150)], 0, 180, fill="blue")
pieslice(xy, start, end, fill=None, outline=None) Нарисовать сектор круговой диаграммы draw.pieslice([(50, 50), (150, 150)], 0, 90, fill="green")
textbbox() Используется для вычисления ограничивающей рамки, занимаемой заданным текстом при отрисовке на изображении draw.textbbox((50, 50), "Hello Pillow!", font=font)

Комплексный пример

Ниже приведён полный пример, показывающий, как использовать ImageDraw для рисования нескольких фигур и текста:

Пример

from PIL import Image, ImageDraw, ImageFont

# Создать пустое изображение
image = Image.new("RGB", (500, 400), "white")
draw = ImageDraw.Draw(image)

# Нарисовать линию
draw.line([(10, 10), (490, 10)], fill="red", width=3)

# Нарисовать прямоугольник
draw.rectangle([(50, 50), (150, 150)], fill="blue", outline="black")

# Нарисовать круг
draw.ellipse([(200, 50), (300, 150)], fill="green")

# Нарисовать многоугольник
draw.polygon([(350, 50), (400, 100), (450, 50), (400, 150)], fill="yellow")

# Нарисовать текст
font = ImageFont.load_default()
draw.text((50, 200), "Hello Pillow!", fill="black", font=font)

# Сохранить изображение
image.save("draw_example.png")

После запуска будет создан файл изображения, содержащий несколько фигур.draw_example.png。


Итог

ImageDraw — очень практичный модуль рисования в Pillow, подходящий для:

  • Аннотирование изображений (например, добавление текста, стрелок)
  • Создание простых графиков или диаграмм
  • Рисование пользовательских фигур

Освоивline()、rectangle()、ellipse()、text()а также других методов, вы легко сможете удовлетворить различные потребности в рисовании.

Если вам нужны более продвинутые функции рисования, вы можете комбинироватьImageFont(настройки шрифта) илиImageFilter(эффекты фильтров), чтобы дополнительно расширить функциональность.

Надеюсь, этот учебник поможет вам быстро начать работу с модулем ImageDraw в Pillow!

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