- 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)
-
-
Field Summary
Fields Modifier and Type Field 描述 protected RenderedImage
image
参考RenderedImage
。protected IIOMetadata
metadata
包含与图像相关联的元数据的IIOMetadata
对象。protected Raster
raster
Raster
被引用。protected List<? extends BufferedImage>
thumbnails
AList
的BufferedImage
缩略图,或null
。
-
构造方法摘要
构造方法 Constructor 描述 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 方法 描述 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
的BufferedImage
缩略图,或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
- aList
(BufferedImage
)或null
。 -
metadata
- 一个IIOMetadata
对象,或null
。 - 异常
-
IllegalArgumentException
- 如果image
为null
。
-
IIOImage
public IIOImage(Raster raster, List<? extends BufferedImage> thumbnails, IIOMetadata metadata)
构造一个IIOImage
含有Raster
,和缩略图和元数据与之相关联。所有参数通过参考存储。
- 参数
-
raster
- aRaster
。 -
thumbnails
- aList
的BufferedImage
s或null
。 -
metadata
- 一个IIOMetadata
对象,或null
。 - 异常
-
IllegalArgumentException
- 如果raster
是null
。
-
-
方法详细信息
-
getRenderedImage
public RenderedImage getRenderedImage()
如果只有Raster
可用,则返回当前设置的RenderedImage
或null
。- 结果
-
一个
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
。- 结果
-
一个
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
- aList
的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()
-
-