Módulo TiffTags de Pillow

TiffTags es un submódulo de la biblioteca de procesamiento de imágenes Python Pillow (PIL), dedicado al manejo de la información de etiquetas (Tags) en archivos de imagen TIFF (Tagged Image File Format).

TIFF es un formato de imagen de mapa de bits flexible que admite múltiples métodos de compresión y espacios de color, ampliamente utilizado en el campo del procesamiento profesional de imágenes.

En un archivo TIFF, varios atributos y metadatos de la imagen se almacenan en etiquetas; el módulo TiffTags proporciona funciones para acceder y manipular estas etiquetas.

Método de importación:

from PIL.TiffTags import TAGS_V2

Funciones principales

El módulo TiffTags proporciona principalmente las siguientes funciones:

  1. Definir las etiquetas TIFF estándar y sus atributos
  2. Proporcionar la asignación entre nombres de etiquetas e IDs
  3. Describir los tipos de datos y rangos de valores de las etiquetas
  4. Admitir el procesamiento de etiquetas personalizadas

Explicación detallada de los métodos principales

Métodos principales del módulo TiffTags

A continuación se presentan los métodos más utilizados del módulo TiffTags y su descripción:

Método/Atributo Descripción Tipo de valor de retorno Ejemplo
TiffTags.TAGS_V2 Diccionario que contiene todas las etiquetas TIFF estándar, con la clave como ID de etiqueta y el valor como información de la etiqueta dict {256: (256, 'ImageWidth', 4, 1, None), ...}
TiffTags.TAGS Diccionario de etiquetas TIFF heredado (conservado por compatibilidad) dict Igual que TAGS_V2
TiffTags.LOOKUP Diccionario de asignación de nombres de etiquetas a IDs dict {'ImageWidth': 256, ...}
TiffTags.IFD Conjunto de etiquetas IFD (Directorio de archivos de imagen) dict Contiene etiquetas relacionadas con IFD
TiffTags.CUSTOM_TAGS Diccionario para almacenar etiquetas personalizadas dict Definido por el usuario

Estructura de la información de etiquetas

La información de cada etiqueta TIFF es una tupla de 5 elementos:

  1. ID de etiqueta (entero)
  2. Nombre de etiqueta (cadena)
  3. Tipo de datos (entero, según la especificación TIFF)
  4. Longitud del valor (entero)
  5. Valor predeterminado o descripción especial (opcional)

Tabla de correspondencia de tipos de datos

Código de tipo Tipo de datos Descripción
1 BYTE Entero sin signo de 8 bits
2 ASCII Carácter ASCII de 7 bits
3 SHORT Entero sin signo de 16 bits
4 LONG Entero sin signo de 32 bits
5 RATIONAL Dos LONG, representa una fracción
6 SBYTE Entero con signo de 8 bits
7 UNDEFINED Datos no definidos de 8 bits
8 SSHORT Entero con signo de 16 bits
9 SLONG Entero con signo de 32 bits
10 SRATIONAL Dos SLONG, representa una fracción con signo
11 FLOAT Número de coma flotante IEEE de 32 bits
12 DOUBLE Número de coma flotante IEEE de 64 bits

Ejemplos de aplicación práctica

Ejemplo 1: Ver todas las etiquetas TIFF

Ejemplo

from PIL.TiffTags import TAGS_V2

# Imprimir todas las etiquetas TIFF estándar
for tag_id, tag_info in TAGS_V2.items():
    print(f"ID: {tag_id}, Name: {tag_info[1]}, Type: {tag_info[2]}")

Ejemplo 2: Buscar el ID de etiqueta por nombre

Ejemplo

from PIL.TiffTags import LOOKUP

# Buscar el ID de la etiqueta "Artist"
artist_tag_id = LOOKUP.get('Artist')
print(f"Artist tag ID: {artist_tag_id}")  # Salida: 315

Ejemplo 3: Leer la información de etiquetas de un archivo TIFF

Ejemplo

from PIL import Image
from PIL.TiffTags import TAGS

# Abrir archivo TIFF
with Image.open('example.tif') as img:
    # Obtener todas las etiquetas
    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}")

Uso avanzado

Procesamiento de etiquetas personalizadas

Ejemplo

from PIL import Image
from PIL.TiffTags import TAGS_V2, CUSTOM_TAGS

# Definir etiqueta personalizada
CUSTOM_TAGS = {
    50000: (50000, 'MyCustomTag', 2, 1, None)
}

# Combinar etiquetas estándar y personalizadas
ALL_TAGS = {**TAGS_V2, **CUSTOM_TAGS}

# Guardar archivo TIFF con etiqueta personalizada
img = Image.new('RGB', (100, 100))
img.save('custom.tif', tiffinfo={50000: 'CustomValue'})

Preguntas frecuentes

P1: ¿Por qué algunas etiquetas TIFF no se pueden leer?

R1: Puede ser porque la etiqueta no está definida en el estándar TAGS_V2, o porque se utilizan etiquetas privadas. Se puede intentar revisar la especificación del archivo o contactar al creador del archivo para obtener la definición de la etiqueta.

P2: ¿Cómo saber el tipo de datos de una etiqueta?

R2: A través del diccionario TAGS_V2 se puede consultar el tipo de datos de cada etiqueta. Por ejemplo,TAGS_V2[256][2]devolverá el código de tipo de datos de la etiqueta ImageWidth.

P3: ¿Se pueden modificar las etiquetas TIFF?

R3: Sí, se pueden modificar o agregar etiquetas usando el método save de Pillow junto con el parámetro tiffinfo. Pero hay que tener en cuenta que no todas las etiquetas son modificables, algunas son de solo lectura.


Resumen

El módulo TiffTags es una herramienta importante en la biblioteca Pillow para manejar los metadatos de imágenes TIFF. Con la introducción de este artículo, debería haber comprendido:

  1. Cómo acceder y consultar las etiquetas TIFF estándar
  2. La estructura de datos de la información de etiquetas
  3. Cómo leer y escribir etiquetas en aplicaciones prácticas
  4. Cómo manejar etiquetas personalizadas

Después de dominar estos conocimientos, podrá manejar de manera más eficaz la información de metadatos en archivos de imagen TIFF.

Otras extensiones