javax.imageio.metadata (Java 2 Platform SE 5.0) - JavaTM 2 Platform Standard Edition 5.0 API 规范中文版
|
JavaTM 2 Platform Standard Ed. 5.0 |
|||||||||
| 上一个软件包 下一个软件包 | 框架 无框架 | |||||||||
软件包 javax.imageio.metadata
用于处理读写元数据的 Java Image I/O API 的包。
请参见：
描述
| 接口摘要 | |
|---|---|
| IIOMetadataController | 该接口将由可以确定 IIOMetadata 对象设置值（通过提供一个 GUI 来从用户那里获取值或其他方式）的对象实现。 |
| IIOMetadataFormat | 描述从 IIOMetadata.getAsTree 返回并传递给 IIOMetadata.setFromTree 和 mergeTree 的元数据文档结构的对象。 |
| 类摘要 | |
|---|---|
| IIOMetadata | 将由表示与图像和流关联的元数据（非图像数据）的对象扩展的抽象类。 |
| IIOMetadataFormatImpl | 提供 IIOMetadataFormat 接口的可重用实现的具体类。 |
| IIOMetadataNode | 表示元数据树中节点的类，该类实现 org.w3c.dom.Element 接口，还允许通过 getUserObject 和 setUserObject 方法存储非文本对象。 |
| 异常摘要 | |
|---|---|
| IIOInvalidTreeException | 当 IIOMetadata 对象尝试解析 IIOMetadataNode 的树失败时，将抛出 IIOInvalidTreeException。 |
软件包 javax.imageio.metadata 的描述
用于处理读写元数据的 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 一节）。
插件可以选择支持标准（插件无关）格式。此格式不提供元数据的无损耗编码，但是允许以通用方式访问部分元数据。
每个标准插件都支持所谓的“本机”元数据格式，该格式以无损耗的方式编码其元数据：
- 从以下版本开始：
- 1.4
|
JavaTM 2 Platform Standard Ed. 5.0 |
|||||||||
| 上一个软件包 下一个软件包 | 框架 无框架 | |||||||||
提交错误或意见
有关更多的 API 参考资料和开发人员文档，请参阅 Java 2 SDK SE 开发人员文档。该文档包含更详细的、面向开发人员的描述，以及总体概述、术语定义、使用技巧和工作代码示例。
版权所有 2004 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策。