- java.lang.Object
-
- javax.imageio.IIOImage
-
public class IIOImage extends Object
イメージ、サムネール(プレビュー)イメージ・セット、およびイメージに関連するメタデータを表すオブジェクトを集合させる単純なコンテナ・クラスです。イメージ・データは、
RenderedImage
形式かRaster
形式のいずれかを取ります。IIOImage
を返す読込み用メソッドは、RenderedImage
参照を使用して、常にBufferedImage
を返します。IIOImage
を受け入れる書込み用メソッドは、常にRenderedImage
を受け入れますが、オプションによってRaster
を受け入れる場合もあります。getRenderedImage
とgetRaster
のうちの1つが確実に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)
Raster
を保持するIIOImage
と、それに関連するサムネールとメタデータを構築します。IIOImage(RenderedImage image, List<? extends BufferedImage> thumbnails, IIOMetadata metadata)
RenderedImage
を保持するIIOImage
と、それに関連するサムネールとメタデータを構築します。
-
メソッドのサマリー
修飾子と型 メソッド 説明 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
がRenderedImage
ではなく、Raster
を格納する場合は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
に設定します。
-
-
-
フィールドの詳細
-
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)
RenderedImage
を保持するIIOImage
と、それに関連するサムネールとメタデータを構築します。すべてのパラメータが参照によって格納されます。
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)
Raster
を保持するIIOImage
と、それに関連するサムネールとメタデータを構築します。すべてのパラメータが参照によって格納されます。
- パラメータ:
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
がRenderedImage
ではなく、Raster
を格納する場合は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<? extends java.awt.image.BufferedImage>)
-
getThumbnails
public List<? extends BufferedImage> getThumbnails()
サムネールBufferedImage
の最新List
を返します。何も設定されていない場合はnull
を返します。 ライブ参照は返されます。- 戻り値:
BufferedImage
サムネールの現在のList
またはnull
。- 関連項目:
getThumbnail(int)
,setThumbnails(java.util.List<? extends java.awt.image.BufferedImage>)
-
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()
-
-