Пакет javax.imageio.metadata
При чтении изображения, его метаданные для каждого потока и каждого изображения доступны как объект IIOMetadata. Внутреннее устройство этого объекта специфично для плагина, который его создал. Его содержимое можно получить в виде XML-Document, который реализован в виде дерева объектов IIOMetadataNode.
При записи изображения, его метаданные можно задать, определив или изменив объект IIOMetadata. Такой объект можно получить из объекта ImageWriter или ImageTranscoder (из пакета javax.imageio). После получения такого объекта, его содержимое можно установить или изменить с помощью Document, состоящего из IIOMetadataNode. Формат документа можно дополнительно описать с помощью объекта IIOMetadataFormat.
Формат метаданных, содержащихся в 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, 2025, 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://download.java.net/java/early_access/jdk24/docs/api/java.desktop/javax/imageio/metadata/package-summary.html
