Класс TIFFDirectory

public class TIFFDirectory
extends Object
implements Cloneable

Удобный класс для упрощения взаимодействия с нативными метаданными изображения TIFF. Дерево метаданных изображения TIFF представляет собой директорию файла изображения (IFD) из потока TIFF 6.0. IFD состоит из ряда записей IFD, каждая из которых сопоставляет идентификационный номер тега со совместимым значением. Экземпляр класса TIFFDirectory соответствует IFD и содержит набор TIFFField, каждый из которых соответствует записи IFD в IFD.

При чтении экземпляр TIFFDirectory может быть создан путём передачи значения, возвращаемого методом ImageReader.getImageMetadata(), методу createFromMetadata(). Затем поля TIFFField в директории могут быть получены с помощью методов доступа, предоставляемых в этом классе.

При записи объект IIOMetadata для использования одним из методов write() класса ImageWriter может быть создан из экземпляра TIFFDirectory с помощью метода getAsMetadata(). Сам экземпляр TIFFDirectory может быть создан путём конструирования или из объекта IIOMetadata, возвращаемого методом ImageWriter.getDefaultImageMetadata(). Поля TIFFDirectory в директории могут быть установлены с помощью методов-модификаторов, предоставляемых в этом классе.

Экземпляр класса TIFFDirectory осведомлён о номерах тегов в группе TIFFTagSet, связанных с ним. При создании экземпляра TIFFDirectory из объекта нативных метаданных изображения эти наборы тегов выводятся из атрибута tagSets узла TIFFIFD.

У экземпляра TIFFDirectory также может быть родительский TIFFTag. Это произойдёт, если директория представляет собой IFD, отличную от корневого IFD изображения. Родительский тег — это тег записи IFD, являющейся указателем на IFD, представленную этим экземпляром TIFFDirectory. Метод TIFFTag.isIFDPointer() этого родительского TIFFTag должен возвращать значение true. При создании экземпляра TIFFDirectory из объекта нативных метаданных изображения родительский набор тегов устанавливается из атрибута parentTagName соответствующего узла TIFFIFD. Обратите внимание, что экземпляр TIFFDirectory с родительским тегом, отличным от null, будет содержаться в поле данных экземпляра TIFFField, у которого поле тега равно родительскому тегу содержащейся директории.

В качестве примера рассмотрим изображение Exif. Экземпляр TIFFDirectory класса, соответствующий IFD Exif в потоке Exif, будет иметь родительский тег TAG_EXIF_IFD_POINTER и будет включать ExifTIFFTagSet в свою группу известных наборов тегов. Экземпляр TIFFDirectory класса, соответствующий этому IFD Exif, будет содержаться в поле данных экземпляра TIFFField, который в свою очередь будет содержаться в TIFFDirectory класса, соответствующем первичному IFD изображения Exif, который сам по себе будет иметь родительский тег со значением null.

Обратите внимание, что эта реализация не синхронизирована. Если несколько потоков используют экземпляр TIFFDirectory одновременно, и хотя бы один из потоков изменяет директорию, например, добавляя или удаляя TIFFField или TIFFTagSet, она должна быть синхронизирована внешне.