Пакет javax.imageio.metadata
При чтении изображения, его метаданные для каждого потока и изображения становятся доступными как объект IIOMetadata. Внутреннее представление этого объекта специфично для плагина, который его создал. Его содержимое может быть обработано в формате XML Document, реализованного как дерево объектов IIOMetadataNode.
При записи изображения, его метаданные могут быть заданы путём определения или изменения объекта IIOMetadata. Такой объект может быть получен из объекта ImageWriter или ImageTranscoder (из пакета javax.imageio). После получения такого объекта, его содержимое может быть установлено или изменено с помощью объекта Document, состоящего из IIOMetadataNode.
Формат документа метаданных, содержащихся в XML Document, определяется строкой, которая отображается в качестве корневого узла дерева объектов IIOMetadataNode. Эта строка содержит номер версии, например, "javax_imageio_jpeg_image_1.0". Чтецы и записывающие модули могут поддерживать несколько версий одного и того же базового формата, и API Image I/O предоставляет методы, позволяющие указать используемую версию, передавая строку в метод/конструктор, используемый для получения объекта IIOMetadata. В некоторых случаях более новая версия может не быть строго совместима с программой, ожидающей более старую версию (см., например, раздел "Метаданные родного формата" в примечаниях к использованию метаданных JPEG ниже).
Плагины могут выбрать поддержку стандартного (нейтрального для плагина) формата. Этот формат не обеспечивает бес потерь кодирование метаданных, но позволяет получить доступ к части метаданных универсальным способом.
Каждый стандартный плагин поддерживает так называемый "родной" формат метаданных, который кодирует его метаданные без потерь:
- Since:
- 1.4
| Класс | Описание |
|---|---|
| IIOInvalidTreeException | Исключение IIOInvalidTreeException возникает, когда попытка объекта IIOMetadata разобрать дерево IIOMetadataNode объектов терпит неудачу. |
| IIOMetadata | Абстрактный класс, который должен быть расширен объектами, представляющими метаданные (данные, не являющиеся изображением), связанные с изображениями и потоками. |
| IIOMetadataController | Интерфейс, который должен быть реализован объектами, которые могут определять настройки объекта IIOMetadata, либо с помощью графического интерфейса пользователя для получения значений от пользователя, либо другими способами. |
| IIOMetadataFormat | Объект, описывающий структуру документов метаданных, возвращаемых из IIOMetadata.getAsTree и переданных в IIOMetadata.setFromTree и mergeTree. |
| IIOMetadataFormatImpl | Конкретный класс, предоставляющий многократно используемую реализацию интерфейса IIOMetadataFormat. |
| IIOMetadataNode | Класс, представляющий узел в дереве метаданных, реализующий интерфейс org.w3c.dom.Element и дополнительно позволяющий хранить нетекстовые объекты с помощью методов getUserObject и setUserObject. |
© 1993, 2021, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/17/docs/api/java.desktop/javax/imageio/metadata/package-summary.html
