Pillow: общие модули и методы
Pillow предоставляет богатую функциональность, включая открытие, редактирование, сохранение изображений, преобразование форматов и т. д.
В этой статье будут представлены общие модули и методы Pillow, а также простые примеры кода.
Общие модули
| Название модуля | Категория функций | Основная функциональность | Общие методы/атрибуты | Типичные сценарии применения |
|---|---|---|---|---|
| Image | Основной модуль | Базовые операции с изображениями | open(), save(), resize(), crop(), rotate(), convert() | Загрузка/сохранение/изменение размера/преобразование формата изображений |
| ImageDraw | Модуль рисования | Рисование векторной графики | Draw(), line(), rectangle(), text(), ellipse() | Добавление водяных знаков/рисование фигур/аннотирование изображений |
| ImageFont | Поддержка шрифтов | Отрисовка текста | truetype(), load_default(), getsize() | Пользовательские стили текста/вычисление области текста |
| ImageFilter | Эффекты изображения | Обработка фильтрами | BLUR, SHARPEN, EMBOSS, GaussianBlur() | Размытие/повышение резкости/художественные эффекты изображения |
| ImageEnhance | Оптимизация изображений | Улучшение качества | Brightness(), Contrast(), Color(), Sharpness() | Регулировка яркости/контраста/насыщенности |
| ImageOps | Расширенные операции | Автоматизированная обработка | grayscale(), flip(), mirror(), invert() | Инверсия изображения/зеркалирование/принудительное преобразование в оттенки серого |
| ImageChops | Операции с каналами | Математические операции | add(), subtract(), multiply(), difference() | Композитинг изображений/обнаружение различий/обработка маски |
| ImageColor | Цветовая система | Преобразование цветов | getrgb(), getcolor(), colormap | Преобразование цветов HEX/RGB/HSL |
| ImageGrab | Захват экрана | Функциональность скриншотов | grab(), grabclipboard() | Получение изображений со скриншота/из буфера обмена |
| ImageStat | Анализ данных | Статистика пикселей | Stat(), extrema(), mean(), rms() | Анализ цвета изображения/определение яркости |
| ImagePalette | Палитра | Управление индексированными цветами | new(), getcolor(), tobytes() | Обработка 8-битных цветных изображений/оптимизация GIF |
| ImagePath | Обработка путей | Векторные пути | Path(), getbbox(), compact() | Рисование сложных фигур (требуется ImageDraw) |
| ImageSequence | Анимированные изображения | Обработка кадров | Iterator(), all_frames() | Разложение GIF-анимации/обработка многофреймовых TIFF |
| ImageMorph | Морфология | Морфинг изображений | MorphOp(), apply(), get_on_pixels() | Дилатация/эрозия/структурный анализ шаблонов |
| ImageShow | Предпросмотр изображения | Быстрый просмотр | show(), register_viewer() | Быстрый просмотр изображений при отладке |
| ImageTk | Интеграция с GUI | Поддержка Tkinter | PhotoImage(), BitmapImage() | Отображение изображений в интерфейсе Tkinter |
| ImageQt | Интеграция с GUI | Поддержка Qt | ImageQt(), toqimage() | Отображение изображений в PyQt/PySide |
| ExifTags | Метаданные | Чтение EXIF | TAGS, GPSTAGS | Чтение параметров камеры/GPS-информации |
| PSDraw | Вывод на печать | PostScript | PSDraw(), begin_document() | Создание векторных файлов для печати |
| TiffTags | Метаданные | Теги TIFF | TIFFTAGS | Обработка метаданных формата TIFF |
Рабочий процесс модуля

Расширенные комбинации обработки:
- Создание эффектов: ImageFilter + ImageEnhance
- Анализ изображений: ImageStat + ImageChops
- Разработка GUI: ImageTk/ImageQt + ImageDraw
Поддержка профессиональных областей:
- Научные изображения: TIFFTags + ImageSequence
- Печать и публикация: PSDraw + ImageColor
- Компьютерное зрение: ImageMorph + ImageOps
Общие методы
PIL.ImageОбщие методы модуля
| Метод | Описание | Пример |
|---|---|---|
Image.open() |
Открыть файл изображения | img = Image.open("example.jpg") |
Image.save() |
Сохранить файл изображения | img.save("output.png") |
Image.show() |
Отобразить изображение | img.show() |
Image.resize() |
Изменение размера изображения | new_img = img.resize((200, 200)) |
Image.rotate() |
Поворот изображения | rotated_img = img.rotate(45) |
Image.crop() |
Обрезка изображения | cropped_img = img.crop((50, 50, 200, 200)) |
Пример кода:
Пример
from PIL import Image
# Открыть изображение
img = Image.open("example.jpg")
# Изменить размер и сохранить
resized_img = img.resize((300, 300))
resized_img.save("resized_example.jpg")
# Повернуть на 90 градусов и отобразить
rotated_img = img.rotate(90)
rotated_img.show()
# Открыть изображение
img = Image.open("example.jpg")
# Изменить размер и сохранить
resized_img = img.resize((300, 300))
resized_img.save("resized_example.jpg")
# Повернуть на 90 градусов и отобразить
rotated_img = img.rotate(90)
rotated_img.show()
PIL.ImageDrawОбщие методы модуля
| Метод | Описание | Пример |
|---|---|---|
ImageDraw.Draw() |
Создать объект рисования | draw = ImageDraw.Draw(img) |
draw.line() |
Нарисовать линию | draw.line([(0, 0), (100, 100)], fill="red", width=2) |
draw.rectangle() |
Нарисовать прямоугольник | draw.rectangle([(50, 50), (150, 150)], outline="blue", width=3) |
draw.text() |
Рисовать текст | draw.text((10, 10), "Hello", fill="black") |
Пример кода:
Пример
from PIL import Image, ImageDraw
# Создать пустое изображение
img = Image.new("RGB", (300, 300), "white")
draw = ImageDraw.Draw(img)
# Нарисовать красную линию
draw.line([(0, 0), (300, 300)], fill="red", width=2)
# Нарисовать синий прямоугольник
draw.rectangle([(50, 50), (250, 250)], outline="blue", width=3)
# Добавить текст
draw.text((100, 100), "Hello Pillow!", fill="black")
# Сохранить изображение
img.save("draw_example.png")
img.show()
# Создать пустое изображение
img = Image.new("RGB", (300, 300), "white")
draw = ImageDraw.Draw(img)
# Нарисовать красную линию
draw.line([(0, 0), (300, 300)], fill="red", width=2)
# Нарисовать синий прямоугольник
draw.rectangle([(50, 50), (250, 250)], outline="blue", width=3)
# Добавить текст
draw.text((100, 100), "Hello Pillow!", fill="black")
# Сохранить изображение
img.save("draw_example.png")
img.show()
PIL.ImageFilterОбщие методы модуля
| Метод | Описание | Пример |
|---|---|---|
ImageFilter.BLUR |
Фильтр размытия | img.filter(ImageFilter.BLUR) |
ImageFilter.CONTOUR |
Фильтр контуров | img.filter(ImageFilter.CONTOUR) |
ImageFilter.SHARPEN |
Фильтр повышения резкости | img.filter(ImageFilter.SHARPEN) |
Пример кода:
Пример
from PIL import Image, ImageFilter
# Открыть изображение
img = Image.open("example.jpg")
# Применить фильтр размытия
blurred_img = img.filter(ImageFilter.BLUR)
blurred_img.save("blurred_example.jpg")
# Применить фильтр повышения резкости
sharpened_img = img.filter(ImageFilter.SHARPEN)
sharpened_img.show()
# Открыть изображение
img = Image.open("example.jpg")
# Применить фильтр размытия
blurred_img = img.filter(ImageFilter.BLUR)
blurred_img.save("blurred_example.jpg")
# Применить фильтр повышения резкости
sharpened_img = img.filter(ImageFilter.SHARPEN)
sharpened_img.show()