Пакет 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, 2023, 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/21/docs/api/java.desktop/javax/imageio/metadata/package-summary.html
