概觀  軟體套件   類別  使用  階層樹  已過時  索引  說明 
JavaTM 2 Platform
Standard Ed. 6
 上一個類別   下一個類別 框架    無框架    
摘要： 巢狀 | 欄位 | 建構子 | 方法 詳細資訊： 欄位 | 建構子 | 方法

javax.imageio
類別 IIOImage

java.lang.Object
  繼承者 javax.imageio.IIOImage

public class IIOImage
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。

getRaster

public Raster getRaster()
返回當前設置好的 Raster，如果只有一個 RenderedImage 可用，則返回 null。

返回：
Raster 或 null。
另請參見：
setRaster(java.awt.image.Raster)

setRaster

public void setRaster(Raster raster)
設置當前 Raster。該值是通過參考進行存儲的。任何現有 RenderedImage 都被丟棄。

參數：
raster - 一個 Raster。
拋出：
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)

getThumbnails

public List<? extends BufferedImage> getThumbnails()
返回縮略圖 BufferedImage 的當前 List，如果沒有設置任何縮略圖，則返回 null。返回一個啟動的參考。

返回：
BufferedImage 縮略圖的當前 List；或者 null。
另請參見：
getThumbnail(int), setThumbnails(java.util.List)

setThumbnails

public void setThumbnails(List<? extends BufferedImage> thumbnails)
將縮略圖列表設置為 BufferedImage 的一個新 List 或 null。丟棄對以前 List 的參考。

thumbnails 參數必須為 null 或者只包含 BufferedImage 物件。

參數：
thumbnails - BufferedImage 縮略圖的 List，或者為 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()
概觀  軟體套件   類別  使用  階層樹  已過時  索引  說明 
JavaTM 2 Platform
Standard Ed. 6
 上一個類別   下一個類別 框架    無框架    
摘要： 巢狀 | 欄位 | 建構子 | 方法 詳細資訊： 欄位 | 建構子 | 方法
提交錯誤或意見

版權所有 2008 Sun Microsystems, Inc. 保留所有權利。請遵守GNU General Public License, version 2 only。