javax.imageio

インタフェース ImageTranscoder

既知のすべての実装クラス:

ImageWriter

public interface ImageTranscoder

メタデータ変換機能を提供するインタフェースです。

読み込みに続いて書き込みするだけで、すべてのイメージを変換、つまりもともと保存されていたイメージとは違う形式で書き込むことができます。ただし、形式の違いのため、この処理中にデータが損失する可能性があります。

一般に、もっとも良い結果が得られるのは、形式固有のメタデータオブジェクトを作成して、イメージとそれに関連付けられたメタデータについてできるだけ多くの情報をカプセル化できる場合です。符号化に使用される固有の ImageWriter によって理解されるためです。

ImageTranscoder は、ストリームごと、イメージごとのメタデータを表す ImageReader が提供する IIOMetadata オブジェクトを、特定の ImageWriter が符号化するのに適した、対応するオブジェクトに変換するために使用します。このインタフェースのメソッドが直接 ImageWriter 上に呼び出される場合、出力はその書き込み側に適したものとなります。

IIOMetadata オブジェクトを書き込み側の固有の形式に変換するときの内部詳細は、その変換する操作のコンテキストに応じて変わります。通常、ImageWriter は、書き込み側が認識できる追加インタフェースが入力オブジェクトに実装されているかどうかを調べます。たとえば、書き込み側と同じメーカーが書き込んだ、読み込み側のプラグインでの読み込み操作によってオブジェクトが取得された場合などがこれにあたります。この場合、プラグイン固有のインタフェースにより、書き込み側は入力オブジェクトにアクセスできます。イメージファイル形式が一定に保たれていれば、ほとんど損失なく再符号化できます。形式が変更されても、書き込み側はできるだけ多くの情報を保存しようとします。

入力オブジェクトが書き込み側で認識できる追加インタフェースを実装しない場合、書き込み側が選択できるのは、IIOMetadata.getAsTree で提供されるツリー表示のような、標準 IIOMetadata インタフェースを介したアクセスだけです。この場合、情報の大部分が失われる可能性があります。

独立した ImageTranscoder は基本的に、上記の例の書き込み側プラグインと同じ機能を持ちます。これは読み込み側プラグインと書き込み側プラグインの両方が使用する private インタフェースを認識し、書き込み側で使用できるオブジェクトを手動でインスタンス化します。生成されるメタデータオブジェクトは、書き込み側から直接使用できます。

ImageTranscoder の独立した実装は、標準 API の一部としては提供されていません。むしろ、このインタフェースの目的は、アプリケーションが必要に応じて実装を発見し、作成する方法を提供することです。

メソッドのサマリー

メソッド

修飾子と型	メソッドと説明
IIOMetadata	convertImageMetadata(IIOMetadata inData, ImageTypeSpecifier imageType, ImageWriteParam param) 符号化に使用でき、必要に応じて、ドキュメントインタフェースまたは符号化に使用する書き込み側プラグインに固有のほかのインタフェースを使用して変更できる、IIOMetadata オブジェクトを返します。
IIOMetadata	convertStreamMetadata(IIOMetadata inData, ImageWriteParam param) 符号化に使用でき、必要に応じて、ドキュメントインタフェースまたは符号化に使用する書き込み側プラグインに固有のほかのインタフェースを使用して変更できる、IIOMetadata オブジェクトを返します。

メソッドの詳細

convertStreamMetadata

IIOMetadata convertStreamMetadata(IIOMetadata inData,
                                ImageWriteParam param)

符号化に使用でき、必要に応じて、ドキュメントインタフェースまたは符号化に使用する書き込み側プラグインに固有のほかのインタフェースを使用して変更できる、IIOMetadata オブジェクトを返します。

ストリームメタデータの構造に影響を与える場合のために、オプションの ImageWriteParam を提供できます。

提供された ImageWriteParam に、書き込み側または変換側が理解しないオプション設定値が含まれる場合、それらの設定値は無視されます。

パラメータ:

inData - ストリームメタデータを表し、返されたオブジェクトの状態の初期化に使用される IIOMetadata オブジェクト。

param - イメージの符号化に使用される ImageWriteParam、または null。

戻り値:

IIOMetadata オブジェクト、またはプラグインがメタデータを符号化する機能を提供しない場合は null。

例外:

IllegalArgumentException - inData が null の場合。

convertImageMetadata

IIOMetadata convertImageMetadata(IIOMetadata inData,
                               ImageTypeSpecifier imageType,
                               ImageWriteParam param)

符号化に使用でき、必要に応じて、ドキュメントインタフェースまたは符号化に使用する書き込み側プラグインに固有のほかのインタフェースを使用して変更できる、IIOMetadata オブジェクトを返します。

イメージメタデータの構造に影響を与える場合のために、オプションの ImageWriteParam を提供できます。

提供された ImageWriteParam に、書き込み側または変換側が理解しないオプション設定値が含まれる場合、それらの設定値は無視されます。

パラメータ:

inData - イメージメタデータを表し、返されたオブジェクトの状態の初期化に使用される IIOMetadata オブジェクト。

imageType - メタデータに関連付けられるイメージの配置と配色情報を示す ImageTypeSpecifier。

param - イメージの符号化に使用される ImageWriteParam、または null。

戻り値:

IIOMetadata オブジェクト、またはプラグインがメタデータを符号化する機能を提供しない場合は null。

例外:

IllegalArgumentException - inData と imageType のどちらかが null である場合。