Модуль ImageSequence

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

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


Основные способы использования ImageSequence

  1. Обработка анимированных GIF-файлов: чтение и манипулирование GIF-анимациями покадрово
  2. Обработка многостраничных TIFF-файлов: доступ к отдельным страницам в файле TIFF
  3. Обработка последовательностей изображений: пакетная обработка одного файла, содержащего несколько изображений
  4. Извлечение и анализ кадров: извлечение определённых кадров из анимированных изображений для анализа или изменения

Основные методы модуля ImageSequence

Ниже приведены наиболее часто используемые методы модуля ImageSequence и их описания:

Метод/атрибут Описание Возвращаемое значение Пример
ImageSequence.Iterator(image) Создаёт объект итератора для перебора последовательности изображений Объект итератора for frame in ImageSequence.Iterator(img):
ImageSequence.all_frames(image) Возвращает список, содержащий все кадры Список frames = list(ImageSequence.all_frames(img))
seek(frame) Перейти к определённому кадру (поддерживается некоторыми форматами изображений) Отсутствует img.seek(5) # Перейти к 6-му кадру
tell() Возвращает индекс текущего кадра Integer current_frame = img.tell()
n_frames Возвращает общее количество кадров в изображении Integer total_frames = img.n_frames

Примеры использования

1. Базовое использование: перебор всех кадров GIF-анимации

Пример

from PIL import Image, ImageSequence

# Открыть GIF-файл
with Image.open('animation.gif') as img:
    # Итерация по каждому кадру
    for i, frame in enumerate(ImageSequence.Iterator(img)):
        # Обработать каждый кадр
        frame.save(f'frame_{i}.png')  # Сохранить как отдельные PNG-файлы

2. Извлечение всех страниц из TIFF-файла

Пример

from PIL import Image, ImageSequence

# Открыть многостраничный TIFF-файл
with Image.open('multipage.tiff') as img:
    # Получить все кадры
    frames = list(ImageSequence.all_frames(img))
   
    # Обработать каждую страницу
    for i, page in enumerate(frames):
        page.save(f'page_{i}.jpg', quality=95)

3. Изменение и сохранение анимированного GIF

Пример

from PIL import Image, ImageSequence

# Открыть исходный GIF
with Image.open('source.gif') as img:
    # Подготовить новый список кадров
    new_frames = []
   
    # Обработать каждый кадр
    for frame in ImageSequence.Iterator(img):
        # Изменить каждый кадр (например, добавить текст)
        modified_frame = frame.copy()
        # ... Добавьте сюда свой код модификации ...
       
        new_frames.append(modified_frame)
   
    # Сохраните изменённый GIF
    new_frames[0].save('modified.gif',
                      save_all=True,
                      append_images=new_frames[1:],
                      duration=img.info.get('duration', 100),
                      loop=0)

Примечания

  1. Использование памяти: При обработке больших многофреймовых изображений обращайте внимание на потребление памяти и рассмотрите обработку по кадрам, а не загрузку всех кадров сразу
  2. Поддержка форматов: Не все форматы изображений поддерживают многофреймовые операции; среди распространённых поддерживаемых форматов — GIF, TIFF, WebP и т. д.
  3. Индекс кадра: Индексы кадров начинаются с 0, что может отличаться от того, что отображают обычные программы просмотра изображений (обычно они считают с 1)
  4. Изменение исходного изображения: Прямое изменение кадров может повлиять на исходное изображение; рекомендуется использоватьframe.copy()создать копию перед изменением

Итог

Модуль ImageSequence предоставляет простые, но мощные инструменты для работы с многофреймовыми изображениями. Через интерфейс итератора разработчики могут легко получать доступ к каждому кадру и управлять им в анимированных или многостраничных изображениях. Этот модуль может значительно упростить рабочий процесс — будь то извлечение кадров, анализ содержимого или создание новых анимаций.

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