ImageSequence-Modul

ImageSequence ist ein Modul in der Python-Pillow-Bibliothek (ein Fork von PIL), das speziell für die Verarbeitung von Multiframe-Bildern (wie GIF, TIFF und andere Formate) entwickelt wurde.

Das ImageSequence-Modul ermöglicht den iterativen Zugriff auf jeden Frame in einer Bildsequenz, was es ideal für die Verarbeitung animierter Bilder oder Bilddateien mit mehreren Seiten macht.


Hauptverwendungszwecke von ImageSequence

  1. Verarbeitung animierter GIFs: Lesen und Bearbeiten von GIF-Animationen Frame für Frame
  2. Verarbeitung mehrseitiger TIFFs: Zugriff auf einzelne Seiten in einer TIFF-Datei
  3. Verarbeitung von Bildsequenzen: Stapelverarbeitung einer einzelnen Datei, die mehrere Bilder enthält
  4. Frame-Extraktion und -Analyse: Extrahieren bestimmter Frames aus animierten Bildern zur Analyse oder Modifikation

Kernmethoden des ImageSequence-Moduls

Im Folgenden finden Sie die am häufigsten verwendeten Methoden im Modul ImageSequence und ihre Beschreibungen:

Methode/Attribut Beschreibung Rückgabewert Beispiel
ImageSequence.Iterator(image) Erstellt ein Iteratorobjekt zum Iterieren über eine Bildsequenz Iteratorobjekt for frame in ImageSequence.Iterator(img):
ImageSequence.all_frames(image) Gibt eine Liste zurück, die alle Frames enthält Liste frames = list(ImageSequence.all_frames(img))
seek(frame) Springt zu einem bestimmten Frame (wird von einigen Bildformaten unterstützt) Keine img.seek(5) # Springe zum 6. Frame
tell() Gibt die Indexposition des aktuellen Frames zurück Integer current_frame = img.tell()
n_frames Gibt die Gesamtzahl der Frames im Bild zurück Integer total_frames = img.n_frames

Anwendungsbeispiele

1. Grundlegende Verwendung: Über alle Frames einer GIF-Animation iterieren

Beispiel

from PIL import Image, ImageSequence

# GIF-Datei öffnen
with Image.open('animation.gif') as img:
    # Über jedes Einzelbild iterieren
    for i, frame in enumerate(ImageSequence.Iterator(img)):
        # Jeden Frame verarbeiten
        frame.save(f'frame_{i}.png')  # Als einzelne PNG-Dateien speichern

2. Alle Seiten aus einer TIFF-Datei extrahieren

Beispiel

from PIL import Image, ImageSequence

# Mehrseitige TIFF-Datei öffnen
with Image.open('multipage.tiff') as img:
    # Alle Frames abrufen
    frames = list(ImageSequence.all_frames(img))
   
    # Jede Seite verarbeiten
    for i, page in enumerate(frames):
        page.save(f'page_{i}.jpg', quality=95)

3. Ändern und Speichern eines animierten GIFs

Beispiel

from PIL import Image, ImageSequence

# Quell-GIF öffnen
with Image.open('source.gif') as img:
    # Neue Frame-Liste vorbereiten
    new_frames = []
   
    # Jeden Frame verarbeiten
    for frame in ImageSequence.Iterator(img):
        # Jeden Frame bearbeiten (z. B. Text hinzufügen)
        modified_frame = frame.copy()
        # ... Füge hier deinen Änderungscode ein ...
       
        new_frames.append(modified_frame)
   
    # Das geänderte GIF speichern
    new_frames[0].save('modified.gif',
                      save_all=True,
                      append_images=new_frames[1:],
                      duration=img.info.get('duration', 100),
                      loop=0)

Hinweise

  1. Speicherverbrauch: Achten Sie bei der Verarbeitung großer Multiframe-Bilder auf den Speicherverbrauch und ziehen Sie in Betracht, Frame für Frame zu verarbeiten, anstatt alle Frames auf einmal zu laden
  2. Formatunterstützung: Nicht alle Bildformate unterstützen Multiframe-Operationen; häufig unterstützte Formate sind GIF, TIFF, WebP usw.
  3. Frame-Index: Frame-Indizes beginnen bei 0, was von der Anzeige gängiger Bildbetrachter abweichen kann (Betrachter zählen normalerweise ab 1)
  4. Ändern des Originalbilds: Das direkte Ändern von Frames kann das Originalbild beeinflussen; es wird empfohlen,frame.copy()vor der Änderung eine Kopie zu erstellen

Zusammenfassung

Das ImageSequence-Modul bietet einfache und dennoch leistungsstarke Werkzeuge für die Verarbeitung von Multiframe-Bildern. Über seine Iterator-Schnittstelle können Entwickler einfach auf jeden Frame in animierten oder mehrseitigen Bildern zugreifen und ihn bearbeiten. Ob beim Extrahieren von Frames, beim Analysieren von Inhalten oder beim Erstellen neuer Animationen – dieses Modul kann den Workflow erheblich vereinfachen.

Andere Erweiterungen