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:

  1. Definiert Standard-TIFF-Tags und ihre Attribute
  2. Zuordnung zwischen Tag-Namen und IDs bereitstellen
  3. Tag-Datentypen und Wertebereiche beschreiben
  4. 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:

  1. Tag-ID (Ganzzahl)
  2. Tag-Name (Zeichenkette)
  3. Datentyp (Ganzzahl, entsprechend der TIFF-Spezifikation)
  4. Wertlänge (Ganzzahl)
  5. 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

from PIL.TiffTags import TAGS_V2

# 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

from PIL.TiffTags import LOOKUP

# 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 import Image
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 import Image
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:

  1. Wie man auf Standard-TIFF-Tags zugreift und sie abfragt
  2. Die Datenstruktur der Tag-Informationen
  3. Wie man Tags in praktischen Anwendungen liest und schreibt
  4. Wie man benutzerdefinierte Tags behandelt

Nach dem Beherrschen dieses Wissens können Sie Metadateninformationen in TIFF-Bilddateien effektiver verarbeiten.

Andere Erweiterungen