Java javax.imageio 类 IIOImage（JDK5）

136 阅读 0 评论 0 点赞

所有类

概述

软件包

类

使用

树

已过时

索引

帮助

摘要：嵌套 | 字段 | 构造方法 | 方法

详细信息：字段 | 构造方法 | 方法

javax.imageio
类 IIOImage

java.lang.Object
  javax.imageio.IIOImage

public class IIOImage
extends Object
extends Object

一个聚集图像、缩略（预览）图像集和表示与图像关联的元数据的对象的简单容器类。

图像数据可以采用 RenderedImage 或 Raster 的形式。返回 IIOImage 的 reader 方法将总是返回一个使用 RenderedImage 引用的 BufferedImage。接受 IIOImage 的 writer 方法将总是接受 RenderedImage，并且可能有选择地接受 Raster。

getRenderedImage 和 getRaster 中只有一个将返回非 null 值。子类负责确保此行为。

另请参见：: ImageReader.readAll(int, ImageReadParam), ImageReader.readAll(java.util.Iterator), ImageWriter.write(javax.imageio.metadata.IIOMetadata, IIOImage, ImageWriteParam), ImageWriter.write(IIOImage), ImageWriter.writeToSequence(IIOImage, ImageWriteParam), ImageWriter.writeInsert(int, IIOImage, ImageWriteParam)

字段摘要
`protected RenderedImage`	`image` 正被引用的 `RenderedImage`。
`protected IIOMetadata`	`metadata` 包含与图像关联的元数据的 `IIOMetadata` 对象。
`protected Raster`	`raster` 正被引用的 `Raster`。
`protected List<? extends BufferedImage>`	`thumbnails` `BufferedImage` 缩略图的 `List`，或为 `null`。

构造方法摘要
`IIOImage(Raster raster, List<? extends BufferedImage> thumbnails, IIOMetadata metadata)` 构造一个 `IIOImage`，它包含 `Raster` 以及与之关联的缩略图和元数据。
`IIOImage(RenderedImage image, List<? extends BufferedImage> thumbnails, IIOMetadata metadata)` 构造一个 `IIOImage`，它包含 `RenderedImage` 以及与之关联的缩略图和元数据。

方法摘要
`IIOMetadata`	`getMetadata()` 返回对当前 `IIOMetadata` 对象的引用，如果没有设置任何这样的对象，则返回 `null`。
`int`	`getNumThumbnails()` 返回此 `IIOImage` 中存储的缩略图的数量。
`Raster`	`getRaster()` 返回当前设置好的 `Raster`，如果只有一个 `RenderedImage` 可用，则返回 `null`。
`RenderedImage`	`getRenderedImage()` 返回当前设置好的 `RenderedImage`，如果只有一个 `Raster` 可用，则返回 `null`。
`BufferedImage`	`getThumbnail(int index)` 返回与主图像关联的缩略图。
`List<? extends BufferedImage>`	`getThumbnails()` 返回缩略图 `BufferedImage` 的当前 `List`，如果没有设置任何缩略图，则返回 `null`。
`boolean`	`hasRaster()` 如果此 `IIOImage` 存储了一个 `Raster` 而不是 `RenderedImage`，则返回 `true`。
`void`	`setMetadata(IIOMetadata metadata)` 将 `IIOMetadata` 设置为一个新对象或 `null`。
`void`	`setRaster(Raster raster)` 设置当前 `Raster`。
`void`	`setRenderedImage(RenderedImage image)` 设置当前 `RenderedImage`。
`void`	`setThumbnails(List<? extends BufferedImage> thumbnails)` 将缩略图列表设置为 `BufferedImage` 的一个新 `List` 或 `null`。

从类 java.lang.Object 继承的方法
`clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait`

字段详细信息

image

protected RenderedImage image

正被引用的 RenderedImage。

raster

protected Raster raster

正被引用的 Raster。

thumbnails

protected List<? extends BufferedImage> thumbnails

BufferedImage 缩略图的 List，或为 null。非 BufferedImage 对象一定不能存储在此 List 中。

metadata

protected IIOMetadata metadata

包含与图像关联的元数据的 IIOMetadata 对象。

构造方法详细信息

IIOImage

public IIOImage(RenderedImage image,
                List<? extends BufferedImage> thumbnails,
                IIOMetadata metadata)

构造一个 IIOImage，它包含 RenderedImage 以及与之关联的缩略图和元数据。

所有参数都是通过引用进行存储的。

thumbnails 参数必须为 null 或者只包含 BufferedImage 对象。

参数：: image - 一个 RenderedImage。; thumbnails - BufferedImage 的 List，或者为 null。; metadata - IIOMetadata 对象，或者为 null。
抛出：: IllegalArgumentException - 如果 image 为 null。

IIOImage

public IIOImage(Raster raster,
                List<? extends BufferedImage> thumbnails,
                IIOMetadata metadata)

构造一个 IIOImage，它包含 Raster 以及与之关联的缩略图和元数据。

所有参数都是通过引用进行存储的。

参数：: raster - 一个 Raster。; thumbnails - BufferedImage 的 List，或者为 null。; metadata - IIOMetadata 对象，或者为 null。
抛出：: IllegalArgumentException - 如果 raster 为 null。

方法详细信息

getRenderedImage

public RenderedImage getRenderedImage()

返回当前设置好的 RenderedImage，如果只有一个 Raster 可用，则返回 null。

返回：: RenderedImage 或 null。
另请参见：: setRenderedImage(java.awt.image.RenderedImage)

setRenderedImage

public void setRenderedImage(RenderedImage image)

设置当前 RenderedImage。该值是通过引用进行存储的。任何现有 Raster 都被丢弃。

参数：: image - 一个 RenderedImage。
抛出：: IllegalArgumentException - 如果 image 为 null。
另请参见：: getRenderedImage()

hasRaster

public boolean hasRaster()

如果此 IIOImage 存储了一个 Raster 而不是 RenderedImage，则返回 true。

返回：: 如果 Raster 可用，则返回 true。