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
- Procesar GIF animados: leer y manipular animaciones GIF fotograma a fotograma
- Procesar TIFF de múltiples páginas: acceder a las distintas páginas de un archivo TIFF
- Procesamiento de secuencias de imágenes: procesar por lotes un solo archivo que contiene múltiples imágenes
- 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
# 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
# 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
# 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
- 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
- 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.
- Í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)
- Modificar la imagen original: modificar los fotogramas directamente puede afectar a la imagen original; se recomienda
frame.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