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Поддержка TkinterPhotoImage(), BitmapImage()Отображение изображений в интерфейсе Tkinter
ImageQtИнтеграция с GUIПоддержка QtImageQt(), toqimage()Отображение изображений в PyQt/PySide
ExifTagsМетаданныеЧтение EXIFTAGS, GPSTAGSЧтение параметров камеры/GPS-информации
PSDrawВывод на печатьPostScriptPSDraw(), begin_document()Создание векторных файлов для печати
TiffTagsМетаданныеТеги TIFFTIFFTAGSОбработка метаданных формата 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()

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()

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()
Другие расширения