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
参照されたRenderedImage
です。protected IIOMetadata
イメージに関連したメタデータを保持するIIOMetadata
オブジェクト。protected Raster
参照されたRaster
です。protected List<? extends BufferedImage>
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
オブジェクトへの参照を返します。何も設定されない場合は、null
を返します。int
このIIOImage
に格納されているサムネールの数を返します。現在設定されているRaster
か、RenderedImage
だけを使用できる場合はnull
を返します。現在設定されているRenderedImage
か、Raster
だけを使用できる場合はnull
を返します。getThumbnail
(int index) メイン・イメージに関連するサムネールを返します。List<? extends BufferedImage>
サムネールBufferedImage
の最新List
を返します。何も設定されていない場合はnull
を返します。boolean
このIIOImage
がRenderedImage
ではなく、Raster
を格納する場合はtrue
を返します。void
setMetadata
(IIOMetadata metadata) IIOMetadata
を新しいオブジェクトか、null
に設定します。void
現在の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> thumbnailsBufferedImage
サムネールの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
public void setRenderedImage(RenderedImage image) 現在のRenderedImage
を設定します。 値は参照によって格納されます。 既存のRaster
は破棄されます。- パラメータ:
image
-RenderedImage
- 例外:
IllegalArgumentException
-image
がnull
の場合。- 関連項目:
-
hasRaster
public boolean hasRaster()このIIOImage
がRenderedImage
ではなく、Raster
を格納する場合はtrue
を返します。- 戻り値:
Raster
が使用できる場合はtrue
。
-
getRaster
public Raster getRaster()現在設定されているRaster
か、RenderedImage
だけを使用できる場合はnull
を返します。- 戻り値:
Raster
、またはnull
。- 関連項目:
-
setRaster
public void setRaster(Raster raster) 現在のRaster
を設定します。 値は参照によって格納されます。 既存のRenderedImage
は破棄されます。- パラメータ:
raster
-Raster
- 例外:
IllegalArgumentException
-raster
がnull
の場合。- 関連項目:
-
getNumThumbnails
public int getNumThumbnails()このIIOImage
に格納されているサムネールの数を返します。- 戻り値:
int
としてのサムネールの数。
-
getThumbnail
public BufferedImage getThumbnail(int index) メイン・イメージに関連するサムネールを返します。- パラメータ:
index
- 目的のサムネール・イメージのインデックス。- 戻り値:
BufferedImage
としてのサムネール・イメージ。- 例外:
IndexOutOfBoundsException
- 指定されたインデックスが負か、有効な最大のインデックスよりも大きい場合。ClassCastException
-BufferedImage
以外のオブジェクトが、指定されたインデックスのサムネールのリストで検出された場合。- 関連項目:
-
getThumbnails
public List<? extends BufferedImage> getThumbnails()サムネールBufferedImage
の最新List
を返します。何も設定されていない場合はnull
を返します。 ライブ参照は返されます。- 戻り値:
BufferedImage
サムネールの現在のList
またはnull
。- 関連項目:
-
setThumbnails
public void setThumbnails(List<? extends BufferedImage> thumbnails) サムネールのリストを、新しいBufferedImage
のList
か、null
に設定します。 以前のList
への参照は破棄されます。thumbnails
引数は、null
であるか、BufferedImage
オブジェクトだけを含みます。- パラメータ:
thumbnails
-BufferedImage
サムネールのList
、またはnull
。- 関連項目:
-
getMetadata
public IIOMetadata getMetadata()現在のIIOMetadata
オブジェクトへの参照を返します。何も設定されない場合は、null
を返します。- 戻り値:
IIOMetadata
オブジェクト、またはnull
。- 関連項目:
-
setMetadata
public void setMetadata(IIOMetadata metadata) IIOMetadata
を新しいオブジェクトか、null
に設定します。- パラメータ:
metadata
-IIOMetadata
オブジェクト、またはnull
。- 関連項目:
-