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:
- Definir las etiquetas TIFF estándar y sus atributos
- Proporcionar la asignación entre nombres de etiquetas e IDs
- Describir los tipos de datos y rangos de valores de las etiquetas
- 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:
- ID de etiqueta (entero)
- Nombre de etiqueta (cadena)
- Tipo de datos (entero, según la especificación TIFF)
- Longitud del valor (entero)
- 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
# 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
# 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.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.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:
- Cómo acceder y consultar las etiquetas TIFF estándar
- La estructura de datos de la información de etiquetas
- Cómo leer y escribir etiquetas en aplicaciones prácticas
- 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