Módulo ImageSequence

ImageSequence es un módulo de la biblioteca Python Pillow (un fork de PIL), dedicado específicamente al procesamiento de imágenes de múltiples fotogramas (como formatos GIF, TIFF, etc.).

El módulo ImageSequence te permite acceder de forma iterativa a cada fotograma de una secuencia de imágenes, lo que lo hace muy adecuado para procesar imágenes animadas o archivos de imagen que contienen varias páginas.


Usos principales de ImageSequence

  1. Procesar GIF animados: leer y manipular animaciones GIF fotograma a fotograma
  2. Procesar TIFF de múltiples páginas: acceder a las distintas páginas de un archivo TIFF
  3. Procesamiento de secuencias de imágenes: procesar por lotes un solo archivo que contiene múltiples imágenes
  4. Extracción y análisis de fotogramas: extraer fotogramas concretos de una imagen animada para analizarlos o modificarlos

Métodos principales del módulo ImageSequence

A continuación se muestran los métodos más utilizados del módulo ImageSequence y su descripción funcional:

Método/Atributo Descripción Valor de retorno Ejemplo
ImageSequence.Iterator(image) Crea un objeto iterador para recorrer la secuencia de imágenes Objeto iterador for frame in ImageSequence.Iterator(img):
ImageSequence.all_frames(image) Devuelve una lista con todos los fotogramas Lista frames = list(ImageSequence.all_frames(img))
seek(frame) Saltar a un fotograma específico (compatible con algunos formatos de imagen) None img.seek(5) # saltar al fotograma 6
tell() Devuelve la posición del índice del fotograma actual Entero current_frame = img.tell()
n_frames Devuelve el número total de fotogramas de la imagen Entero total_frames = img.n_frames

Ejemplos de uso

1. Uso básico: recorrer todos los fotogramas de un GIF animado

Ejemplo

from PIL import Image, ImageSequence

# Abrir archivo GIF
with Image.open('animation.gif') as img:
    # Recorrer cada fotograma
    for i, frame in enumerate(ImageSequence.Iterator(img)):
        # Procesar cada fotograma
        frame.save(f'frame_{i}.png')  # Guardar como archivo PNG independiente

2. Extraer todas las páginas de un archivo TIFF

Ejemplo

from PIL import Image, ImageSequence

# Abrir archivo TIFF de múltiples páginas
with Image.open('multipage.tiff') as img:
    # Obtener todos los fotogramas
    frames = list(ImageSequence.all_frames(img))
   
    # Procesar cada página
    for i, page in enumerate(frames):
        page.save(f'page_{i}.jpg', quality=95)

3. Modificar y guardar un GIF animado

Ejemplo

from PIL import Image, ImageSequence

# Abrir el GIF de origen
with Image.open('source.gif') as img:
    # Preparar la lista de nuevos fotogramas
    new_frames = []
   
    # Procesar cada fotograma
    for frame in ImageSequence.Iterator(img):
        # Modificar cada fotograma (por ejemplo, añadir texto)
        modified_frame = frame.copy()
        # ... Añade aquí tu código de modificación ...
       
        new_frames.append(modified_frame)
   
    # Guardar el GIF modificado
    new_frames[0].save('modified.gif',
                      save_all=True,
                      append_images=new_frames[1:],
                      duration=img.info.get('duration', 100),
                      loop=0)

Notas importantes

  1. Uso de memoria: al procesar imágenes grandes de múltiples fotogramas, presta atención al consumo de memoria; considera procesar fotograma a fotograma en lugar de cargar todos los fotogramas de una vez
  2. Compatibilidad de formatos: no todos los formatos de imagen admiten operaciones de múltiples fotogramas; los formatos compatibles más comunes incluyen GIF, TIFF, WebP, etc.
  3. Índice de fotogramas: el índice de fotogramas comienza en 0, lo que puede diferir de lo que muestran los visores de imágenes habituales (los visores suelen contar desde 1)
  4. Modificar la imagen original: modificar los fotogramas directamente puede afectar a la imagen original; se recomiendaframe.copy()crear una copia antes de modificar

Resumen

El módulo ImageSequence ofrece herramientas sencillas pero potentes para procesar imágenes de múltiples fotogramas. A través de su interfaz de iterador, los desarrolladores pueden acceder y manipular fácilmente cada fotograma de imágenes animadas o paginadas. Ya sea para extraer fotogramas, analizar contenido o crear nuevas animaciones, este módulo puede simplificar enormemente el flujo de trabajo.

Otras extensiones