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
- Verarbeitung animierter GIFs: Lesen und Bearbeiten von GIF-Animationen Frame für Frame
- Verarbeitung mehrseitiger TIFFs: Zugriff auf einzelne Seiten in einer TIFF-Datei
- Verarbeitung von Bildsequenzen: Stapelverarbeitung einer einzelnen Datei, die mehrere Bilder enthält
- 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
# 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
# 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
# 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
- 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
- Formatunterstützung: Nicht alle Bildformate unterstützen Multiframe-Operationen; häufig unterstützte Formate sind GIF, TIFF, WebP usw.
- Frame-Index: Frame-Indizes beginnen bei 0, was von der Anzeige gängiger Bildbetrachter abweichen kann (Betrachter zählen normalerweise ab 1)
- Ä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