Pillow: модуль ImageDraw
ImageDraw — это модуль в Pillow (форк PIL), библиотеке обработки изображений Python, используемый для рисования различных фигур и текста на изображениях.
ImageDraw предоставляет богатые возможности рисования, включая линии, прямоугольники, круги, многоугольники, текст и т. д., подходящие для аннотирования изображений, создания диаграмм или простого графического дизайна.
ImageDrawОсновные возможности модуля включают:
- Поддерживает рисование на существующих изображениях
- Может создавать совершенно новые пустые холсты
- Предоставляет множество примитивов рисования (точки, линии, прямоугольники, эллипсы и т. д.)
- Поддерживает рисование текста и настройки шрифта
- Позволяет использовать пользовательские цвета и стили рисования
Базовое использование ImageDraw
Создание объекта Draw
Прежде чем использовать ImageDraw, сначала нужно создатьImageDraw.Drawобъект, передавImageобъект в качестве основы для рисования.
Пример
# Создать пустое изображение (белый фон)
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 для рисования нескольких фигур и текста:
Пример
# Создать пустое изображение
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!
Другие расширения