| 接口 | 描述 |
|---|---|
| IIOMetadataController |
要由可以通过放置GUI以从用户获取值或通过其他方式
IIOMetadata对象的设置的对象来实现的接口。
|
| IIOMetadataFormat |
描述从
IIOMetadata.getAsTree返回并传递给
IIOMetadata.setFromTree和
mergeTree的元数据文件的结构的对象。
|
| 类 | 描述 |
|---|---|
| IIOMetadata |
由与图像和流相关联的元数据（非图像数据）的对象扩展的抽象类。
|
| IIOMetadataFormatImpl |
一个具体的类，提供可重用的IIOMetadataFormat
IIOMetadataFormat实现。
|
| IIOMetadataNode |
| 异常 | 描述 |
|---|---|
| IIOInvalidTreeException |
一个
IIOInvalidTreeException当被试图抛出
IIOMetadata对象来解析树
IIOMetadataNode小号失败。
|
当读取图像时，其每流和每图像元数据可用作IIOMetadata对象。 该对象的内部特定于创建它的插件。 其内容可以以Document的形式被访问，其被实现为IIOMetadataNode对象的树。
当写入图像时，可以通过定义或修改一个IIOMetadata对象来设置其元数据。 这样的对象可以从ImageWriter或ImageTranscoder （从javax.imageio包）获得。 一旦获得这样的物体，其内容可以通过由Document组成的IIOMetadataNode进行修改。 可以使用IIOMetadataFormat对象来可选地描述文档格式。
包含在XML Document中的元数据的格式由一个字符串来标识，该字符串显示为IIOMetadataNode对象的树的IIOMetadataNode 。 此字符串包含版本号，例如“javax_imageio_jpeg_image_1.0”。 读者和作者可能支持相同基本格式的多个版本，Image I / O API具有允许通过将字符串传递给用于获取IIOMetadata对象的方法/构造函数来指定要使用哪个版本的方法。 在某些情况下，更新版本可能与预期旧版本的程序严格兼容（例如，请参阅下面的“JPEG元数据使用说明”的本机元数据格式部分）。
插件可以选择支持standard (plug-in neutral) format 。 该格式不提供元数据的无损编码，但允许以通用方式访问部分元数据。
每个标准插件都支持所谓的“本机”元数据格式，可以无损地对其元数据进行编码：