Как правильно импортировать библиотеку Pillow для работы с изображениями

Раздел: Библиотеки -> Библиотека обработки изображений

Основные способы импорта библиотеки PIL

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

from PIL import Image

Python import pil (импорт библиотеки pil в python)

Данная строка импортирует класс Image, который является основным для работы с растровыми изображениями. После этого можно открывать, создавать, изменять и сохранять изображения. Например:

img = Image.open('example.jpg')
print(img.size)

Такой подход рекомендуется в официальной документации Pillow и в большинстве руководств.

Возможная проблема: ModuleNotFoundError: No module named 'PIL'

Эта ошибка возникает, если библиотека не установлена. Решение – установить Pillow через pip:

pip install Pillow

Важно: модуль называется PIL, но устанавливать нужно пакет Pillow (более новая активная ветка). После установки импорт будет работать.

Как импортировать весь пакет PIL для доступа к нескольким подмодулям?

import PIL

После такого импорта доступ к модулю Image осуществляется через PIL.Image. Это может быть удобно, если требуется сохранить полное пространство имён, но код становится более длинным. Пример:

img = PIL.Image.open('photo.png')

Такой вариант используется реже, так как каждый раз приходится писать префикс PIL..

Как импортировать конкретный модуль, сохраняя его полное имя?

import PIL.Image

В этом случае Image становится атрибутом пакета PIL, и обращаться к нему нужно как PIL.Image. Разницы с предыдущим вариантом практически нет, но такой импорт может быть полезен для явного указания используемых модулей.

Как импортировать несколько модулей одновременно?

from PIL import Image, ImageFilter, ImageEnhance

Позволяет использовать сразу несколько классов без префикса. Это часто применяется в скриптах, где требуется и фильтрация, и коррекция цвета, и работа с каналами.

Можно ли импортировать всё содержимое PIL одной строкой?

from PIL import *

Такой вариант не рекомендуется, так как он засоряет пространство имён и может привести к конфликтам с другими библиотеками. Однако в быстрых экспериментах или интерактивных сессиях его иногда используют. Важно помнить, что он импортирует только имена, определённые в __all__ пакета PIL, а не все подмодули.

Как проверить, установлена ли библиотека, и импортировать её условно?

Для обработки ситуаций, когда библиотека может отсутствовать, применяется конструкция try-except:

try:
    from PIL import Image
    PIL_AVAILABLE = True
except ImportError:
    PIL_AVAILABLE = False
    print("Pillow не установлен. Установите: pip install Pillow")

Это позволяет программе корректно обрабатывать отсутствие зависимости и, например, выводить альтернативное сообщение или использовать другую библиотеку.

Распространённая ошибка: путаница между PIL и Pillow

Старая библиотека PIL (Python Imaging Library) не обновлялась с 2011 года. Современной активно поддерживаемой веткой является Pillow. При установке всегда используйте:

pip install Pillow

После установки импорт будет работать через import PIL, так как Pillow предоставляет обратно совместимый пакет. Если по каким-то причинам установлен именно старый PIL, многие функции могут отсутствовать.

Как импортировать Pillow в виртуальном окружении или Docker-контейнере?

Убедитесь, что виртуальное окружение активировано, и выполните установку внутри него. После активации:

(venv) $ pip install Pillow

Тот же принцип работает для Docker: добавьте строку в Dockerfile:

RUN pip install Pillow

После этого импорт в коде контейнера будет успешным.

Расширенные примеры работы с PIL после импорта

1. Загрузка изображения и получение информации

Пример 
from PIL import Image

img = Image.open('sample.jpg')
print('Формат:', img.format)
print('Размер:', img.size)
print('Режим:', img.mode)
Формат: JPEG
Размер: (1920, 1080)
Режим: RGB

2. Изменение размера с сохранением пропорций

Пример 
from PIL import Image

img = Image.open('photo.png')
# Рассчитываем новый размер, сохраняя соотношение сторон
width_percent = 0.5
new_width = int(img.size[0] * width_percent)
new_height = int(img.size[1] * width_percent)
resized = img.resize((new_width, new_height), Image.LANCZOS)
resized.save('photo_resized.png')
Сохраняется изображение с уменьшенными вдвое размерами. Параметр LANCZOS обеспечивает высокое качество при уменьшении.

3. Применение фильтров из модуля ImageFilter

Пример 
from PIL import Image, ImageFilter

img = Image.open('portrait.jpg')
blurred = img.filter(ImageFilter.GaussianBlur(radius=5))
blurred.save('portrait_blurred.jpg')

# Контурная фильтрация
contour = img.filter(ImageFilter.CONTOUR)
contour.save('portrait_contour.jpg')
Создаются два файла: размытое изображение и изображение с выделенными контурами.

4. Рисование текста на изображении

Пример 
from PIL import Image, ImageDraw, ImageFont

img = Image.new('RGB', (400, 200), 'white')
draw = ImageDraw.Draw(img)
# Попытка загрузить системный шрифт; если отсутствует, используется стандартный
try:
    font = ImageFont.truetype('arial.ttf', 36)
except IOError:
    font = ImageFont.load_default()
draw.text((20, 50), 'Привет, PIL!', fill='black', font=font)
img.save('text_image.png')
На белом фоне появляется текст 'Привет, PIL!'. Если шрифт не найден, используется встроенный шрифт меньшего размера.

5. Работа с прозрачностью (alpha-канал)

Пример 
from PIL import Image

# Создаём полупрозрачный круг
img = Image.new('RGBA', (100, 100), (0, 0, 0, 0))
draw = ImageDraw.Draw(img)
draw.ellipse((10, 10, 90, 90), fill=(255, 0, 0, 128))  # красный с прозрачностью 50%
img.save('semi_transparent.png')
Изображение представляет собой красный круг на полностью прозрачном фоне. Файл сохранён в формате PNG, поддерживающем альфа-канал.

6. Конвертация между режимами (цветовыми моделями)

Пример 
from PIL import Image

img = Image.open('colorful.jpg').convert('RGB')  # гарантируем RGB
# Преобразуем в оттенки серого
gray = img.convert('L')
gray.save('gray.jpg')
# Преобразуем в режим CMYK (для печати)
cmyk = img.convert('CMYK')
cmyk.save('colorful_cmyk.tif')
Создаются два файла: чёрно-белая версия и версия в цветовой модели CMYK.

7. Использование ImageEnhance для коррекции яркости, контраста, насыщенности

Пример 
from PIL import Image, ImageEnhance

img = Image.open('landscape.jpg')
enhancer = ImageEnhance.Brightness(img)
brighter = enhancer.enhance(1.5)  # увеличиваем яркость на 50%
brighter.save('landscape_brighter.jpg')

contrast_enhancer = ImageEnhance.Contrast(img)
high_contrast = contrast_enhancer.enhance(2.0)
high_contrast.save('landscape_high_contrast.jpg')
Получаются два изображения: с повышенной яркостью и с повышенным контрастом.

8. Обработка ошибок при открытии файла

Пример 
from PIL import Image, UnidentifiedImageError

try:
    img = Image.open('corrupted.png')
    img.verify()  # проверка целостности без полной загрузки
except FileNotFoundError:
    print('Файл не найден.')
except UnidentifiedImageError:
    print('Невозможно распознать формат изображения.')
Программа корректно сообщит об отсутствии файла или повреждённом формате, не прерывая выполнение.

Импорт библиотеки PIL в Python - comments

En
Python import pil (python)