- java.lang.Object
-
- javax.imageio.IIOImage
-
public class IIOImage extends Object
用于聚合图像的简单容器类,一组缩略图(预览)图像,以及表示与图像关联的元数据的对象。图像数据可以采用
RenderedImage
或Raster
。 阅读方法返回一个IIOImage
总是返回BufferedImage
使用RenderedImage
参考。 接受IIOImage
编写器方法将始终接受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
AList
ofBufferedImage
缩略图,或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()
如果只有RenderedImage
可用,则返回当前设置的Raster
或null
。RenderedImage
getRenderedImage()
如果只有Raster
可用,则返回当前设置的RenderedImage
或null
。BufferedImage
getThumbnail(int index)
返回与主图像关联的缩略图。List<? extends BufferedImage>
getThumbnails()
返回当前List
缩略图BufferedImage
S,或null
,如果没有设置。boolean
hasRaster()
如果此IIOImage
存储Raster
而不是true
则返回RenderedImage
。void
setMetadata(IIOMetadata metadata)
将IIOMetadata
设置为新对象,或null
。void
setRaster(Raster raster)
设置当前Raster
。void
setRenderedImage(RenderedImage image)
设置当前RenderedImage
。void
setThumbnails(List<? extends BufferedImage> thumbnails)
将缩略图列表设置为新的List
(BufferedImage
s)或null
。
-
-
-
字段详细信息
-
image
protected RenderedImage image
RenderedImage
被引用。
-
raster
protected Raster raster
Raster
被引用。
-
thumbnails
protected List<? extends BufferedImage> thumbnails
AList
ofBufferedImage
缩略图,或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
- aRenderedImage
。 -
thumbnails
-List
,共BufferedImage
s,或null
。 -
metadata
-IIOMetadata
对象,或null
。 - 异常
-
IllegalArgumentException
- 如果image
是null
。
-
IIOImage
public IIOImage(Raster raster, List<? extends BufferedImage> thumbnails, IIOMetadata metadata)
构造一个IIOImage
含有Raster
,和缩略图和元数据与之相关联。所有参数都通过引用存储。
- 参数
-
raster
- aRaster
。 -
thumbnails
-List
的BufferedImage
s,或null
。 -
metadata
-IIOMetadata
对象,或null
。 - 异常
-
IllegalArgumentException
- 如果raster
是null
。
-
-
方法详细信息
-
getRenderedImage
public RenderedImage getRenderedImage()
如果只有Raster
可用,则返回当前设置的RenderedImage
或null
。- 结果
-
a
RenderedImage
,或null
。 - 另请参见:
-
setRenderedImage(java.awt.image.RenderedImage)
-
setRenderedImage
public void setRenderedImage(RenderedImage image)
设置当前RenderedImage
。 该值通过引用存储。 任何现有的Raster
都将被丢弃。- 参数
-
image
- aRenderedImage
。 - 异常
-
IllegalArgumentException
- 如果image
是null
。 - 另请参见:
-
getRenderedImage()
-
hasRaster
public boolean hasRaster()
如果IIOImage
存储Raster
而不是true
则返回RenderedImage
。- 结果
-
true
若有Raster
可用。
-
getRaster
public Raster getRaster()
如果只有RenderedImage
可用,则返回当前设置的Raster
或null
。- 结果
-
a
Raster
,或null
。 - 另请参见:
-
setRaster(java.awt.image.Raster)
-
setRaster
public void setRaster(Raster raster)
设置当前Raster
。 该值通过引用存储。 任何现有的RenderedImage
都将被丢弃。- 参数
-
raster
- aRaster
。 - 异常
-
IllegalArgumentException
- 如果raster
是null
。 - 另请参见:
-
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
缩略图BufferedImage
S,或null
,如果没有设置。 返回实时参考。- 结果
-
目前
List
的BufferedImage
缩略图,或null
。 - 另请参见:
-
getThumbnail(int)
,setThumbnails(java.util.List<? extends java.awt.image.BufferedImage>)
-
setThumbnails
public void setThumbnails(List<? extends BufferedImage> thumbnails)
将缩略图列表设置为新的List
(BufferedImage
s)或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()
-
-