ナビゲーション・リンクをスキップ
Java(tm) Platform
Standard Edition 8

パッケージ javax.imageio

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

参照: 説明

パッケージjavax.imageioの説明

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

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

このパッケージに含まれる基本クラスとインタフェースは、メタデータとサムネール(IIOImage)を含むイメージ・ファイルの内容を記述するためのもの、イメージ読込み処理(ImageReaderImageReadParamImageTypeSpecifier)とイメージ書込み処理(ImageWriterImageWriteParam)を制御するためのもの、形式間の変換(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イメージ・ライター・プラグインでは、次の要件を満たすイメージの損失のない書込みが保証されます。

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

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

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

最初の条件が当てはまる場合はストリーム・メタデータ内のグローバル・カラー表が使用され、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
ナビゲーション・リンクをスキップ
Java(tm) Platform
Standard Edition 8

バグまたは機能を送信
詳細なAPIリファレンスおよび開発者ドキュメントについては、Java SEのドキュメントを参照してください。そのドキュメントには、概念的な概要、用語の定義、回避方法、有効なコード例などの、開発者を対象にしたより詳細な説明が含まれています。
Copyright© 1993, 2014, Oracle and/or its affiliates. All rights reserved.