javax.imageio

Class IIOImage

java.lang.Object

javax.imageio.IIOImage

public class IIOImage
extends Object

一个简单的容器类来聚合一个图像，一组缩略图（预览）图像，以及一个表示与图像相关的元数据的对象。

图像数据将是一个RenderedImage形式，或Raster。读者的方法，返回一个IIOImage将总是返回一个BufferedImage使用RenderedImage参考。作家的方法，接受IIOImage永远接受RenderedImage，和可以接受Raster。

整整一个getRenderedImage和getRaster将返回一个non-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)

Field Summary

Fields

Modifier and Type	Field and Description
protected RenderedImage	image 被引用的 RenderedImage。
protected IIOMetadata	metadata 包含与图像相关的元数据的一个 IIOMetadata对象。
protected Raster	raster 被引用的 Raster。
protected List<? extends BufferedImage>	thumbnails 一个 List的 BufferedImage缩略图，或 null。

构造方法摘要

构造方法

Constructor and Description
IIOImage(Raster raster, List<? extends BufferedImage> thumbnails, IIOMetadata metadata) 构建了一个 IIOImage含有 Raster，和缩略图和与之相关的元数据。
IIOImage(RenderedImage image, List<? extends BufferedImage> thumbnails, IIOMetadata metadata) 构建了一个 IIOImage含有 RenderedImage，和缩略图和与之相关的元数据。

方法摘要

Modifier and Type	Method and Description
IIOMetadata	getMetadata() 返回一个引用当前 IIOMetadata对象，或 null没有设置。
int	getNumThumbnails() 返回存储在这 IIOImage缩略图数量。
Raster	getRaster() 返回当前设置 Raster，或 null如果只有一 RenderedImage是可用的。
RenderedImage	getRenderedImage() 返回当前设置 RenderedImage，或 null如果只有一 Raster是可用的。
BufferedImage	getThumbnail(int index) 返回与主图像相关联的缩略图。
List<? extends BufferedImage>	getThumbnails() 返回当前 List BufferedImages缩略图，或 null如果没有设置。
boolean	hasRaster() 返回 true如果这 IIOImage商店而不是一个 RenderedImage Raster。
void	setMetadata(IIOMetadata metadata) 设置新对象的 IIOMetadata，或 null。
void	setRaster(Raster raster) 设置当前 Raster。
void	setRenderedImage(RenderedImage image) 设置当前 RenderedImage。
void	setThumbnails(List<? extends BufferedImage> thumbnails) 集到一个新的 List BufferedImages缩略图列表，或 null。

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

image

protected RenderedImage image

被引用的 RenderedImage。

raster

protected Raster raster

被引用的 Raster。

thumbnails

protected List<? extends BufferedImage> thumbnails

一个 List的 BufferedImage缩略图，或 null。非 BufferedImage物品不得存放在这 List。

metadata

protected IIOMetadata metadata

包含与图像相关的元数据的一个 IIOMetadata对象。

Constructor Detail

IIOImage

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

构建了一个 IIOImage含有 RenderedImage，和缩略图和与之相关的元数据。

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

的thumbnails论点必须null或只包含BufferedImage对象。

参数

image - RenderedImage。

thumbnails - List的 BufferedImages，或 null。

metadata - IIOMetadata对象，或 null。

异常

如果是 null image IllegalArgumentException。

IIOImage

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

构建了一个 IIOImage含有 Raster，和缩略图和与之相关的元数据。

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

参数

raster - Raster。

thumbnails - List的 BufferedImages，或 null。

metadata - IIOMetadata对象，或 null。

异常

如果是 null raster IllegalArgumentException。

方法详细信息

getRenderedImage

public RenderedImage getRenderedImage()

返回当前设置 RenderedImage，或 null如果只有一 Raster是可用的。

结果

一个 RenderedImage，或 null。

另请参见：

setRenderedImage(java.awt.image.RenderedImage)

setRenderedImage

public void setRenderedImage(RenderedImage image)

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

参数

image - RenderedImage。

异常

如果是 null image IllegalArgumentException。

另请参见：

getRenderedImage()

hasRaster

public boolean hasRaster()

返回 true如果这 IIOImage商店而不是一个 RenderedImage Raster。

结果

true如果 Raster是可用的。

getRaster

public Raster getRaster()

返回当前设置 Raster，或 null如果只有一 RenderedImage是可用的。

结果

一个 Raster，或 null。

另请参见：

setRaster(java.awt.image.Raster)

setRaster

public void setRaster(Raster raster)

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

参数

raster - Raster。

异常

如果是 null raster IllegalArgumentException。

另请参见：

getRaster()

getNumThumbnails

public int getNumThumbnails()

返回存储在这 IIOImage缩略图数量。

结果

缩略图数量，作为一个 int。

getThumbnail

public BufferedImage getThumbnail(int index)

返回与主图像相关联的缩略图。

参数

index -所需的缩略图图像的索引。

结果

缩略图图像，作为一个 BufferedImage。

异常

IndexOutOfBoundsException -如果提供的指数为负数或大于最大有效指数。

ClassCastException如果非 BufferedImage对象在给定的索引在缩略图列表中。

另请参见：

getThumbnails()， setThumbnails(java.util.List<? extends java.awt.image.BufferedImage>)

getThumbnails

public List<? extends BufferedImage> getThumbnails()

返回当前 List BufferedImages缩略图，或 null如果没有设置。返回一个实时引用。

结果

对当前 List BufferedImage缩略图，或 null。

另请参见：

getThumbnail(int)， setThumbnails(java.util.List<? extends java.awt.image.BufferedImage>)

setThumbnails

public void setThumbnails(List<? extends BufferedImage> thumbnails)

集到一个新的 List BufferedImages缩略图列表，或 null。以前的 List参考被丢弃。

的thumbnails论点必须null或只包含BufferedImage对象。

参数

thumbnails - List的 BufferedImage缩略图，或 null。

另请参见：

getThumbnail(int)， getThumbnails()

getMetadata

public IIOMetadata getMetadata()

返回一个引用当前 IIOMetadata对象，或 null没有设置。

结果

一个 IIOMetadata对象，或 null。

另请参见：

setMetadata(javax.imageio.metadata.IIOMetadata)

setMetadata

public void setMetadata(IIOMetadata metadata)

设置新对象的 IIOMetadata，或 null。

参数

metadata - IIOMetadata对象，或 null。

另请参见：

getMetadata()