モジュール java.desktop
パッケージ javax.imageio.spi

クラスImageReaderWriterSpi

    • フィールドのサマリー

      フィールド 
      修飾子と型 フィールド 説明
      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です。

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

      コンストラクタ 
      コンストラクタ 説明
      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を返します。

    • フィールドの詳細

      • 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またはサポートされない名前の場合。