请参见:
描述
接口摘要 | |
---|---|
IIOMetadataController | 该接口将由可以确定 IIOMetadata 对象设置值(通过提供一个 GUI 来从用户那里获取值或其他方式)的对象实现。 |
IIOMetadataFormat | 描述从 IIOMetadata.getAsTree 返回并传递给 IIOMetadata.setFromTree 和 mergeTree 的元数据文档结构的对象。 |
类摘要 | |
---|---|
IIOMetadata | 将由表示与图像和流关联的元数据(非图像数据)的对象扩展的抽象类。 |
IIOMetadataFormatImpl | 提供 IIOMetadataFormat 接口的可重用实现的具体类。 |
IIOMetadataNode | 表示元数据树中节点的类,该类实现 org.w3c.dom.Element 接口,还允许通过 getUserObject 和 setUserObject 方法存储非文本对象。 |
异常摘要 | |
---|---|
IIOInvalidTreeException | 当 IIOMetadata 对象尝试解析 IIOMetadataNode 的树失败时,将抛出 IIOInvalidTreeException 。 |
用于处理读写元数据的 Java Image I/O API 的包。
读取图像时,其每个流和每个图像元数据都可以作为 IIOMetadata
对象使用。此对象的内部特定于创建它的插件。其内容能够以作为 IIOMetadataNode
对象的树实现的 XML Document
的形式访问。
写入图像时,其元数据可以通过定义或修改 IIOMetadata
对象设置。这种对象可以从(javax.imageio
包中的)ImageWriter
或 ImageTranscoder
获得。获得这种对象后,就可以通过修改由 IIOMetadataNode
组成的 Document
来设置其内容。可以选择是否使用 IIOMetadataFormat
对象来描述文档格式。
XML Document
中所含元数据的格式由一个字符串标识,该字符串作为 IIOMetadataNode
对象的树的根节点出现。此字符串包含版本号,例如,"javax_imageio_jpeg_image_1.0"。Reader 和 writer 可能支持同一基本格式的多个版本号,Image I/O API 的方法可以通过将字符串传递给用于获取 IIOMetadata
对象的方法/构造方法来指定要使用的版本。在某些情况下,较新的版本可能与按较旧版本编写的程序不完全兼容(有关示例,请参见下文 JPEG 元数据用法说明的 Native Metadata Format 一节)。
插件可以选择支持标准(插件无关)格式。此格式不提供元数据的无损耗编码,但是允许以通用方式访问部分元数据。
每个标准插件都支持所谓的“本机”元数据格式,该格式以无损耗的方式编码其元数据: