- すべての実装されたインタフェース:
RegisterableService
- 直系の既知のサブクラス:
ImageReaderSpi
,ImageWriterSpi
ImageReaderSpi
とImageWriterSpi
に共通のインスタンス変数およびメソッドを含むスーパー・クラスです。- 関連項目:
IIORegistry
,ImageReaderSpi
,ImageWriterSpi
-
フィールドのサマリー
フィールド修飾子と型フィールド説明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
です。クラス javax.imageio.spi.IIOServiceProviderで宣言されたフィールド
vendorName, version
-
コンストラクタのサマリー
コンストラクタコンストラクタ説明空白の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[]
このプラグインが作成または使用するイメージ・メタデータ・オブジェクトで、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
を返します。クラス javax.imageio.spi.IIOServiceProviderで宣言されたメソッド
getDescription, getVendorName, getVersion, onDeregistration, onRegistration
-
フィールド詳細
-
names
protected String[] namesgetFormatNames
から返される文字列の配列で、最初はnull
です。 コンストラクタでこれをnull
以外の値に設定する必要があります。 -
接尾辞
protected String[] suffixesgetFileSuffixes
から返される文字列の配列で、最初はnull
です。 -
MIMETypes
protected String[] MIMETypesgetMIMETypes
から返される文字列の配列で、最初は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
またはサポートされない名前の場合。
-