クラスImageWriterSpi
java.lang.Object
javax.imageio.spi.IIOServiceProvider
javax.imageio.spi.ImageReaderWriterSpi
javax.imageio.spi.ImageWriterSpi
- すべての実装されたインタフェース:
RegisterableService
public abstract class ImageWriterSpi extends ImageReaderWriterSpi
ImageWriterのサービス・プロバイダ・インタフェース(SPI)です。 サービス・プロバイダ・クラスの詳細は、IIORegistryクラスのクラス・コメントを参照してください。
各ImageWriterSpiは、関連するImageWriterクラスに関する複数の情報タイプを提供します。
SPIクラスを定義するベンダー名とクラスの簡潔な説明は、getVendorName、getDescription、およびgetVersionメソッドで取得できます。 これらのメソッドは、国際化してロケール固有の出力を行うことが可能です。 これらのメソッドの主な目的は、ポップアップ・メニューやほかのリストを編成するのに使用可能で、簡潔かつ人が書込み可能な情報を提供することです。
サービスに関連する形式名、ファイル接尾辞、およびMIMEタイプのリストは、それぞれgetFormatNames、getFileSuffixes、およびgetMIMETypeメソッドで取得できます。 これらのメソッドは、手動の形式選択、ファイルの命名、またはMIME関連付けに基づき、特定のファイルまたはストリームに書き込むための候補となるImageWriterの識別に使用することができます。
特定のデータ・ストリームを構文解析できる可能性の高いImageWriterを判定するための、より信頼性の高い手段がcanEncodeImageメソッドに用意されています。 サービス・プロバイダは、このメソッドを使用して実際のイメージ内容を検証できます。
このサービス・プロバイダに関連するImageWriterクラスのインスタンスは、createWriterInstanceメソッドを呼び出すことで取得できます。 ネイティブ・ライブラリのロードや大規模な表作成などの負荷の高い初期化は、少なくともこのメソッドが最初に呼び出されるまで延期する必要があります。
- 関連項目:
-
フィールドのサマリー
フィールド修飾子と型フィールド説明protected Class<?>[]getOutputTypesから返されるClassオブジェクトの配列で、最初はnullです。protected String[]getImageReaderSpiNamesから返される文字列の配列で、最初はnullです。static final Class<?>[]非推奨。クラスで宣言されたフィールド ImageReaderWriterSpi
extraImageMetadataFormatClassNames, extraImageMetadataFormatNames, extraStreamMetadataFormatClassNames, extraStreamMetadataFormatNames, MIMETypes, names, nativeImageMetadataFormatClassName, nativeImageMetadataFormatName, nativeStreamMetadataFormatClassName, nativeStreamMetadataFormatName, pluginClassName, suffixes, supportsStandardImageMetadataFormat, supportsStandardStreamMetadataFormat修飾子と型フィールド説明protected String[]このプラグインがサポートするすべての追加イメージ・メタデータ形式のクラス名を含むString配列で、最初はnullです。protected String[]このプラグインがサポートするすべての追加イメージ・メタデータ形式の名前を含むString配列で、最初はnullです。protected String[]このプラグインがサポートするすべての追加ストリーム・メタデータ形式のクラス名を含むString配列で、最初はnullです。protected String[]このプラグインがサポートするすべての追加ストリーム・メタデータ形式の名前を含むString配列で、最初はnullです。protected String[]getMIMETypesから返される文字列の配列で、最初はnullです。protected String[]getFormatNamesから返される文字列の配列で、最初はnullです。protected Stringこのプラグインでサポートされるネイティブのストリーム・メタデータ形式のクラス名を含むStringで、最初はnullです。protected Stringこのプラグインでサポートされるネイティブのストリーム・メタデータ形式の名前を含むStringで、最初はnullです。protected Stringこのプラグインでサポートされるネイティブのストリーム・メタデータ形式のクラス名を含むStringで、最初はnullです。protected Stringこのプラグインでサポートされるネイティブのストリーム・メタデータ形式の名前を含むStringで、最初はnullです。protected String関連するプラグイン・クラスの名前を含むStringで、最初はnullです。protected String[]getFileSuffixesから返される文字列の配列で、最初はnullです。protected booleanこのプラグインがイメージ・メタデータに標準のメタデータ形式をサポートするかどうかを示すbooleanで、最初はfalseです。protected booleanこのプラグインがストリーム・メタデータに標準のメタデータ形式をサポートするかどうかを示すbooleanで、最初はfalseです。クラスで宣言されたフィールド IIOServiceProvider
vendorName, version -
コンストラクタのサマリー
コンストラクタ修飾子コンストラクタ説明protected空白のImageWriterSpiを構築します。ImageWriterSpi(String vendorName, String version, String[] names, String[] suffixes, String[] MIMETypes, String writerClassName, Class<?>[] outputTypes, String[] readerSpiNames, boolean supportsStandardStreamMetadataFormat, String nativeStreamMetadataFormatName, String nativeStreamMetadataFormatClassName, String[] extraStreamMetadataFormatNames, String[] extraStreamMetadataFormatClassNames, boolean supportsStandardImageMetadataFormat, String nativeImageMetadataFormatName, String nativeImageMetadataFormatClassName, String[] extraImageMetadataFormatNames, String[] extraImageMetadataFormatClassNames) 指定された値セットを使用してImageWriterSpiを構築します。 -
メソッドのサマリー
修飾子と型メソッド説明booleanこのサービス・プロバイダに関連するImageWriter実装が、指定されたRenderedImageインスタンスをエンコードできる場合は、trueを返します。abstract booleanこのサービス・プロバイダに関連するImageWriter実装が、指定されたレイアウトでイメージをエンコードできる場合は、trueを返します。このサービス・プロバイダに関連するImageWriter実装のインスタンスを返します。abstract ImageWritercreateWriterInstance(Object extension) このサービス・プロバイダに関連するImageWriter実装のインスタンスを返します。String[]このサービス・プロバイダに関連するImageWriterが使用する内部メタデータ表現を認識可能なImageReaderSpiクラスのすべての完全修飾名を含むString配列を返します。この種のImageReadersが指定されていない場合はnullを返します。Class<?>[]ライターのsetOutputメソッドの引数に使用可能なオブジェクトの型を示すClassオブジェクトの配列を返します。booleanこのライターが出力する形式がピクセル・データをビット精度で保持する場合はtrueを返します。booleanisOwnWriter(ImageWriter writer) 渡されたImageWriterオブジェクトがこのサービス・プロバイダに関連するImageWriterのインスタンスの場合は、trueを返します。クラスで宣言されたメソッド ImageReaderWriterSpi
getExtraImageMetadataFormatNames, getExtraStreamMetadataFormatNames, getFileSuffixes, getFormatNames, getImageMetadataFormat, getMIMETypes, getNativeImageMetadataFormatName, getNativeStreamMetadataFormatName, getPluginClassName, getStreamMetadataFormat, isStandardImageMetadataFormatSupported, isStandardStreamMetadataFormatSupported修飾子と型メソッド説明String[]このプラグインが作成または使用するイメージ・メタデータ・オブジェクトで、getAsTreeおよびsetFromTreeメソッドが認識する、ネイティブおよび標準形式以外の追加ドキュメント形式の名前を含むString配列を返します。String[]このプラグインが作成または使用するストリーム・メタデータ・オブジェクトで、getAsTreeおよびsetFromTreeメソッドが認識する、ネイティブおよび標準形式以外の追加ドキュメント形式の名前を含むString配列を返します。String[]このサービス・プロバイダに関連するImageReaderまたはImageWriter実装で一般的に使用可能な形式に関連付けられたファイル接尾辞のリストを含むString配列を返します。String[]このサービス・プロバイダに関連するImageReaderまたはImageWriter実装で一般的に使用できる形式の判読可能な名前を含むString配列を返します。getImageMetadataFormat(String formatName) 指定されたイメージ・メタデータ形式を説明するIIOMetadataFormatオブジェクト、または説明がない場合はnullを返します。String[]このサービス・プロバイダに関連するImageReaderまたはImageWriter実装で一般的に使用可能な形式に関連付けられたMIMEタイプのリストを含むString配列を返します。このプラグインの「ネイティブ」イメージ・メタデータ形式の名前を返します。通常、この形式を使用すると、このプラグインが処理する形式で格納されているイメージ・メタデータを劣化せず、にエンコードおよび転送できます。このプラグインの「ネイティブ」ストリーム・メタデータ形式の名前を返します。通常、この形式を使用すると、このプラグインが処理する形式で格納されているストリーム・メタデータを劣化せずに、エンコードおよび転送できます。このサービス・プロバイダに関連するImageReaderまたはImageWriterプラグインの完全修飾クラス名を返します。getStreamMetadataFormat(String formatName) 指定されたストリーム・メタデータ形式を説明するIIOMetadataFormatオブジェクト、または説明がない場合はnullを返します。booleanこのプラグインが作成または使用するイメージ・メタデータ・オブジェクトで、getAsTreeおよびsetFromTreeメソッドが認識するドキュメント形式に標準のメタデータ形式が含まれる場合は、trueを返します。booleanこのプラグインが作成または使用するストリーム・メタデータ・オブジェクトでgetAsTreeおよびsetFromTreeメソッドが認識するドキュメント形式に標準のメタデータ形式が含まれる場合は、trueを返します。クラスで宣言されたメソッド IIOServiceProvider
getDescription, getVendorName, getVersion, onDeregistration, onRegistration修飾子と型メソッド説明abstract StringgetDescription(Locale locale) このサービス・プロバイダとそれに関連する実装の、簡潔で判読可能な説明を返します。このサービス・プロバイダおよび関連する実装の構築を担当するベンダーの名前を返します。このサービス・プロバイダとそれに関連する実装のバージョン番号を表す文字列を返します。voidonDeregistration(ServiceRegistry registry, Class<?> category) SpiクラスがServiceRegistryから登録解除されると常にコールバックが実行されます。voidonRegistration(ServiceRegistry registry, Class<?> category) Spiクラスがインスタンス化されてServiceRegistryに登録されたあとで1回だけ呼び出されるコールバックです。クラスオブジェクトで宣言されたメソッド
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait修飾子と型メソッド説明protected Objectclone()このオブジェクトのコピーを作成して、返します。booleanこのオブジェクトと他のオブジェクトが等しいかどうかを示します。protected voidfinalize()削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。最終決定は非推奨であり、将来のリリースで削除される可能性があります。final Class<?> getClass()このObjectの実行時クラスを返します。inthashCode()このオブジェクトに対するハッシュ・コード値を返します。final voidnotify()このオブジェクトのモニターで待機中のスレッドを1つ再開します。final voidこのオブジェクトのモニターで待機中のすべてのスレッドを再開します。toString()オブジェクトの文字列表現を返します。final voidwait()現在のスレッドが目覚めるまで待機します。通常、notifiedまたはinterruptedです。final voidwait(long timeoutMillis) 現在のスレッドは、通常、notifiedまたはinterruptedであるか、一定のリアルタイムが経過するまで、目覚めるまで待機します。final voidwait(long timeoutMillis, int nanos) 現在のスレッドは、通常、notifiedまたはinterruptedであるか、一定のリアルタイムが経過するまで、目覚めるまで待機します。
-
フィールド詳細
-
STANDARD_OUTPUT_TYPE
@Deprecated public static final Class<?>[] STANDARD_OUTPUT_TYPE非推奨。このフィールドを使用するかわりに、同等の配列{ ImageOutputStream.class }を直接作成します。getOutputTypesから返される単一要素の配列で、最初はImageOutputStream.classが格納されています。 -
outputTypes
protected Class<?>[] outputTypesgetOutputTypesから返されるClassオブジェクトの配列で、最初はnullです。 -
readerSpiNames
protected String[] readerSpiNamesgetImageReaderSpiNamesから返される文字列の配列で、最初はnullです。
-
-
コンストラクタの詳細
-
ImageWriterSpi
protected ImageWriterSpi()空白のImageWriterSpiを構築します。 すべてのメソッドの作業バージョンを提供するための、インスタンス変数の初期化やメソッド実装のオーバーライドは、サブクラスで行う必要があります。 -
ImageWriterSpi
public ImageWriterSpi(String vendorName, String version, String[] names, String[] suffixes, String[] MIMETypes, String writerClassName, Class<?>[] outputTypes, String[] readerSpiNames, boolean supportsStandardStreamMetadataFormat, String nativeStreamMetadataFormatName, String nativeStreamMetadataFormatClassName, String[] extraStreamMetadataFormatNames, String[] extraStreamMetadataFormatClassNames, boolean supportsStandardImageMetadataFormat, String nativeImageMetadataFormatName, String nativeImageMetadataFormatClassName, String[] extraImageMetadataFormatNames, String[] extraImageMetadataFormatClassNames) 指定された値セットを使用してImageWriterSpiを構築します。- パラメータ:
vendorName- ベンダー名(null以外のString)。version- バージョン識別子(null以外のString)。names- 形式名を示すnull以外のString配列。 1つ以上のエントリが存在する必要がある。suffixes- 共通のファイル接尾辞を示すString配列。 接尾辞が定義されていない場合は、nullを指定する。 長さ0の配列はnullに正規化される。MIMETypes- 形式のMIMEタイプを示すString配列。 接尾辞が定義されていない場合は、nullを指定する。 長さ0の配列はnullに正規化される。writerClassName-null String以外の、関連付けられたImageWriterSpiクラスの完全修飾名。outputTypes- 正当な出力タイプを示す、長さ1以上のClassオブジェクトの配列。readerSpiNames- 関連するすべてのImageReaderのクラスを命名する、長さ1以上のString配列、またはnull。 長さ0の配列はnullに正規化される。supportsStandardStreamMetadataFormat- ストリーム・メタデータ・オブジェクトが標準メタデータ形式で記述されたツリーを使用可能かどうかを示すboolean。nativeStreamMetadataFormatName-getNativeStreamMetadataFormatNameから返されるString、またはnull。nativeStreamMetadataFormatClassName-getNativeStreamMetadataFormatから返されるメタデータ形式オブジェクトのインスタンス化で使用するString、またはnull。extraStreamMetadataFormatNames-getExtraStreamMetadataFormatNamesから返されるStringの配列、またはnull。 長さ0の配列はnullに正規化される。extraStreamMetadataFormatClassNames-getStreamMetadataFormatから返されるメタデータ形式オブジェクトのインスタンス化で使用するStringの配列、またはnull。 長さ0の配列はnullに正規化される。supportsStandardImageMetadataFormat- イメージ・メタデータ・オブジェクトが、標準のメタデータ形式で記述されたツリーを使用できるかどうかを示すboolean。nativeImageMetadataFormatName-getNativeImageMetadataFormatNameから返されるString、またはnull。nativeImageMetadataFormatClassName-getNativeImageMetadataFormatから返されるメタデータ形式オブジェクトのインスタンス化で使用するString、またはnull。extraImageMetadataFormatNames-getExtraImageMetadataFormatNamesから返されるStringの配列。 長さ0の配列はnullに正規化される。extraImageMetadataFormatClassNames-getImageMetadataFormatから返されるメタデータ形式オブジェクトのインスタンス化で使用するStringの配列、またはnull。 長さ0の配列はnullに正規化される。- スロー:
IllegalArgumentException-vendorNameがnullの場合。IllegalArgumentException-versionがnullの場合。IllegalArgumentException-namesがnullまたは長さ0の場合。IllegalArgumentException-writerClassNameがnullの場合。IllegalArgumentException-outputTypesがnullまたは長さ0の場合。
-
-
メソッドの詳細
-
isFormatLossless
public boolean isFormatLossless()このライターが出力する形式がピクセル・データをビット精度で保持する場合はtrueを返します。 デフォルトの実装ではtrueを返します。- 戻り値:
- 形式が完全な精度でピクセルを保持する場合は
true。
-
getOutputTypes
public Class<?>[] getOutputTypes()ライターのsetOutputメソッドの引数に使用可能なオブジェクトの型を示すClassオブジェクトの配列を返します。ImageOutputStreamにのみ出力するほとんどのライターの場合、ImageOutputStream.classを含む単一要素の配列が返されます。- 戻り値:
- 長さ1以上の
Classオブジェクトの、null以外の配列。
-
canEncodeImage
public abstract boolean canEncodeImage(ImageTypeSpecifier type) このサービス・プロバイダに関連するImageWriter実装が、指定されたレイアウトでイメージをエンコードできる場合は、trueを返します。 レイアウト(つまりイメージのSampleModelとColorModel)はImageTypeSpecifierオブジェクトで記述されます。trueが返されても、エンコーディングが成功するとは限りません。エンコーディング処理で、入出力エラー、不整合または不正なデータ構造などによりエラーが発生する場合があります。この目的は、イメージがエンコーディング形式のスコープ内であるかどうかを判定するために、イメージの基本構造を適切に検証することです。 たとえば、グレー・スケールのみをエンコード可能な形式用のサービス・プロバイダは、RGBBufferedImageが渡されるとfalseを返します。 同様に、8ビットRGBイメージをエンコードできるサービス・プロバイダは、関連するアルファ・チャネルを持つイメージをエンコードしない場合があります。ImageWriter(サービス・プロバイダ)の中には、多少厳格なものがあります。 たとえば、格納するためにある程度精度を低下させて各ピクセルを除算する必要があっても、事前にアルファを乗算したイメージを受け取る場合があります。- パラメータ:
type- 書き込まれるイメージのレイアウトを指定するImageTypeSpecifier。- 戻り値:
- このライターが指定されたレイアウトでイメージをエンコードできる可能性が高い場合は
true。 - スロー:
IllegalArgumentException-typeがnullの場合。
-
canEncodeImage
public boolean canEncodeImage(RenderedImage im) このサービス・プロバイダに関連するImageWriter実装が、指定されたRenderedImageインスタンスをエンコードできる場合は、trueを返します。 これにはjava.awt.image.BufferedImageのインスタンスが含まれます。このメソッドのセマンティックスの詳細は、
canEncodeImage(ImageTypeSpecifier)の説明を参照してください。- パラメータ:
im- エンコードされるRenderedImageのインスタンス。- 戻り値:
- このライターがこのイメージをエンコードできる可能性が高い場合は
true。 - スロー:
IllegalArgumentException-imがnullの場合。
-
createWriterInstance
public ImageWriter createWriterInstance() throws IOExceptionこのサービス・プロバイダに関連するImageWriter実装のインスタンスを返します。 返されるオブジェクトの初期状態は、resetメソッドの呼出し後のような状態です。デフォルトの実装では、
createWriterInstance(null)を返すだけです。- 戻り値:
ImageWriterインスタンス。- スロー:
IOException- ライター・クラスのロードや初期化、またはライター・オブジェクトのインスタンス化や初期化でエラーが発生した場合。
-
createWriterInstance
public abstract ImageWriter createWriterInstance(Object extension) throws IOException このサービス・プロバイダに関連するImageWriter実装のインスタンスを返します。 返されるオブジェクトの初期状態は、resetメソッドの呼出し後のような状態です。構築時に
Objectをプラグインに提供できます。 オブジェクトの特性は、プラグインによって異なります。通常、プラグインは
return new MyImageWriter(this)などのコードを使用してこのメソッドを実装します。- パラメータ:
extension- プラグイン固有の拡張オブジェクト。nullも可。- 戻り値:
ImageWriterインスタンス。- スロー:
IOException- ライターのインスタンス化に失敗した場合。IllegalArgumentException- 拡張オブジェクトが適切でないことを示すためにImageWriterのコンストラクタがIllegalArgumentExceptionをスローする場合。
-
isOwnWriter
public boolean isOwnWriter(ImageWriter writer) 渡されたImageWriterオブジェクトがこのサービス・プロバイダに関連するImageWriterのインスタンスの場合は、trueを返します。- パラメータ:
writer-ImageWriterインスタンス。- 戻り値:
writerが認識される場合はtrue- スロー:
IllegalArgumentException-writerがnullの場合。
-
getImageReaderSpiNames
public String[] getImageReaderSpiNames()このサービス・プロバイダに関連するImageWriterが使用する内部メタデータ表現を認識可能なImageReaderSpiクラスのすべての完全修飾名を含むString配列を返します。この種のImageReadersが指定されていない場合はnullを返します。null以外の値が返される場合は、0以外の長さになります。配列の最初の項目は、
ImageIO.getImageReader(ImageWriter)から返されるImageReaderのインスタンス化で使用されるため、「優先される」リーダーのサービス・プロバイダ名である必要があります。このメカニズムは、
ImageWriterが認識する構造内でピクセル以外のメタデータ(IIOExtraDataInfoを参照)を生成するImageReadersの取得に使用できます。 イメージを読み込み、このメソッドで取得したいずれかのImageReadersからこのデータを取得し、それをImageWriterに渡すと、クライアント・プログラムですべてのメタデータを保持しつつ、イメージの読込みや変更、書戻しを行うことができ、メタデータの内部構造やイメージ形式でさえ何も意識する必要はありません。- 戻り値:
ImageReaderSpiの名前を含む長さ1以上のStringの配列、またはnull。- 関連項目:
-
{ ImageOutputStream.class }を直接作成します。