モジュール java.desktop

パッケージ javax.imageio.spi

クラスImageReaderWriterSpi

java.lang.Object

javax.imageio.spi.IIOServiceProvider

javax.imageio.spi.ImageReaderWriterSpi

すべての実装されたインタフェース:

RegisterableService

直系の既知のサブクラス:

ImageReaderSpi, ImageWriterSpi

public abstract class ImageReaderWriterSpi
extends IIOServiceProvider

ImageReaderSpiとImageWriterSpiに共通のインスタンス変数およびメソッドを含むスーパー・クラスです。

関連項目:

IIORegistry, ImageReaderSpi, ImageWriterSpi

フィールドのサマリー

フィールド

修飾子と型	フィールド	説明
protected String[]	extraImageMetadataFormatClassNames	このプラグインがサポートするすべての追加イメージ・メタデータ形式のクラス名を含むString配列で、最初はnullです。
protected String[]	extraImageMetadataFormatNames	このプラグインがサポートするすべての追加イメージ・メタデータ形式の名前を含むString配列で、最初はnullです。
protected String[]	extraStreamMetadataFormatClassNames	このプラグインがサポートするすべての追加ストリーム・メタデータ形式のクラス名を含むString配列で、最初はnullです。
protected String[]	extraStreamMetadataFormatNames	このプラグインがサポートするすべての追加ストリーム・メタデータ形式の名前を含むString配列で、最初はnullです。
protected String[]	MIMETypes	getMIMETypesから返される文字列の配列で、最初はnullです。
protected String[]	names	getFormatNamesから返される文字列の配列で、最初はnullです。
protected String	nativeImageMetadataFormatClassName	このプラグインでサポートされるネイティブのストリーム・メタデータ形式のクラス名を含むStringで、最初はnullです。
protected String	nativeImageMetadataFormatName	このプラグインでサポートされるネイティブのストリーム・メタデータ形式の名前を含むStringで、最初はnullです。
protected String	nativeStreamMetadataFormatClassName	このプラグインでサポートされるネイティブのストリーム・メタデータ形式のクラス名を含むStringで、最初はnullです。
protected String	nativeStreamMetadataFormatName	このプラグインでサポートされるネイティブのストリーム・メタデータ形式の名前を含むStringで、最初はnullです。
protected String	pluginClassName	関連するプラグイン・クラスの名前を含むStringで、最初はnullです。
protected String[]	suffixes	getFileSuffixesから返される文字列の配列で、最初はnullです。
protected boolean	supportsStandardImageMetadataFormat	このプラグインがイメージ・メタデータに標準のメタデータ形式をサポートするかどうかを示すbooleanで、最初はfalseです。
protected boolean	supportsStandardStreamMetadataFormat	このプラグインがストリーム・メタデータに標準のメタデータ形式をサポートするかどうかを示すbooleanで、最初はfalseです。

クラス javax.imageio.spi.IIOServiceProviderで宣言されたフィールド

vendorName, version

コンストラクタのサマリー

コンストラクタ

コンストラクタ	説明
ImageReaderWriterSpi()	空白のImageReaderWriterSpiを構築します。
ImageReaderWriterSpi(String vendorName, String version, String[] names, String[] suffixes, String[] MIMETypes, String pluginClassName, boolean supportsStandardStreamMetadataFormat, String nativeStreamMetadataFormatName, String nativeStreamMetadataFormatClassName, String[] extraStreamMetadataFormatNames, String[] extraStreamMetadataFormatClassNames, boolean supportsStandardImageMetadataFormat, String nativeImageMetadataFormatName, String nativeImageMetadataFormatClassName, String[] extraImageMetadataFormatNames, String[] extraImageMetadataFormatClassNames)	指定された値セットを使用してImageReaderWriterSpiを構築します。

メソッドのサマリー

修飾子と型	メソッド	説明
String[]	getExtraImageMetadataFormatNames()	このプラグインが作成または使用するイメージ・メタデータ・オブジェクトで、getAsTreeおよびsetFromTreeメソッドが認識する、ネイティブおよび標準形式以外の追加ドキュメント形式の名前を含むString配列を返します。
String[]	getExtraStreamMetadataFormatNames()	このプラグインが作成または使用するストリーム・メタデータ・オブジェクトで、getAsTreeおよびsetFromTreeメソッドが認識する、ネイティブおよび標準形式以外の追加ドキュメント形式の名前を含むString配列を返します。
String[]	getFileSuffixes()	このサービス・プロバイダに関連するImageReaderまたはImageWriter実装で一般的に使用可能な形式に関連付けられたファイル接尾辞のリストを含むString配列を返します。
String[]	getFormatNames()	このサービス・プロバイダに関連するImageReaderまたはImageWriter実装で一般的に使用できる形式の判読可能な名前を含むString配列を返します。
IIOMetadataFormat	getImageMetadataFormat(String formatName)	指定されたイメージ・メタデータ形式を説明するIIOMetadataFormatオブジェクト、または説明がない場合はnullを返します。
String[]	getMIMETypes()	このサービス・プロバイダに関連するImageReaderまたはImageWriter実装で一般的に使用可能な形式に関連付けられたMIMEタイプのリストを含むString配列を返します。
String	getNativeImageMetadataFormatName()	このプラグインの「ネイティブ」イメージ・メタデータ形式の名前を返します。通常、この形式を使用すると、このプラグインが処理する形式で格納されているイメージ・メタデータを劣化せず、にエンコードおよび転送できます。
String	getNativeStreamMetadataFormatName()	このプラグインの「ネイティブ」ストリーム・メタデータ形式の名前を返します。通常、この形式を使用すると、このプラグインが処理する形式で格納されているストリーム・メタデータを劣化せずに、エンコードおよび転送できます。
String	getPluginClassName()	このサービス・プロバイダに関連するImageReaderまたはImageWriterプラグインの完全修飾クラス名を返します。
IIOMetadataFormat	getStreamMetadataFormat(String formatName)	指定されたストリーム・メタデータ形式を説明するIIOMetadataFormatオブジェクト、または説明がない場合はnullを返します。
boolean	isStandardImageMetadataFormatSupported()	このプラグインが作成または使用するイメージ・メタデータ・オブジェクトで、getAsTreeおよびsetFromTreeメソッドが認識するドキュメント形式に標準のメタデータ形式が含まれる場合は、trueを返します。
boolean	isStandardStreamMetadataFormatSupported()	このプラグインが作成または使用するストリーム・メタデータ・オブジェクトでgetAsTreeおよびsetFromTreeメソッドが認識するドキュメント形式に標準のメタデータ形式が含まれる場合は、trueを返します。

クラス javax.imageio.spi.IIOServiceProviderで宣言されたメソッド

getDescription, getVendorName, getVersion, onDeregistration, onRegistration

クラス java.lang.Objectで宣言されたメソッド

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

フィールドの詳細

names

protected String[] names

getFormatNamesから返される文字列の配列で、最初はnullです。 コンストラクタでこれをnull以外の値に設定する必要があります。

suffixes

protected String[] suffixes

getFileSuffixesから返される文字列の配列で、最初はnullです。

MIMETypes

protected String[] MIMETypes

getMIMETypesから返される文字列の配列で、最初はnullです。

pluginClassName

protected String pluginClassName

関連するプラグイン・クラスの名前を含むStringで、最初はnullです。

supportsStandardStreamMetadataFormat

protected boolean supportsStandardStreamMetadataFormat

このプラグインがストリーム・メタデータに標準のメタデータ形式をサポートするかどうかを示すbooleanで、最初はfalseです。

nativeStreamMetadataFormatName

protected String nativeStreamMetadataFormatName

このプラグインでサポートされるネイティブのストリーム・メタデータ形式の名前を含むStringで、最初はnullです。

nativeStreamMetadataFormatClassName

protected String nativeStreamMetadataFormatClassName

このプラグインでサポートされるネイティブのストリーム・メタデータ形式のクラス名を含むStringで、最初はnullです。

extraStreamMetadataFormatNames

protected String[] extraStreamMetadataFormatNames

このプラグインがサポートするすべての追加ストリーム・メタデータ形式の名前を含むString配列で、最初はnullです。

extraStreamMetadataFormatClassNames

protected String[] extraStreamMetadataFormatClassNames

このプラグインがサポートするすべての追加ストリーム・メタデータ形式のクラス名を含むString配列で、最初はnullです。

supportsStandardImageMetadataFormat

protected boolean supportsStandardImageMetadataFormat

このプラグインがイメージ・メタデータに標準のメタデータ形式をサポートするかどうかを示すbooleanで、最初はfalseです。

nativeImageMetadataFormatName

protected String nativeImageMetadataFormatName

このプラグインでサポートされるネイティブのストリーム・メタデータ形式の名前を含むStringで、最初はnullです。

nativeImageMetadataFormatClassName

protected String nativeImageMetadataFormatClassName

このプラグインでサポートされるネイティブのストリーム・メタデータ形式のクラス名を含むStringで、最初はnullです。

extraImageMetadataFormatNames

protected String[] extraImageMetadataFormatNames

このプラグインがサポートするすべての追加イメージ・メタデータ形式の名前を含むString配列で、最初はnullです。

extraImageMetadataFormatClassNames

protected String[] extraImageMetadataFormatClassNames

このプラグインがサポートするすべての追加イメージ・メタデータ形式のクラス名を含むString配列で、最初はnullです。

コンストラクタの詳細

ImageReaderWriterSpi

public ImageReaderWriterSpi(String vendorName,
                            String version,
                            String[] names,
                            String[] suffixes,
                            String[] MIMETypes,
                            String pluginClassName,
                            boolean supportsStandardStreamMetadataFormat,
                            String nativeStreamMetadataFormatName,
                            String nativeStreamMetadataFormatClassName,
                            String[] extraStreamMetadataFormatNames,
                            String[] extraStreamMetadataFormatClassNames,
                            boolean supportsStandardImageMetadataFormat,
                            String nativeImageMetadataFormatName,
                            String nativeImageMetadataFormatClassName,
                            String[] extraImageMetadataFormatNames,
                            String[] extraImageMetadataFormatClassNames)

指定された値セットを使用してImageReaderWriterSpiを構築します。

パラメータ:

vendorName - ベンダー名(null以外のString)。

version - バージョン識別子(null以外のString)。

names - 形式名を示すnull以外のString配列。 1つ以上のエントリが存在する必要がある。

suffixes - 共通のファイル接尾辞を示すString配列。 接尾辞が定義されていない場合は、nullを指定する。 長さ0の配列はnullに正規化される。

MIMETypes - 形式のMIMEタイプを示すString配列。 MIMEタイプが定義されていない場合は、nullを指定する。 長さ0の配列はnullに正規化される。

pluginClassName - 関連付けられたImageReaderまたはImageWriterクラスの完全修飾名(null以外のString)。

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 - pluginClassNameがnullの場合。

ImageReaderWriterSpi

public ImageReaderWriterSpi()

空白のImageReaderWriterSpiを構築します。 すべてのメソッドの作業バージョンを提供するための、インスタンス変数の初期化やメソッド実装のオーバーライドは、サブクラスで行う必要があります。

メソッドの詳細

getFormatNames

public String[] getFormatNames()

このサービス・プロバイダに関連するImageReaderまたはImageWriter実装で一般的に使用できる形式の判読可能な名前を含むString配列を返します。 たとえば、1つのImageReaderでPBMファイルとPNMファイルの両方を処理できる場合があります。

戻り値:

このリーダーまたはライターに関連する非公式の形式名を含む、長さ1以上のString配列(null以外)。

getFileSuffixes

public String[] getFileSuffixes()

このサービス・プロバイダに関連するImageReaderまたはImageWriter実装で一般的に使用可能な形式に関連付けられたファイル接尾辞のリストを含むString配列を返します。 たとえば、1つのImageReaderで.pbmや.pnm、または.jpgや.jpegの接尾辞を持つファイルを処理することができる場合があります。 既知のファイル接尾辞が存在しない場合は、nullを返します。

特定の接尾辞が返されても、その接尾辞を持つファイルの処理は保証されません。このサービス・プロバイダを使用して、この種のファイルのエンコードまたはデコードを試みる価値があることを示しているにすぎません。

戻り値:

このリーダーまたはライターに関連する共通のファイル接尾辞を含む、長さ1以上のString配列、またはnull。

getMIMETypes

public String[] getMIMETypes()

このサービス・プロバイダに関連するImageReaderまたはImageWriter実装で一般的に使用可能な形式に関連付けられたMIMEタイプのリストを含むString配列を返します。

特定の形式を記述するのに必要なMIMEタイプは1つだけであるのが理想的です。 しかし、いくつかの理由から、各サービス・プロバイダに複数のタイプを関連付ける必要があります。 第一に、多くの共通イメージ・ファイル形式には標準のMIMEタイプがないので、image/x-pbmやimage/x-portable-bitmapなどの共通に使用される非公式の名前リストが必要です。 一部のファイル形式には正式のMIMEタイプがありますが、正式のimage/pngではなく、image/x-pngのような以前の非公式な指定を利用して参照されるものがあります。 最後に、1つのサービス・プロバイダが、MIMEの観点から複数の別個の形式(image/x-xbitmapやimage/x-xpixmapなど)を解析できる場合があります。

特定のMIMEタイプが返されても、そのタイプのファイルの処理が保証されるわけではありません。このサービス・プロバイダを使用して、この種のファイルのエンコードまたはデコードを試みる価値があることを示しているにすぎません。

戻り値:

このリーダーまたはライターに関連するMIMEタイプを含む、長さ1以上のString配列、またはnull。

getPluginClassName

public String getPluginClassName()

このサービス・プロバイダに関連するImageReaderまたはImageWriterプラグインの完全修飾クラス名を返します。

戻り値:

クラス名(null以外のString)。

isStandardStreamMetadataFormatSupported

public boolean isStandardStreamMetadataFormatSupported()

このプラグインが作成または使用するストリーム・メタデータ・オブジェクトでgetAsTreeおよびsetFromTreeメソッドが認識するドキュメント形式に標準のメタデータ形式が含まれる場合は、trueを返します。

戻り値:

ストリーム・メタデータで標準の形式がサポートされる場合はtrue。

getNativeStreamMetadataFormatName

public String getNativeStreamMetadataFormatName()

このプラグインの「ネイティブ」ストリーム・メタデータ形式の名前を返します。通常、この形式を使用すると、このプラグインが処理する形式で格納されているストリーム・メタデータを劣化せずに、エンコードおよび転送できます。 そのような形式がサポートされていない場合は、null が返されます。

デフォルトの実装では、通常、コンストラクタで設定されるnativeStreamMetadataFormatNameインスタンス変数を返します。

戻り値:

ネイティブのストリーム・メタデータ形式の名前、またはnull。

getExtraStreamMetadataFormatNames

public String[] getExtraStreamMetadataFormatNames()

このプラグインが作成または使用するストリーム・メタデータ・オブジェクトで、getAsTreeおよびsetFromTreeメソッドが認識する、ネイティブおよび標準形式以外の追加ドキュメント形式の名前を含むString配列を返します。

プラグインがメタデータを処理しない場合は、nullを返します。

形式セットは、読み込みまたは書込みの行われるイメージにより異なる場合があります。このメソッドは、どの状況でも、プラグインがサポートする追加形式をすべて示す必要があります。

デフォルトの実装では、通常はコンストラクタで設定されるextraStreamMetadataFormatNamesインスタンス変数の複製を返します。

戻り値:

Stringの配列、またはnull。

関連項目:

IIOMetadata.getMetadataFormatNames(), getExtraImageMetadataFormatNames(), getNativeStreamMetadataFormatName()

isStandardImageMetadataFormatSupported

public boolean isStandardImageMetadataFormatSupported()

このプラグインが作成または使用するイメージ・メタデータ・オブジェクトで、getAsTreeおよびsetFromTreeメソッドが認識するドキュメント形式に標準のメタデータ形式が含まれる場合は、trueを返します。

戻り値:

イメージ・メタデータで標準の形式がサポートされる場合はtrue。

getNativeImageMetadataFormatName

public String getNativeImageMetadataFormatName()

このプラグインの「ネイティブ」イメージ・メタデータ形式の名前を返します。通常、この形式を使用すると、このプラグインが処理する形式で格納されているイメージ・メタデータを劣化せず、にエンコードおよび転送できます。 そのような形式がサポートされていない場合は、null が返されます。

デフォルトの実装では、通常、コンストラクタで設定されるnativeImageMetadataFormatNameインスタンス変数を返します。

戻り値:

ネイティブのイメージ・メタデータ形式の名前、またはnull。

関連項目:

getExtraImageMetadataFormatNames()

getExtraImageMetadataFormatNames

public String[] getExtraImageMetadataFormatNames()

このプラグインが作成または使用するイメージ・メタデータ・オブジェクトで、getAsTreeおよびsetFromTreeメソッドが認識する、ネイティブおよび標準形式以外の追加ドキュメント形式の名前を含むString配列を返します。

プラグインがイメージ・メタデータを処理しない場合は、nullを返します。

形式セットは、読み込みまたは書込みの行われるイメージにより異なる場合があります。このメソッドは、どの状況でも、プラグインがサポートする追加形式をすべて示す必要があります。

デフォルトの実装では、通常はコンストラクタで設定されるextraImageMetadataFormatNamesインスタンス変数の複製を返します。

戻り値:

Stringの配列、またはnull。

関連項目:

IIOMetadata.getMetadataFormatNames(), getExtraStreamMetadataFormatNames(), getNativeImageMetadataFormatName()

getStreamMetadataFormat

public IIOMetadataFormat getStreamMetadataFormat(String formatName)

指定されたストリーム・メタデータ形式を説明するIIOMetadataFormatオブジェクト、または説明がない場合はnullを返します。 指定する名前は、ネイティブのストリーム・メタデータ形式名、標準のメタデータ形式名、またはgetExtraStreamMetadataFormatNamesから返された名前のいずれかである必要があります。

パラメータ:

formatName - 目的のストリーム・メタデータ形式。

戻り値:

IIOMetadataFormatオブジェクト。

例外:

IllegalArgumentException - formatNameがnullまたはサポートされない名前の場合。

getImageMetadataFormat

public IIOMetadataFormat getImageMetadataFormat(String formatName)

指定されたイメージ・メタデータ形式を説明するIIOMetadataFormatオブジェクト、または説明がない場合はnullを返します。 指定する名前は、ネイティブのイメージ・メタデータ形式名、標準のメタデータ形式名、またはgetExtraImageMetadataFormatNamesから返された名前のいずれかである必要があります。

パラメータ:

formatName - 目的のイメージ・メタデータ形式。

戻り値:

IIOMetadataFormatオブジェクト。

例外:

IllegalArgumentException - formatNameがnullまたはサポートされない名前の場合。