Модуль TiffTags в Pillow

TiffTags — это подмодуль библиотеки обработки изображений Python Pillow (PIL), специально предназначенный для работы с информацией о тегах в файлах изображений TIFF (Tagged Image File Format).

TIFF — это гибкий формат растровых изображений, поддерживающий множество методов сжатия и цветовых пространств, широко используемый в области профессиональной обработки изображений.

В файлах TIFF различные атрибуты и метаданные изображения хранятся в тегах, а модуль TiffTags предоставляет возможности для доступа к этим тегам и управления ими.

Способ импорта:

from PIL.TiffTags import TAGS_V2

Основные функции

Модуль TiffTags в основном предоставляет следующие функции:

  1. Определение стандартных тегов TIFF и их атрибутов
  2. Обеспечивает сопоставление между именами тегов и идентификаторами
  3. Описывает типы данных тегов и диапазоны значений
  4. Поддерживает обработку пользовательских тегов

Объяснение основных методов

Основные методы модуля TiffTags

Ниже приведены наиболее часто используемые методы и их описания в модуле TiffTags:

Метод/атрибут Описание Тип возвращаемого значения Пример
TiffTags.TAGS_V2 Словарь, содержащий все стандартные теги TIFF, где ключами являются идентификаторы тегов, а значениями — информация о тегах dict {256: (256, 'ImageWidth', 4, 1, None), ...}
TiffTags.TAGS Устаревший словарь тегов TIFF (сохранён для совместимости) dict То же, что и TAGS_V2
TiffTags.LOOKUP Словарь, сопоставляющий имена тегов с идентификаторами dict {'ImageWidth': 256, ...}
TiffTags.IFD Коллекция тегов IFD (Image File Directory) dict Содержит теги, связанные с IFD
TiffTags.CUSTOM_TAGS Словарь, используемый для хранения пользовательских тегов dict Пользовательский

Структура информации о теге

Информация о каждом теге TIFF представляет собой кортеж из 5 элементов:

  1. ID тега (целое число)
  2. Имя тега (строка)
  3. Тип данных (целое число, соответствующее спецификации TIFF)
  4. Длина значения (целое число)
  5. Значение по умолчанию или особые примечания (необязательно)

Таблица соответствия типов данных

Код типа Тип данных Описание
1 BYTE 8-битное беззнаковое целое число
2 ASCII 7-битные символы ASCII
3 SHORT 16-битное беззнаковое целое число
4 LONG 32-битное беззнаковое целое
5 RATIONAL Два LONGs, представляющие дробь
6 SBYTE 8-битное знаковое целое число
7 UNDEFINED 8-битные неопределённые данные
8 SSHORT 16-битное знаковое целое число
9 SLONG 32-битное целое число со знаком
10 SRATIONAL Два значения SLONG, представляющие знаковую дробь
11 FLOAT 32-битное число с плавающей запятой IEEE
12 DOUBLE 64-битное число с плавающей запятой IEEE

Примеры практического применения

Пример 1: Просмотр всех тегов TIFF

Пример

from PIL.TiffTags import TAGS_V2

# Вывести все стандартные теги TIFF
for tag_id, tag_info in TAGS_V2.items():
    print(f"ID: {tag_id}, Имя: {tag_info[1]}, Тип: {tag_info[2]}")

Пример 2: Поиск ID тега по имени

Пример

from PIL.TiffTags import LOOKUP

# Найти ID тега "Artist"
artist_tag_id = LOOKUP.get('Artist')
print(f"ID тега Artist: {artist_tag_id}")  # Вывод: 315

Пример 3: Чтение информации о тегах TIFF-файла

Пример

from PIL import Image
from PIL.TiffTags import TAGS

# Открыть файл TIFF
with Image.open('example.tif') as img:
    # Получить все теги
    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}")

Продвинутое использование

Обработка пользовательских тегов

Пример

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

# Определить пользовательские теги
CUSTOM_TAGS = {
    50000: (50000, 'MyCustomTag', 2, 1, None)
}

# Объединить стандартные и пользовательские теги
ALL_TAGS = {**TAGS_V2, **CUSTOM_TAGS}

# Сохранить файл TIFF с использованием пользовательских тегов
img = Image.new('RGB', (100, 100))
img.save('custom.tif', tiffinfo={50000: 'CustomValue'})

ЧАВО

Вопрос 1: Почему некоторые TIFF-теги невозможно прочитать?

Ответ 1: Это может быть потому, что тег не определён в стандартном TAGS_V2, или используется приватный тег. Можно попробовать проверить спецификацию файла или связаться с создателем файла, чтобы получить определение тега.

Вопрос 2: Как узнать тип данных тега?

Ответ 2: Можно запросить тип данных каждого тега через словарь TAGS_V2. Например,TAGS_V2[256][2]вернёт код типа данных тега ImageWidth.

Вопрос 3: Можно ли изменять TIFF-теги?

Ответ 3: Да, можно использовать метод save из Pillow с параметром tiffinfo для изменения или добавления тегов. Однако учтите, что не все теги можно изменять; некоторые доступны только для чтения.


Итог

Модуль TiffTags — важный инструмент в библиотеке Pillow для обработки метаданных изображений TIFF. Из этой статьи вы должны были узнать:

  1. Как получать доступ к стандартным TIFF-тегам и запрашивать их
  2. Структура данных информации о тегах
  3. Как читать и записывать теги в практических приложениях
  4. Как обрабатывать пользовательские теги

После освоения этих знаний вы сможете более эффективно обрабатывать метаданные в файлах изображений TIFF.

Другие расширения