Pillow TiffTags-Modul
TiffTags ist ein Untermodul in der Python-Bibliothek Pillow (PIL) zur Bildverarbeitung, das speziell für die Verarbeitung von Tag-Informationen in TIFF-(Tagged Image File Format-)Bilddateien verwendet wird.
TIFF ist ein flexibles Bitmap-Bildformat, das mehrere Komprimierungsmethoden und Farbräume unterstützt und im professionellen Bereich der Bildverarbeitung weit verbreitet ist.
In TIFF-Dateien werden verschiedene Attribute und Metadaten des Bildes in Tags gespeichert, und das TiffTags-Modul bietet Funktionen zum Zugreifen auf und Bearbeiten dieser Tags.
Importmethode:
from PIL.TiffTags import TAGS_V2
Hauptfunktionen
Das TiffTags-Modul bietet hauptsächlich die folgenden Funktionen:
- Definiert Standard-TIFF-Tags und ihre Attribute
- Zuordnung zwischen Tag-Namen und IDs bereitstellen
- Tag-Datentypen und Wertebereiche beschreiben
- Benutzerdefinierte Tag-Verarbeitung unterstützen
Kernmethoden erklärt
Hauptmethoden des TiffTags-Moduls
Nachfolgend sind die am häufigsten verwendeten Methoden und ihre Beschreibungen im TiffTags-Modul aufgeführt:
| Methode/Attribut | Beschreibung | Rückgabetyp | Beispiel |
|---|---|---|---|
TiffTags.TAGS_V2 |
Wörterbuch, das alle standardmäßigen TIFF-Tags enthält, mit Tag-IDs als Schlüssel und Tag-Informationen als Werte | dict | {256: (256, 'ImageWidth', 4, 1, None), ...} |
TiffTags.TAGS |
Veraltetes TIFF-Tag-Wörterbuch (aus Kompatibilitätsgründen beibehalten) | dict | Identisch mit TAGS_V2 |
TiffTags.LOOKUP |
Wörterbuch, das Tag-Namen IDs zuordnet | dict | {'ImageWidth': 256, ...} |
TiffTags.IFD |
IFD-(Image File Directory)-Tag-Sammlung | dict | Enthält IFD-bezogene Tags |
TiffTags.CUSTOM_TAGS |
Wörterbuch zum Speichern benutzerdefinierter Tags | dict | Benutzerdefiniert |
Tag-Informationsstruktur
Die Informationen zu jedem TIFF-Tag sind ein Tupel mit 5 Elementen:
- Tag-ID (Ganzzahl)
- Tag-Name (Zeichenkette)
- Datentyp (Ganzzahl, entsprechend der TIFF-Spezifikation)
- Wertlänge (Ganzzahl)
- Standardwert oder spezielle Hinweise (optional)
Zuordnungstabelle für Datentypen
| Typcode | Datentyp | Beschreibung |
|---|---|---|
| 1 | BYTE | 8-Bit-Ganzzahl ohne Vorzeichen |
| 2 | ASCII | 7-Bit-ASCII-Zeichen |
| 3 | SHORT | 16-Bit-Ganzzahl ohne Vorzeichen |
| 4 | LONG | 32-Bit-Ganzzahl ohne Vorzeichen |
| 5 | RATIONAL | Zwei LONGs, die einen Bruch darstellen |
| 6 | SBYTE | 8-Bit-Ganzzahl mit Vorzeichen |
| 7 | UNDEFINED | Undefinierte 8-Bit-Daten |
| 8 | SSHORT | 16-Bit-Ganzzahl mit Vorzeichen |
| 9 | SLONG | 32-Bit-Ganzzahl mit Vorzeichen |
| 10 | SRATIONAL | Zwei SLONGs, die einen vorzeichenbehafteten Bruch darstellen |
| 11 | FLOAT | 32-Bit-IEEE-Gleitkommazahl |
| 12 | DOUBLE | 64-Bit-IEEE-Gleitkommazahl |
Praktische Anwendungsbeispiele
Beispiel 1: Alle TIFF-Tags anzeigen
Beispiel
# Alle Standard-TIFF-Tags ausgeben
for tag_id, tag_info in TAGS_V2.items():
print(f"ID: {tag_id}, Name: {tag_info[1]}, Type: {tag_info[2]}")
Beispiel 2: Tag-ID anhand des Namens finden
Beispiel
# ID des "Artist"-Tags finden
artist_tag_id = LOOKUP.get('Artist')
print(f"Artist tag ID: {artist_tag_id}") # Ausgabe: 315
Beispiel 3: Tag-Informationen aus TIFF-Datei lesen
Beispiel
from PIL.TiffTags import TAGS
# TIFF-Datei öffnen
with Image.open('example.tif') as img:
# Alle Tags abrufen
if hasattr(img, 'tag'):
for tag_id, value in img.tag.items():
tag_name = TAGS.get(tag_id, tag_id)
print(f"{tag_name}: {value}")
Erweiterte Nutzung
Benutzerdefinierte Tag-Verarbeitung
Beispiel
from PIL.TiffTags import TAGS_V2, CUSTOM_TAGS
# Benutzerdefinierte Tags definieren
CUSTOM_TAGS = {
50000: (50000, 'MyCustomTag', 2, 1, None)
}
# Standard-Tags und benutzerdefinierte Tags zusammenführen
ALL_TAGS = {**TAGS_V2, **CUSTOM_TAGS}
# TIFF-Datei mit benutzerdefinierten Tags speichern
img = Image.new('RGB', (100, 100))
img.save('custom.tif', tiffinfo={50000: 'CustomValue'})
FAQ
F1: Warum können einige TIFF-Tags nicht gelesen werden?
A1: Es kann daran liegen, dass das Tag nicht im Standard-TAGS_V2 definiert ist oder ein privates Tag verwendet. Sie können versuchen, die Dateispezifikation zu überprüfen oder den Dateiersteller zu kontaktieren, um die Tag-Definition zu erhalten.
F2: Wie kann man den Datentyp eines Tags ermitteln?
A2: Sie können den Datentyp jedes Tags über das TAGS_V2-Wörterbuch abfragen. Zum Beispiel,TAGS_V2[256][2]gibt den Datentypcode des ImageWidth-Tags zurück.
F3: Können TIFF-Tags geändert werden?
A3: Ja, Sie können die save-Methode von Pillow mit dem Parameter tiffinfo verwenden, um Tags zu ändern oder hinzuzufügen. Beachten Sie jedoch, dass nicht alle Tags geändert werden können; einige sind schreibgeschützt.
Zusammenfassung
Das TiffTags-Modul ist ein wichtiges Werkzeug in der Pillow-Bibliothek für die Verarbeitung von TIFF-Bildmetadaten. Durch diesen Artikel sollten Sie Folgendes gelernt haben:
- Wie man auf Standard-TIFF-Tags zugreift und sie abfragt
- Die Datenstruktur der Tag-Informationen
- Wie man Tags in praktischen Anwendungen liest und schreibt
- Wie man benutzerdefinierte Tags behandelt
Nach dem Beherrschen dieses Wissens können Sie Metadateninformationen in TIFF-Bilddateien effektiver verarbeiten.
Andere Erweiterungen