JavaTM 2 Platform
Standard Ed. 6

软件包 javax.imageio

Java Image I/O API 的主要包。

请参见:
          描述

接口摘要
IIOParamController 该接口将由可以确定 IIOParam 对象设置值(通过提供一个 GUI 来从用户那里获取值或其他方式)的对象实现。
ImageTranscoder 提供元数据代码转换功能的接口。
 

类摘要
IIOImage 一个聚集图像、缩略(预览)图像集和表示与图像关联的元数据的对象的简单容器类。
IIOParam 所有描述应该如何对流进行编码和解码的类的超类。
ImageIO 该类包含一些用来查找 ImageReaderImageWriter 以及执行简单编码和解码的静态便捷方法。
ImageReader 用来解析和解码图像的抽象超类。
ImageReadParam 描述如何对流进行解码的类。
ImageTypeSpecifier 允许以便捷方式指定图像格式(尤其是其 SampleModelColorModel)的类。
ImageWriteParam 描述如何对流进行编码的类。
ImageWriter 用来编码和写入图像的抽象超类。
 

异常摘要
IIOException 该异常类用于发出关于读取和写入操作的运行时故障的信号。
 

软件包 javax.imageio 的描述

Java Image I/O API 的主要包。

使用 ImageIO 类的静态方法可以执行许多常见的图像 I/O 操作。

此包包含一些基本类和接口,有的用来描述图像文件内容(包括元数据和缩略图)(IIOImage);有的用来控制图像读取过程(ImageReaderImageReadParamImageTypeSpecifier)和图像写入过程(ImageWriterImageWriteParam);还有的用来执行格式之间的代码转换 (ImageTranscoder) 和报告错误 (IIOException)。

javax.imageio 的所有实现都提供以下标准图像格式插件:

  读取 写入 注意事项 元数据
JPEG JPEG 元数据格式
PNG PNG 元数据格式
BMP BMP 元数据格式
WBMP WBMP 元数据格式
GIF GIF 插件注意事项 GIF 元数据格式



标准插件注意事项

GIF 图像格式的标准插件

ImageIO 为图形交换格式 (GIF) 图像格式提供 ImageReaderImageWriter 插件。 这些是“标准”GIF 插件(意味着 JRE 中包含的插件与标准扩展中包含的插件不同)或是第三方插件。下列注意事项和元数据规范适用于标准插件。

写入 GIF 图像

GIF 图像 writer 插件保证满足以下要求的图像能无损失地写入:

默认情况下,GIF writer 插件创建 "89a" 版本的图像。这可以更改为 "87a",将该版本在流元数据中显式设置即可(请参阅 GIF 流元数据格式规范)。

GIF writer 插件通过写入 ImageWriter 类中定义方法的标准序列,可支持创建动画 GIF 图像。

如果满足以下条件之一,全局颜色表将被写入输出流:

在第一种情况下,使用流元数据中的全局颜色表,在第二种情况下,使用图像元数据中的局部颜色表,在第三种情况下,根据 ColorModel 或(第一个)图像的 SampleModel 创建全局颜色表。

只有将包含 LocalColorTable 元素的图像元数据提供给 writer,或者没有图像元数据提供给 writer 并且根据其图像本身生成的局部颜色表不等于全局颜色表时,局部颜色表才写入输出流。

只有将包含 GraphicControlExtension 元素的图像元数据提供给 writer,或者不提供图像元数据并且根据图像生成的局部颜色表要求透明索引时,图形控制扩展 (Graphic Control Extension) 块才写入输出流。应用程序 (Application)、纯文本 (Plain Text) 和注释扩展 (Comment Extension) 块只有通过图像元数据提供给 writer 时才写入。

交错图像的写入可通过提供的 ImageWriteParam 实例的逐步模式控制。如果逐步模式是 MODE_DISABLED,则写入非交错图像。如果逐步模式是 MODE_DEFAULT,则写入交错图像。如果逐步模式是 MODE_COPY_FROM_METADATA,则使用元数据设置(如果提供了元数据设置,否则写入交错图像)。

GIF 图像 writer 插件支持根据提供给本机 GIF 流元数据格式 javax_imageio_gif_stream_1.0 或标准元数据格式 javax_imageio_1.0 中 writer 的元数据设置输出流元数据,还支持根据提供给本机 GIF 图像元数据格式 javax_imageio_gif_image_1.0 或标准元数据格式 javax_imageio_1.0 中 writer 的元数据设置输出图像元数据。 标准元数据格式到 GIF 本机流以及图像元数据格式的映射在此表中给出。

从以下版本开始:
1.4

JavaTM 2 Platform
Standard Ed. 6

提交错误或意见
有关更多的 API 参考资料和开发人员文档,请参阅 Java 2 SDK SE 开发人员文档。该文档包含更详细的、面向开发人员的描述,以及总体概述、术语定义、使用技巧和工作代码示例。

版权所有 2004 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策