パッケージ javax.imageio

Java Image I/O APIの基本パッケージです。

参照: 説明

インタフェースのサマリー

インタフェース	説明
IIOParamController	GUIを使用してユーザーから値を取得するか、またはほかの手段によって、IIOParamオブジェクトの設定値を判定できるオブジェクトにより実装されるインタフェースです。
ImageTranscoder	メタデータ変換機能を提供するインタフェースです。

クラスのサマリー

クラス	説明
IIOImage	イメージ、サムネール(プレビュー)イメージ・セット、およびイメージに関連するメタデータを表すオブジェクトを集合させる単純なコンテナ・クラスです。
IIOParam	ストリームをデコードまたはエンコードする方法を記述する、すべてのクラスのスーパー・クラスです。
ImageIO	ImageReaderおよびImageWriterを検索する静的な簡易メソッドを保持して、簡単なエンコードとデコードを実行するクラスです。
ImageReader	イメージを解析してデコードする抽象スーパー・クラスです。
ImageReadParam	ストリームがデコードされる方法を記述するクラスです。
ImageTypeSpecifier	イメージの形式、特にSampleModelとColorModelを、便利な方法で指定できるようにするクラスです。
ImageWriteParam	ストリームのエンコードの方法を記述するクラスです。
ImageWriter	エンコードとイメージの書込みのための抽象スーパー・クラスです。

例外のサマリー

例外	説明
IIOException	読み込み/書込み操作の実行時障害を通知する例外クラスです。

パッケージjavax.imageioの説明

Java Image I/O APIの基本パッケージです。

ImageIOクラスのstaticメソッドを使用して、多くの共通イメージI/O操作を実行できます。

このパッケージに含まれる基本クラスとインタフェースは、メタデータとサムネール(IIOImage)を含むイメージ・ファイルの内容を記述するためのもの、イメージ読込み処理(ImageReader、ImageReadParam、ImageTypeSpecifier)とイメージ書込み処理(ImageWriterとImageWriteParam)を制御するためのもの、形式間の変換(ImageTranscoder)を実行するためのもの、エラー報告(IIOException)を行うためのものがあります。

javax.imageioのすべての実装に、次の標準イメージ形式のプラグインが用意されています。

	読込み	書込み	注記	メタデータ
JPEG	はい	はい	なし	JPEGメタデータ形式
PNG	はい	はい	なし	PNGメタデータ形式
BMP	はい	はい	なし	BMPメタデータ形式
WBMP	はい	はい	なし	WBMPメタデータ形式
GIF	はい	はい	GIFプラグインに関する注記	GIFメタデータ形式

標準プラグインに関する注記

GIFイメージ形式の標準プラグイン

ImageIOは、Graphics Interchange Format (GIF)イメージ形式に対応したImageReaderおよびImageWriterプラグインを提供します。これらはJREに含まれる「標準」のGIFプラグインであり、標準拡張機能に含まれるプラグインやサード・パーティのプラグインとは異なります。次の注記およびメタデータ仕様が、標準プラグインに適用されます。

GIFイメージの書込み

GIFイメージ・ライター・プラグインでは、次の要件を満たすイメージの損失のない書込みが保証されます。

• バンド数が1である
• サンプルごとのビット数が8以下である
• 色成分のサイズが8以下である

デフォルトでは、GIFライター・プラグインによりバージョン「89a」のイメージが作成されます。これは、ストリーム・メタデータのバージョンを明示的に設定することにより「87a」に変更できます。GIFストリーム・メタデータ形式の仕様を参照してください。

GIFライター・プラグインを使用すると、ImageWriterクラスで定義された標準シーケンス書込みメソッドを使用して動画GIFイメージを作成できます。

次の条件のいずれかが満たされると、グローバル・カラー表が出力ストリームに書き込まれます。

• GlobalColorTable要素を含むストリーム・メタデータが提供される
• シーケンスが書込み中であり、シーケンス内の最初のイメージに対してLocalColorTable要素を含むイメージ・メタデータが提供される
• イメージ・メタデータが提供されないか、イメージ・メタデータにLocalColorTable要素が含まれない

最初の条件が当てはまる場合はストリーム・メタデータ内のグローバル・カラー表が使用され、2番目の条件が当てはまる場合はイメージ・メタデータ内のローカル・カラー表が使用されます。3番目の条件が当てはまる場合は、(最初の)イメージのColorModelまたはSampleModelからグローバル・カラー表が作成されます。

ローカル・カラー表が出力ストリームに書き込まれるのは、LocalColorTable要素を含むイメージ・メタデータがライターに提供される場合、またはイメージ・メタデータがライターに提供されず、イメージ自体から生成されるローカル・カラー表がグローバル・カラー表と等しくない場合だけです。

Graphic Control Extensionブロックが出力ストリームに書き込まれるのは、GraphicControlExtension要素を含むイメージ・メタデータがライターに提供される場合、またはイメージ・メタデータが提供されず、イメージから生成されるローカル・カラー表に透明インデックスが必要な場合だけです。Application、Plain Text、およびComment Extensionブロックが書き込まれるのは、これらのブロックがイメージ・メタデータを介してライターに提供される場合だけです。

インタレース・イメージの書込みは、指定したImageWriteParamインスタンスのプログレッシブ・モードを使って制御できます。プログレッシブ・モードがMODE_DISABLEDの場合は、インタレースでないイメージが書き込まれます。プログレッシブ・モードがMODE_DEFAULTの場合は、インタレース・イメージが書き込まれます。プログレッシブ・モードがMODE_COPY_FROM_METADATAの場合、メタデータ設定が使用されます(メタデータ設定が指定済みの場合)。メタデータ設定が指定されない場合は、インタレース・イメージが書き込まれます。

GIFイメージ・ライター・プラグインを使用すると、ライターに渡されたメタデータから取得した出力ストリーム・メタデータを、ネイティブGIFストリーム・メタデータ形式javax_imageio_gif_stream_1.0または標準メタデータ形式javax_imageio_1.0に設定できます。また、ライターに渡されたメタデータから取得した出力イメージ・メタデータを、ネイティブGIFイメージ・メタデータ形式javax_imageio_gif_image_1.0または標準メタデータ形式javax_imageio_1.0に設定できます。標準メタデータ形式のGIFネイティブ・ストリームおよびイメージ・メタデータ形式へのマッピングについては、こちらの表を参照してください。

導入されたバージョン:

1.4