- すべての実装されたインタフェース:
ImageTranscoder
ImageWriterオブジェクトは通常、特定形式のためのサービス・プロバイダ・クラスによりインスタンス化されます。 サービス・プロバイダ・クラスはIIORegistryに登録され、形式を識別し、使用可能な形式の読取り側と書込み側を提示するために使用されます。
- 関連項目:
-
フィールドのサマリー
フィールド修飾子と型フィールド説明protected Locale[]警告メッセージと圧縮設定値をローカライズするために使用できるLocaleの配列、またはローカライズ版がサポートされていない場合はnullになります。protected Localeローカライズ版に使用する現在のLocale、または設定されていない場合はnullです。protected ImageWriterSpiこのオブジェクトをインスタンス化するImageWriterSpi、または識別情報が不明であるか存在しない場合はnullです。protected ObjectImageOutputStreamまたはsetOutputが設定して、getOutputが取り出したその他のObjectです。protected List<IIOWriteProgressListener> 現在登録されているIIOWriteProgressListenerのListで、デフォルトではnullに初期化され、空のListと同じ意味になります。protected List<IIOWriteWarningListener> 現在登録されている各IIOWriteWarningListenerのListです。デフォルトではnullに初期化され、空のListと同じ意味になります。warningListenersの各要素に対するLocaleのListで、デフォルトではnullに初期化され、空のListと同じ意味になります。 -
コンストラクタのサマリー
コンストラクタ修飾子コンストラクタ説明protectedImageWriter(ImageWriterSpi originatingProvider) ImageWriterを構築し、そのoriginatingProviderインスタンス変数を、提供された値に設定します。 -
メソッドのサマリー
修飾子と型メソッド説明voidabort()現在の書込みオペレーションの中断を要求します。protected boolean書込み側がインスタンス化された、またはclearAbortRequestが呼び出されたために、現在の書込み操作の中止リクエストが出された場合、trueを返します。void登録された進捗リスナーのリストにIIOWriteProgressListenerを追加します。void登録された警告リスナーのリストにIIOWriteWarningListenerを追加します。booleancanInsertEmpty(int imageIndex) 指定されたインデックスでの新規の空イメージの挿入を書込み側がサポートする場合、trueを返します。booleancanInsertImage(int imageIndex) 指定されたインデックスでの新規イメージの挿入を書込み側がサポートする場合、trueを返します。booleancanRemoveImage(int imageIndex) 書込み側が、指定されたインデックスでの既存イメージの削除をサポートする場合、trueを返します。booleancanReplaceImageMetadata(int imageIndex) 既存のイメージに関連付けられたイメージ・メタデータを、インデックスimageIndexに置き換えることができる場合、trueを返します。booleancanReplacePixels(int imageIndex) 書込み側で、replacePixelsメソッドを使用して、指定されたイメージのピクセルの置換えを許可する場合、trueを返します。booleanすでに出力に存在するストリーム・メタデータを置き換えられる場合、trueを返します。boolean未定義のピクセル値を持つ1つのイメージと、関連付けられたメタデータとサムネールから成る、完全なイメージ・ストリームの出力への書込みを書込み側がサポートする場合、trueを返します。booleanIIOImageパラメータを取るメソッドが、(RenderedImageに対して)Rasterソース・イメージを処理できる場合、trueを返します。booleanすでにヘッダー情報を含み、以前のイメージである可能性を持つイメージ・ストリームに、書込み側がイメージを追加できる場合、trueを返します。protected void以前の中断リクエストをクリアします。voiddispose()このオブジェクトが保持するすべてのリソースを解放できるようにします。void以前のprepareInsertEmptyの呼出しで始まった、新規イメージの挿入を完了します。voidreplacePixelsの呼出し処理を終了します。void以前のprepareWriteEmptyの呼出しで始まった、新規イメージの書込みを完了します。voidprepareWriteSequenceで始まる一連のイメージの書込みを完了します。Locale[]警告リスナーと圧縮設定のローカライズに使用するLocaleの配列を返します。abstract IIOMetadatagetDefaultImageMetadata(ImageTypeSpecifier imageType, ImageWriteParam param) 指定された型のイメージをエンコードするためのデフォルト値を含むIIOMetadataオブジェクトを返します。abstract IIOMetadataイメージのストリームをエンコードするためのデフォルト値を含むIIOMetadataオブジェクトを返します。デフォルト値、つまりImageWriteParamオブジェクトが指定されなかった場合に使用される値を含む、このファイル形式に適切な型の新規ImageWriteParamオブジェクトを返します。現在設定されているLocale、何も設定されていない場合はnullを返します。intgetNumThumbnailsSupported(ImageTypeSpecifier imageType, ImageWriteParam param, IIOMetadata streamMetadata, IIOMetadata imageMetadata) エンコード中に使用されるメタデータ・オブジェクトと任意の追加書込みパラメータ、およびイメージ型を考慮して、書き込まれている形式でサポートされるサムネール数を返します。このImageWriterを作成したImageWriterSpiオブジェクトを返します。このオブジェクトがIIORegistryで作成されなかった場合は、nullを返します。ImageOutputStreamまたはsetOutputメソッドの最近の呼出しで設定されたほかのObjectを返します。getPreferredThumbnailSizes(ImageTypeSpecifier imageType, ImageWriteParam param, IIOMetadata streamMetadata, IIOMetadata imageMetadata) サムネール・イメージが出力ファイルまたはストリーム中でエンコードされるとき、その正規サイズの範囲を示すDimensionの配列を返します。voidprepareInsertEmpty(int imageIndex, ImageTypeSpecifier imageType, int width, int height, IIOMetadata imageMetadata, List<? extends BufferedImage> thumbnails, ImageWriteParam param) 未定義のピクセル値を持つ新規イメージの、既存イメージ・ストリームへの挿入を開始します。voidprepareReplacePixels(int imageIndex, Rectangle region) replacePixelsメソッドの一連の呼出しを処理するために、書込み側を準備します。voidprepareWriteEmpty(IIOMetadata streamMetadata, ImageTypeSpecifier imageType, int width, int height, IIOMetadata imageMetadata, List<? extends BufferedImage> thumbnails, ImageWriteParam param) 未定義のピクセル値を持つ1つのイメージと、関連付けられたメタデータとサムネールから成る、完全なイメージ・ストリームの出力への書込みを開始します。voidprepareWriteSequence(IIOMetadata streamMetadata) 次に続く一連のwriteToSequence呼出しを受け付けるために、提供されるストリーム・メタデータ・オブジェクトを使用して、ストリームを準備します。protected void登録されたすべてのIIOWriteProgressListenerに対し、そのimageCompleteメソッドを呼び出すことで、イメージ書込みの完了を通知します。protected voidprocessImageProgress(float percentageDone) 登録されたすべてのIIOWriteProgressListenerに対し、そのimageProgressメソッドを呼び出すことで、イメージ完成の現在の割合を通知します。protected voidprocessImageStarted(int imageIndex) 登録されたすべてのIIOWriteProgressListenerに対し、そのimageStartedメソッドを呼び出すことで、イメージ書込みの開始を通知します。protected void登録されたすべてのIIOWriteProgressListenerに対し、そのthumbnailCompleteメソッドを呼び出すことで、サムネール書込みの完了を通知します。protected voidprocessThumbnailProgress(float percentageDone) 登録されたすべてのIIOWriteProgressListenerに対し、そのthumbnailProgressメソッドを呼び出すことで、サムネール完成の現在の割合を通知します。protected voidprocessThumbnailStarted(int imageIndex, int thumbnailIndex) 登録されたすべてのIIOWriteProgressListenerに対し、そのthumbnailStartedメソッドを呼び出すことで、サムネール書込みの開始を通知します。protected voidprocessWarningOccurred(int imageIndex, String warning) warningOccurredメソッドを呼び出すことで、警告メッセージを、登録されたすべてのIIOWriteWarningListenerに通知します。protected voidprocessWarningOccurred(int imageIndex, String baseName, String keyword) ResourceBundleから取得した文字列を持つwarningOccurredメソッドを呼び出すことで、ローカライズされた警告メッセージを、登録されたすべてのIIOWriteWarningListenerに通知します。protected void登録されたすべてのIIOWriteProgressListenerに対し、そのwriteAbortedメソッドを呼び出すことで、書込みが中止されたことを通知します。void現在登録されているすべてのIIOWriteProgressListenerオブジェクトを削除します。void現在登録されているすべてのIIOWriteWarningListenerオブジェクトを削除します。void登録された進捗リスナーのリストから、IIOWriteProgressListenerを削除します。void登録された警告リスナーのリストから、IIOWriteWarningListenerを削除します。voidremoveImage(int imageIndex) ストリームからイメージを削除します。voidreplaceImageMetadata(int imageIndex, IIOMetadata imageMetadata) 既存イメージに関連付けられたイメージ・メタデータを置き換えます。voidreplacePixels(Raster raster, ImageWriteParam param) すでに出力内にあるイメージの一部を、指定されたRasterの一部に置き換えます。voidreplacePixels(RenderedImage image, ImageWriteParam param) すでに出力内にあるイメージの一部を、指定されたイメージの一部に置き換えます。voidreplaceStreamMetadata(IIOMetadata streamMetadata) 出力内のストリーム・メタデータを新規情報に置き換えます。voidreset()ImageWriterを初期状態に復元します。voidこのImageWriterの現在のLocaleを、指定された値に設定します。void出力先を、指定されたImageOutputStreamまたはほかのObjectに設定します。voidwrite(RenderedImage image) デフォルト・メタデータとサムネールの付いた1つのイメージから成る、完全なイメージ・ストリームを出力に追加します。voidデフォルト・メタデータとサムネールの付いた1つのイメージを含む、完全なイメージ・ストリームを出力に追加します。abstract voidwrite(IIOMetadata streamMetadata, IIOImage image, ImageWriteParam param) 1つのイメージ、関連付けられたストリームとイメージ・メタデータ、およびサムネールを含む完全なイメージ・ストリームを出力に追加します。voidwriteInsert(int imageIndex, IIOImage image, ImageWriteParam param) 既存イメージ・ストリームに新規イメージを挿入します。voidwriteToSequence(IIOImage image, ImageWriteParam param) 1つのイメージと、関連付けられる可能性のあるメタデータとサムネールを、出力に追加します。クラスjava.lang.Objectで宣言されたメソッド
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, waitインタフェースjavax.imageio.ImageTranscoderで宣言されたメソッド
convertImageMetadata, convertStreamMetadata
-
フィールド詳細
-
originatingProvider
protected ImageWriterSpi originatingProviderこのオブジェクトをインスタンス化するImageWriterSpi、または識別情報が不明であるか存在しない場合はnullです。 デフォルトでは、nullに初期化されます。 -
output
protected Object outputImageOutputStreamまたはsetOutputが設定して、getOutputが取り出したその他のObjectです。 デフォルトでは、nullに初期化されます。 -
availableLocales
protected Locale[] availableLocales警告メッセージと圧縮設定値をローカライズするために使用できるLocaleの配列、またはローカライズ版がサポートされていない場合はnullになります。 デフォルトでは、nullに初期化されます。 -
locale
protected Locale localeローカライズ版に使用する現在のLocale、または設定されていない場合はnullです。 デフォルトでは、nullに初期化されます。 -
warningListeners
protected List<IIOWriteWarningListener> warningListeners現在登録されている各IIOWriteWarningListenerのListです。デフォルトではnullに初期化され、空のListと同じ意味になります。 -
warningLocales
-
progressListeners
protected List<IIOWriteProgressListener> progressListeners現在登録されているIIOWriteProgressListenerのListで、デフォルトではnullに初期化され、空のListと同じ意味になります。
-
-
コンストラクタの詳細
-
ImageWriter
protected ImageWriter(ImageWriterSpi originatingProvider) ImageWriterを構築し、そのoriginatingProviderインスタンス変数を、提供された値に設定します。拡張機能を使用するサブクラスは、拡張オブジェクトを取り出すために、シグネチャ(
(ImageWriterSpi, Object))を持つコンストラクタを提供する必要があります。 拡張オブジェクトが適切でない場合、IllegalArgumentExceptionがスローされます。- パラメータ:
originatingProvider- このオブジェクトを構築するImageWriterSpi、またはnull。
-
-
メソッドの詳細
-
getOriginatingProvider
public ImageWriterSpi getOriginatingProvider()このImageWriterを作成したImageWriterSpiオブジェクトを返します。このオブジェクトがIIORegistryで作成されなかった場合は、nullを返します。デフォルトの実装では、
originatingProviderインスタンス変数の値が返されます。- 戻り値:
ImageWriterSpi、またはnull。- 関連項目:
-
setOutput
public void setOutput(Object output) 出力先を、指定されたImageOutputStreamまたはほかのObjectに設定します。 出力先はデータを受け取る準備ができていると見なされ、各書込みの終了時にクローズされません。 これにより、分散イメージ・アプリケーションは、1つのネットワーク接続上に一連のイメージを送信できます。outputがnullの場合、現在設定されている出力はすべて削除されます。outputがImageOutputStreamの場合、write、writeToSequence、prepareWriteEmpty/endWriteEmptyメソッドの呼出しは、既存のストリーム内容を保持します。writeInsert、replaceStreamMetadata、replaceImageMetadata、replacePixels、prepareInsertEmpty/endInsertEmpty、endWriteSequenceのようなその他の書込みメソッドは、完全なストリーム内容の読み込み、書込みができることを要求し、ストリームの任意の部分を変更できます。ImageOutputStream以外の一般のObjectは、出力装置またはイメージング・プロトコルと直接対話する書込み側のために使用されます。 書込み側のサービス・プロバイダのgetOutputTypesメソッドにより、正規のクラスのセットが公示されます。ほとんどの書込み側が、ImageOutputStreamだけを受け入れることを示すために、ImageOutputStream.classだけを含む1つの要素の配列を返します。デフォルト実装では、発信プロバイダが公示したクラスの設定があれば、これに
outputを照らし合わせたあと、outputインスタンス変数をoutputの値に設定します。- パラメータ:
output-ImageOutputStreamまたは今後の書込みに使用するほかのObject。- 例外:
IllegalArgumentException-outputが、発生元サービス・プロバイダのgetOutputTypesメソッドによって返されたいずれかのクラスのインスタンスでない場合。- 関連項目:
-
getOutput
public Object getOutput()ImageOutputStreamまたはsetOutputメソッドの最近の呼出しで設定されたほかのObjectを返します。 出力先が設定されていない場合、nullが返されます。デフォルトの実装では、
outputインスタンス変数の値が返されます。- 戻り値:
setOutputを使用して指定されたObject、またはnull。- 関連項目:
-
getAvailableLocales
public Locale[] getAvailableLocales()警告リスナーと圧縮設定のローカライズに使用するLocaleの配列を返します。 戻り値nullは、ローカライズ版がサポートされていないことを示します。デフォルトの実装では、それが
null以外の場合はavailableLocalesインスタンス変数のクローンを返し、それ以外の場合はnullを返します。- 戻り値:
setLocaleの引数として使用するLocaleの配列、またはnull。
-
setLocale
public void setLocale(Locale locale) このImageWriterの現在のLocaleを、指定された値に設定します。 値nullは、以前の設定を削除して、書込み側が適切にローカライズする必要があることを示します。デフォルト実装では、
localeをgetAvailableLocalesが返した値と照らし合わせ、見つかればlocaleインスタンス変数を設定します。localeがnullの場合、何のチェックもなしに、インスタンス変数はnullに設定されます。- パラメータ:
locale- 目的のLocale、またはnull。- 例外:
IllegalArgumentException-localeがnullではないが、getAvailableLocalesによって返された値の1つではない場合。- 関連項目:
-
getLocale
public Locale getLocale()現在設定されているLocale、何も設定されていない場合はnullを返します。デフォルトの実装では、
localeインスタンス変数の値が返されます。- 戻り値:
- 現在の
Locale、またはnull。 - 関連項目:
-
getDefaultWriteParam
public ImageWriteParam getDefaultWriteParam()デフォルト値、つまりImageWriteParamオブジェクトが指定されなかった場合に使用される値を含む、このファイル形式に適切な型の新規ImageWriteParamオブジェクトを返します。 これは、2、3のパラメータだけを微調整するための起点として有効で、その他の場合はデフォルト設定のままにします。デフォルト実装では、タイリング、プログレッシブ・エンコーディング、または圧縮を許可しない新規
ImageWriteParamオブジェクトを構築し、返します。現在のLocale(つまり、new ImageWriteParam(getLocale())の呼出しで取得するもの)でローカライズされます。個々のプラグインは、追加のオプション機能を使用可能にして、
ImageWriteParamのインスタンスを返すことができます。あるいは、ImageWriteParamのプラグイン固有サブクラスのインスタンスを返すことができます。- 戻り値:
- デフォルト値を含む新規
ImageWriteParamオブジェクト。
-
getDefaultStreamMetadata
public abstract IIOMetadata getDefaultStreamMetadata(ImageWriteParam param) イメージのストリームをエンコードするためのデフォルト値を含むIIOMetadataオブジェクトを返します。 オブジェクトの内容は、IIOMetadata.getAsTreeメソッドが返したXMLツリー構造、IIOMetadataControllerオブジェクト、またはプラグイン固有のインタフェース経由のいずれかを使用して操作でき、その結果データは、ストリーム・メタデータ・パラメータをとるwriteメソッドの1つに提供できます。ストリーム・メタデータの構造に影響を与える場合のために、オプションの
ImageWriteParamを提供できます。指定された
ImageWriteParamに、この書込み側がサポートしないオプション設定値(たとえば、プログレッシブ・エンコーディングや形式固有の設定)が含まれる場合、それらは無視されます。ストリーム・メタデータを使用しない書込み側(たとえば、1つのイメージ形式のための書込み側)は、
nullを返す必要があります。- パラメータ:
param- イメージの符号化に使用されるImageWriteParam、またはnull。- 戻り値:
IIOMetadataオブジェクト。
-
getDefaultImageMetadata
public abstract IIOMetadata getDefaultImageMetadata(ImageTypeSpecifier imageType, ImageWriteParam param) 指定された型のイメージをエンコードするためのデフォルト値を含むIIOMetadataオブジェクトを返します。 オブジェクトの内容は、IIOMetadata.getAsTreeメソッドが返したXMLツリー構造、IIOMetadataControllerオブジェクト、またはプラグイン固有のインタフェース経由のいずれかを使用して操作でき、その結果データは、ストリーム・メタデータ・パラメータをとるwriteメソッドの1つに提供できます。イメージ・メタデータの構造に影響を与える場合のために、オプションの
ImageWriteParamを提供できます。指定された
ImageWriteParamに、この書込み側がサポートしないオプション設定値(たとえば、プログレッシブ・エンコーディングや形式固有の設定)が含まれる場合、それらは無視されます。- パラメータ:
imageType- あとで書き込まれるイメージの形式を示すImageTypeSpecifier。param- イメージの符号化に使用されるImageWriteParam、またはnull。- 戻り値:
IIOMetadataオブジェクト。
-
getNumThumbnailsSupported
public int getNumThumbnailsSupported(ImageTypeSpecifier imageType, ImageWriteParam param, IIOMetadata streamMetadata, IIOMetadata imageMetadata) エンコード中に使用されるメタデータ・オブジェクトと任意の追加書込みパラメータ、およびイメージ型を考慮して、書き込まれている形式でサポートされるサムネール数を返します。 戻り値-1は、十分な情報を使用できないことを示します。サムネール処理に影響を与える場合のために、オプションとして
ImageWriteParamを提供できます。指定された
ImageWriteParamに、この書込み側がサポートしないオプション設定値(たとえば、プログレッシブ・エンコーディングや形式固有の設定)が含まれる場合、それらは無視されます。デフォルトの実装は0を返します。
- パラメータ:
imageType- 書き込まれるイメージ型を示すImageTypeSpecifier、またはnull。param- 書込みに使用されるImageWriteParam、またはnull。streamMetadata- 書込みに使用されるIIOMetadataオブジェクト、またはnull。imageMetadata- 書込みに使用されるIIOMetadataオブジェクト、またはnull。- 戻り値:
- 提供されたパラメータを考慮した、書き込むことのできるサムネール数、または十分な情報を使用できない場合は
-1。
-
getPreferredThumbnailSizes
public Dimension[] getPreferredThumbnailSizes(ImageTypeSpecifier imageType, ImageWriteParam param, IIOMetadata streamMetadata, IIOMetadata imageMetadata) サムネール・イメージが出力ファイルまたはストリーム中でエンコードされるとき、その正規サイズの範囲を示すDimensionの配列を返します。 この情報は単なる助言であり、書込み側は、必要に応じて任意の提供されたサムネールのサイズを変更できます。情報はペアで返されます。ペアの最初の要素には、包括的な最小の幅と高さが、次の要素には包括的な最大の幅と高さが含まれます。 あわせて、各ペアはサイズの有効範囲を定義します。 固定サイズを指定するには、両方の要素に同じ幅と高さを使用します。 戻り値
nullは、サイズが任意または不明であることを示します。サムネール処理に影響を与える場合のために、オプションとして
ImageWriteParamを提供できます。指定された
ImageWriteParamに、この書込み側がサポートしないオプション設定値(たとえば、プログレッシブ・エンコーディングや形式固有の設定)が含まれる場合、それらは無視されます。デフォルトの実装では
nullを返します。- パラメータ:
imageType- 書き込まれるイメージ型を示すImageTypeSpecifier、またはnull。param- 書込みに使用されるImageWriteParam、またはnull。streamMetadata- 書込みに使用されるIIOMetadataオブジェクト、またはnull。imageMetadata- 書込みに使用されるIIOMetadataオブジェクト、またはnull。- 戻り値:
- 2以上の同じ長さを持つ
Dimensionの配列、またはnull。
-
canWriteRasters
public boolean canWriteRasters()IIOImageパラメータを取るメソッドが、(RenderedImageに対して)Rasterソース・イメージを処理できる場合、trueを返します。 このメソッドがfalseを返す場合、これらのメソッドは、Rasterを含むIIOImageが提供されるとき、UnsupportedOperationExceptionをスローします。デフォルトの実装では
falseを返します。- 戻り値:
Rasterソースがサポートされる場合はtrue。
-
write
public abstract void write(IIOMetadata streamMetadata, IIOImage image, ImageWriteParam param) throws IOException 1つのイメージ、関連付けられたストリームとイメージ・メタデータ、およびサムネールを含む完全なイメージ・ストリームを出力に追加します。 必要なヘッダー情報が含まれています。 出力がImageOutputStreamの場合、現在のシーク位置以前の既存の内容は影響を受けず、読込み可能または書込み可能である必要はありません。出力は、
setOutputメソッドを使用して前もって設定されている必要があります。ストリーム・メタデータがオプションで提供され、
nullの場合、デフォルトのストリーム・メタデータが使用されます。canWriteRastersがtrueを返す場合、IIOImageはRasterソースを含むことができます。 それ以外の場合は、RenderedImageソースを含む必要があります。提供されるサムネールは、必要であればサイズ変更され、サポートされる数を超過したサムネールは、すべて無視されます。 提供されない追加のサムネールがその形式で必要な場合、書込み側が内部で生成する必要があります。
書込み処理を制御するために、
ImageWriteParamをオプションで提供できます。paramがnullの場合、デフォルトの書き込みparamが使用されます。指定された
ImageWriteParamに、この書込み側がサポートしないオプション設定値(たとえば、プログレッシブ・エンコーディングや形式固有の設定)が含まれる場合、それらは無視されます。- パラメータ:
streamMetadata- ストリーム・メタデータを表すIIOMetadataオブジェクト、またはデフォルト値を使用するためのnull。image- 書き込まれるイメージ、サムネール、およびメタデータを含むIIOImageオブジェクト。param-ImageWriteParam、デフォルトのImageWriteParamを使用する場合はnull。- 例外:
IllegalStateException- 出力が設定されていない場合。UnsupportedOperationException-imageにRasterおよびcanWriteRastersが含まれる場合、falseを返す。IllegalArgumentException-imageがnullの場合。IOException- 書込み中にエラーが発生した場合。
-
write
public void write(IIOImage image) throws IOException デフォルト・メタデータとサムネールの付いた1つのイメージを含む、完全なイメージ・ストリームを出力に追加します。 このメソッドはwrite(null, image, null)の短縮形です。- パラメータ:
image- 書き込まれるイメージ、サムネール、およびメタデータを含むIIOImageオブジェクト。- 例外:
IllegalStateException- 出力が設定されていない場合。IllegalArgumentException-imageがnullの場合。UnsupportedOperationException-imageにRasterおよびcanWriteRastersが含まれる場合、falseを返す。IOException- 書込み中にエラーが発生した場合。
-
write
public void write(RenderedImage image) throws IOException デフォルト・メタデータとサムネールの付いた1つのイメージから成る、完全なイメージ・ストリームを出力に追加します。 このメソッドはwrite(null, new IIOImage(image, null, null), null)の短縮形です。- パラメータ:
image- 書き込まれるRenderedImage値。- 例外:
IllegalStateException- 出力が設定されていない場合。IllegalArgumentException-imageがnullの場合。IOException- 書込み中にエラーが発生した場合。
-
canWriteSequence
public boolean canWriteSequence()すでにヘッダー情報を含み、以前のイメージである可能性を持つイメージ・ストリームに、書込み側がイメージを追加できる場合、trueを返します。canWriteSequenceがfalseを返す場合、writeToSequenceとendWriteSequenceはUnsupportedOperationExceptionをスローします。デフォルトの実装では
falseを返します。- 戻り値:
- イメージを連続して追加できる場合
true。
-
prepareWriteSequence
public void prepareWriteSequence(IIOMetadata streamMetadata) throws IOException 次に続く一連のwriteToSequence呼出しを受け付けるために、提供されるストリーム・メタデータ・オブジェクトを使用して、ストリームを準備します。 メタデータがイメージ・データに先行する必要がある場合、このメタデータはストリームに書き込まれます。 引数がnullの場合、デフォルト・ストリーム・メタデータが使用されます。出力が
ImageOutputStreamの場合、現在のシーク位置以前の既存の出力内容はフラッシュされ、読込み可能または書込み可能である必要はありません。 その形式で、1つのTIFFファイル内の一連のイメージのように、ヘッダー情報を補修するためにendWriteSequenceが巻き戻しできることが必要な場合、このメソッドで書き込まれるメタデータは、ストリームの書込み可能部分に存在する必要があります。 ほかの形式は、このメソッドと各イメージのあとで、ストリームをフラッシュできます。canWriteSequenceがfalseを返す場合、このメソッドはUnsupportedOperationExceptionをスローします。出力は、
setOutputメソッドを使用して前もって設定されている必要があります。出力が
nullの場合、デフォルト実装ではIllegalStateExceptionをスローし、それ以外の場合は、UnsupportedOperationExceptionをスローします。- パラメータ:
streamMetadata- ストリーム・メタデータ・オブジェクト、またはnull。- 例外:
IllegalStateException- 出力が設定されていない場合。UnsupportedOperationException-canWriteSequenceがfalseを返す場合。IOException- ストリーム・メタデータの書込みでエラーが発生した場合。
-
writeToSequence
public void writeToSequence(IIOImage image, ImageWriteParam param) throws IOException 1つのイメージと、関連付けられる可能性のあるメタデータとサムネールを、出力に追加します。 出力がImageOutputStreamの場合、endWriteSequenceが呼び出されるときにプラグインがヘッダー情報を補修できる必要がある場合(たとえば、TIFF)を除き、現在のシーク位置以前の既存の出力内容はフラッシュでき、読込み可能または書込み可能である必要はありません。canWriteSequenceがfalseを返す場合、このメソッドはUnsupportedOperationExceptionをスローします。出力は、
setOutputメソッドを使用して前もって設定されている必要があります。前もって
prepareWriteSequenceが呼び出されている必要があり、そうでない場合IllegalStateExceptionがスローされます。canWriteRastersがtrueを返す場合、IIOImageはRasterソースを含むことができます。 それ以外の場合は、RenderedImageソースを含む必要があります。提供されるサムネールは、必要であればサイズ変更され、サポートされる数を超過したサムネールは、すべて無視されます。 提供されない追加のサムネールがその形式で必要な場合、書込み側が内部で生成します。
書込み処理を制御するために、
ImageWriteParamをオプションで提供できます。paramがnullの場合、デフォルトの書き込みparamが使用されます。指定された
ImageWriteParamに、この書込み側がサポートしないオプション設定値(たとえば、プログレッシブ・エンコーディングや形式固有の設定)が含まれる場合、それらは無視されます。出力が
nullの場合、デフォルト実装ではIllegalStateExceptionをスローし、それ以外の場合は、UnsupportedOperationExceptionをスローします。- パラメータ:
image- 書き込まれるイメージ、サムネール、およびメタデータを含むIIOImageオブジェクト。param-ImageWriteParam、デフォルトのImageWriteParamを使用する場合はnull。- 例外:
IllegalStateException- 出力が設定されていなかったか、prepareWriteSequenceが呼び出されていなかった場合。UnsupportedOperationException-canWriteSequenceがfalseを返す場合。IllegalArgumentException-imageがnullの場合。UnsupportedOperationException-imageにRasterおよびcanWriteRastersが含まれる場合、falseを返す。IOException- 書込み中にエラーが発生した場合。
-
endWriteSequence
public void endWriteSequence() throws IOExceptionprepareWriteSequenceで始まる一連のイメージの書込みを完了します。 イメージの処理の最後に来るストリーム・メタデータはすべて書き出され、処理の最初のヘッダー情報は、必要であればすべて補修されます。 出力がImageOutputStreamの場合、処理の最後でストリーム・メタデータを通過したデータはフラッシュされ、読込み可能または書込み可能である必要はありません。canWriteSequenceがfalseを返す場合、このメソッドはUnsupportedOperationExceptionをスローします。出力が
nullの場合、デフォルト実装ではIllegalStateExceptionをスローし、それ以外の場合は、UnsupportedOperationExceptionをスローします。- 例外:
IllegalStateException- 出力が設定されていなかったか、prepareWriteSequenceが呼び出されていなかった場合。UnsupportedOperationException-canWriteSequenceがfalseを返す場合。IOException- 書込み中にエラーが発生した場合。
-
canReplaceStreamMetadata
public boolean canReplaceStreamMetadata() throws IOExceptionすでに出力に存在するストリーム・メタデータを置き換えられる場合、trueを返します。出力が
nullの場合、デフォルト実装ではIllegalStateExceptionをスローし、それ以外の場合は、falseを返します。- 戻り値:
- ストリーム・メタデータの置換えが許可される場合
true。 - 例外:
IllegalStateException- 出力が設定されていない場合。IOException- 照会中に入出力エラーが発生した場合。
-
replaceStreamMetadata
public void replaceStreamMetadata(IIOMetadata streamMetadata) throws IOException 出力内のストリーム・メタデータを新規情報に置き換えます。 出力がImageOutputStreamの場合、以前のストリーム内容が調べられ、可能なかぎり編集されて、新規データのための場所を作ります。 以前の出力内容はすべて、読み込みと書込みのために使用できる必要があります。canReplaceStreamMetadataがfalseを返す場合、UnsupportedOperationExceptionがスローされます。出力が
nullの場合、デフォルト実装ではIllegalStateExceptionをスローし、それ以外の場合は、UnsupportedOperationExceptionをスローします。- パラメータ:
streamMetadata- ストリーム・メタデータを表すIIOMetadataオブジェクト、またはデフォルト値を使用するためのnull。- 例外:
IllegalStateException- 出力が設定されていない場合。UnsupportedOperationException-canReplaceStreamMetadataがfalseを返す場合。モードは含まないIOException- 書込み中にエラーが発生した場合。
-
canReplaceImageMetadata
public boolean canReplaceImageMetadata(int imageIndex) throws IOException 既存のイメージに関連付けられたイメージ・メタデータを、インデックスimageIndexに置き換えることができる場合、trueを返します。 このメソッドがfalseを返す場合、replaceImageMetadata(imageIndex)の呼出しはUnsupportedOperationExceptionをスローします。イメージ・メタデータの置換えをサポートしない書込み側は、インデックス上での範囲のチェックを実行せずに
falseを返すことができます。出力が
nullの場合、デフォルト実装ではIllegalStateExceptionをスローし、それ以外の場合は、imageIndexの値をチェックせずにfalseを返します。- パラメータ:
imageIndex- メタデータが置き換えられるイメージのインデックス。- 戻り値:
- 指定されたイメージのイメージ・メタデータが置換えできる場合
true。 - 例外:
IllegalStateException- 出力が設定されていない場合。IndexOutOfBoundsException- 一般に、書込み側がイメージ・メタデータの置換えをサポートし、imageIndexが0未満、または使用可能な最大のインデックスより大きい場合。IOException- 照会中に入出力エラーが発生した場合。
-
replaceImageMetadata
public void replaceImageMetadata(int imageIndex, IIOMetadata imageMetadata) throws IOException 既存イメージに関連付けられたイメージ・メタデータを置き換えます。canReplaceImageMetadata(imageIndex)がfalseを返す場合、UnsupportedOperationExceptionがスローされます。出力が
nullの場合、デフォルト実装ではIllegalStateExceptionをスローし、それ以外の場合は、UnsupportedOperationExceptionをスローします。- パラメータ:
imageIndex- メタデータが置き換えられるイメージのインデックス。imageMetadata- イメージ・メタデータを表すIIOMetadataオブジェクト、またはnull。- 例外:
IllegalStateException- 出力が設定されていない場合。UnsupportedOperationException-canReplaceImageMetadataがfalseを返す場合。IndexOutOfBoundsException-imageIndexが0未満、または使用可能な最大インデックスより大きい場合。IOException- 書込み中にエラーが発生した場合。
-
canInsertImage
public boolean canInsertImage(int imageIndex) throws IOException 指定されたインデックスでの新規イメージの挿入を書込み側がサポートする場合、trueを返します。 挿入インデックス以上のインデックスを持つ既存イメージは、自らのインデックスに1を加えます。imageIndexの値-1は、現在の最大インデックスより1大きいインデックスを表すために使用できます。イメージ挿入をサポートしない書込み側は、インデックス上での範囲チェックを実行せずに
falseを返すことができます。出力が
nullの場合、デフォルト実装ではIllegalStateExceptionをスローし、それ以外の場合は、imageIndexの値をチェックせずにfalseを返します。- パラメータ:
imageIndex- イメージが挿入されるインデックス。- 戻り値:
- 指定されたインデックスでイメージを挿入できる場合
true。 - 例外:
IllegalStateException- 出力が設定されていない場合。IndexOutOfBoundsException- 一般に、書込み側がイメージ挿入をサポートし、imageIndexが -1未満、または使用可能な最大インデックスより大きい場合。IOException- 照会中に入出力エラーが発生した場合。
-
writeInsert
public void writeInsert(int imageIndex, IIOImage image, ImageWriteParam param) throws IOException 既存イメージ・ストリームに新規イメージを挿入します。imageIndexより大きいインデックスを持つ既存イメージが保持され、そのインデックスには、それぞれ1が加えられます。imageIndexの値-1は、以前の最大インデックスより1大きいインデックスを表すために使用できます。つまり、これにより、イメージが論理的にシーケンスの最後に追加されます。 出力がImageOutputStreamの場合、ストリーム全体は、読込み可能と書込み可能の両方である必要があります。canInsertImage(imageIndex)がfalseを返す場合、UnsupportedOperationExceptionがスローされます。書込み処理を制御するために、
ImageWriteParamをオプションで提供できます。paramがnullの場合、デフォルトの書き込みparamが使用されます。指定された
ImageWriteParamに、この書込み側がサポートしないオプション設定値(たとえば、プログレッシブ・エンコーディングや形式固有の設定)が含まれる場合、それらは無視されます。出力が
nullの場合、デフォルト実装ではIllegalStateExceptionをスローし、それ以外の場合は、UnsupportedOperationExceptionをスローします。- パラメータ:
imageIndex- イメージが書き込まれるインデックス。image- 書き込まれるイメージ、サムネール、およびメタデータを含むIIOImageオブジェクト。param-ImageWriteParam、デフォルトのImageWriteParamを使用する場合はnull。- 例外:
IllegalStateException- 出力が設定されていない場合。UnsupportedOperationException-canInsertImage(imageIndex)がfalseを返す場合。IllegalArgumentException-imageがnullの場合。IndexOutOfBoundsException-imageIndexが -1未満、または使用可能な最大インデックスより大きい場合。UnsupportedOperationException-imageにRasterおよびcanWriteRastersが含まれる場合、falseを返す。IOException- 書込み中にエラーが発生した場合。
-
canRemoveImage
public boolean canRemoveImage(int imageIndex) throws IOException 書込み側が、指定されたインデックスでの既存イメージの削除をサポートする場合、trueを返します。 挿入インデックスより大きいインデックスを持つ既存イメージは、自らのインデックスから1を引きます。イメージ削除をサポートしない書込み側は、インデックス上での範囲チェックを実行せずに
falseを返すことができます。出力が
nullの場合、デフォルト実装ではIllegalStateExceptionをスローし、それ以外の場合は、imageIndexの値をチェックせずにfalseを返します。- パラメータ:
imageIndex- 削除されるイメージのインデックス。- 戻り値:
- 指定されたイメージを削除できる場合は
true。 - 例外:
IllegalStateException- 出力が設定されていない場合。IndexOutOfBoundsException- 一般に、書込み側がイメージ削除をサポートし、imageIndexが0未満、または使用可能な最大インデックスより大きい場合。IOException- 照会中に入出力エラーが発生した場合。
-
removeImage
public void removeImage(int imageIndex) throws IOException ストリームからイメージを削除します。canRemoveImage(imageIndex)がfalseを返す場合、UnsupportedOperationExceptionがスローされます。削除により、実際のファイル・サイズが縮小される場合とされない場合があります。
出力が
nullの場合、デフォルト実装ではIllegalStateExceptionをスローし、それ以外の場合は、UnsupportedOperationExceptionをスローします。- パラメータ:
imageIndex- 削除されるイメージのインデックス。- 例外:
IllegalStateException- 出力が設定されていない場合。UnsupportedOperationException-canRemoveImage(imageIndex)がfalseを返す場合。IndexOutOfBoundsException-imageIndexが0未満、または使用可能な最大インデックスより大きい場合。IOException- 削除中に入出力エラーが発生した場合。
-
canWriteEmpty
public boolean canWriteEmpty() throws IOException未定義のピクセル値を持つ1つのイメージと、関連付けられたメタデータとサムネールから成る、完全なイメージ・ストリームの出力への書込みを書込み側がサポートする場合、trueを返します。 ピクセル値は、replacePixelsメソッドの今後の呼出しで定義できます。 出力がImageOutputStreamの場合、現在のシーク位置以前の既存の内容は影響を受けず、読込み可能または書込み可能である必要はありません。出力が
nullの場合、デフォルト実装ではIllegalStateExceptionをスローし、それ以外の場合は、falseを返します。- 戻り値:
- あとで定義される内容を持つ完全なイメージ・ストリームの書込みがサポートされる場合は
true。 - 例外:
IllegalStateException- 出力が設定されていない場合。IOException- 照会中に入出力エラーが発生した場合。
-
prepareWriteEmpty
public void prepareWriteEmpty(IIOMetadata streamMetadata, ImageTypeSpecifier imageType, int width, int height, IIOMetadata imageMetadata, List<? extends BufferedImage> thumbnails, ImageWriteParam param) throws IOException 未定義のピクセル値を持つ1つのイメージと、関連付けられたメタデータとサムネールから成る、完全なイメージ・ストリームの出力への書込みを開始します。 ピクセル値は、replacePixelsメソッドの今後の呼出しで定義されます。 出力がImageOutputStreamの場合、現在のシーク位置以前の既存の内容は影響を受けず、読込み可能または書込み可能である必要はありません。endWriteEmptyの呼出しが発生するまで、書込みは完全ではありません。prepareWriteEmptyとendWriteEmptyの呼出しの間に、prepareReplacePixels、replacePixels、およびendReplacePixelsの呼出しが発生することがあります。 ただし、prepareWriteEmptyの呼出しは入れ子にできず、prepareWriteEmptyとprepareInsertEmptyの呼出しは挿入できません。canWriteEmptyがfalseを返す場合、UnsupportedOperationExceptionがスローされます。書込み処理を制御するために、
ImageWriteParamをオプションで提供できます。paramがnullの場合、デフォルトの書き込みparamが使用されます。指定された
ImageWriteParamに、この書込み側がサポートしないオプション設定値(たとえば、プログレッシブ・エンコーディングや形式固有の設定)が含まれる場合、それらは無視されます。出力が
nullの場合、デフォルト実装ではIllegalStateExceptionをスローし、それ以外の場合は、UnsupportedOperationExceptionをスローします。- パラメータ:
streamMetadata- ストリーム・メタデータを表すIIOMetadataオブジェクト、またはデフォルト値を使用するためのnull。imageType- イメージの配置を記述するImageTypeSpecifier。width- イメージの幅。height- イメージの高さ。imageMetadata- イメージ・メタデータを表すIIOMetadataオブジェクト、またはnull。thumbnails- このイメージのためのBufferedImageサムネールのList、またはnullparam-ImageWriteParam、デフォルトのImageWriteParamを使用する場合はnull。- 例外:
IllegalStateException- 出力が設定されていない場合。UnsupportedOperationException-canWriteEmptyがfalseを返す場合。IllegalStateException- 対応するendWriteEmptyの呼び出しなしで、先行するprepareWriteEmptyの呼出しが生成された場合。IllegalStateException- 対応するendInsertEmptyの呼び出しなしで、先行するprepareInsertEmptyの呼出しが生成された場合。IllegalArgumentException-imageTypeがnullの場合、またはthumbnailsにnull参照またはBufferedImage以外のオブジェクトが含まれる場合。IllegalArgumentException- 幅または高さが1より小さい場合。IOException- 書込み中に入出力エラーが発生した場合。
-
endWriteEmpty
public void endWriteEmpty() throws IOException以前のprepareWriteEmptyの呼出しで始まった、新規イメージの書込みを完了します。canWriteEmpty()がfalseを返す場合、UnsupportedOperationExceptionがスローされます。出力が
nullの場合、デフォルト実装ではIllegalStateExceptionをスローし、それ以外の場合は、UnsupportedOperationExceptionをスローします。- 例外:
IllegalStateException- 出力が設定されていない場合。UnsupportedOperationException-canWriteEmpty(imageIndex)がfalseを返す場合。IllegalStateException- 対応するendWriteEmptyの呼び出しなしで、先行するprepareWriteEmptyの呼出しが生成されなかった場合。IllegalStateException- 対応するendInsertEmptyの呼び出しなしで、先行するprepareInsertEmptyの呼出しが生成された場合。IllegalStateException- 一致するendReplacePixelsの呼び出しなしで、prepareReiplacePixelsの呼出しが生成された場合。IOException- 書込み中に入出力エラーが発生した場合。
-
canInsertEmpty
public boolean canInsertEmpty(int imageIndex) throws IOException 指定されたインデックスでの新規の空イメージの挿入を書込み側がサポートする場合、trueを返します。 イメージのピクセル値は未定義で、replacePixelsメソッドを使用して細かく指定できます。 挿入インデックス以上のインデックスを持つ既存イメージは、自らのインデックスに1を加えます。imageIndexの値-1は、現在の最大インデックスより1大きいインデックスを表すために使用できます。空イメージの挿入をサポートしない書込み側は、インデックス上での範囲チェックを実行せずに
falseを返すことができます。出力が
nullの場合、デフォルト実装ではIllegalStateExceptionをスローし、それ以外の場合は、imageIndexの値をチェックせずにfalseを返します。- パラメータ:
imageIndex- イメージが挿入されるインデックス。- 戻り値:
- 指定されたインデックスで空イメージを挿入できる場合は
true。 - 例外:
IllegalStateException- 出力が設定されていない場合。IndexOutOfBoundsException- 一般に、書込み側が空イメージの挿入をサポートし、imageIndexが -1未満、または使用可能な最大インデックスより大きい場合。IOException- 照会中に入出力エラーが発生した場合。
-
prepareInsertEmpty
public void prepareInsertEmpty(int imageIndex, ImageTypeSpecifier imageType, int width, int height, IIOMetadata imageMetadata, List<? extends BufferedImage> thumbnails, ImageWriteParam param) throws IOException 未定義のピクセル値を持つ新規イメージの、既存イメージ・ストリームへの挿入を開始します。imageIndexより大きいインデックスを持つ既存イメージが保持され、そのインデックスには、それぞれ1が加えられます。imageIndexの値-1は、以前の最大インデックスより1大きいインデックスを表すために使用できます。つまり、これにより、イメージが論理的にシーケンスの最後に追加されます。 出力がImageOutputStreamの場合、ストリーム全体は、読込み可能と書込み可能の両方である必要があります。イメージの内容は、
replacePixelsメソッドを使用してあとで提供できます。endInsertEmptyの呼出しが発生するまで、挿入は完全ではありません。prepareInsertEmptyとendInsertEmptyの呼出しの間に、prepareReplacePixels、replacePixels、およびendReplacePixelsの呼出しが発生することがあります。 ただし、prepareInsertEmptyの呼出しは入れ子にできず、prepareWriteEmptyとprepareInsertEmptyの呼出しは挿入できません。canInsertEmpty(imageIndex)がfalseを返す場合、UnsupportedOperationExceptionがスローされます。書込み処理を制御するために、
ImageWriteParamをオプションで提供できます。paramがnullの場合、デフォルトの書き込みparamが使用されます。指定された
ImageWriteParamに、この書込み側がサポートしないオプション設定値(たとえば、プログレッシブ・エンコーディングや形式固有の設定)が含まれる場合、それらは無視されます。出力が
nullの場合、デフォルト実装ではIllegalStateExceptionをスローし、それ以外の場合は、UnsupportedOperationExceptionをスローします。- パラメータ:
imageIndex- イメージが書き込まれるインデックス。imageType- イメージの配置を記述するImageTypeSpecifier。width- イメージの幅。height- イメージの高さ。imageMetadata- イメージ・メタデータを表すIIOMetadataオブジェクト、またはnull。thumbnails- このイメージのためのBufferedImageサムネールのList、またはnullparam-ImageWriteParam、デフォルトのImageWriteParamを使用する場合はnull。- 例外:
IllegalStateException- 出力が設定されていない場合。UnsupportedOperationException-canInsertEmpty(imageIndex)がfalseを返す場合。IndexOutOfBoundsException-imageIndexが -1未満、または使用可能な最大インデックスより大きい場合。IllegalStateException- 対応するendInsertEmptyの呼び出しなしで、先行するprepareInsertEmptyの呼出しが生成された場合。IllegalStateException- 対応するendWriteEmptyの呼び出しなしで、先行するprepareWriteEmptyの呼出しが生成された場合。IllegalArgumentException-imageTypeがnullの場合、またはthumbnailsにnull参照またはBufferedImage以外のオブジェクトが含まれる場合。IllegalArgumentException- 幅または高さが1より小さい場合。IOException- 書込み中に入出力エラーが発生した場合。
-
endInsertEmpty
public void endInsertEmpty() throws IOException以前のprepareInsertEmptyの呼出しで始まった、新規イメージの挿入を完了します。出力が
nullの場合、デフォルト実装ではIllegalStateExceptionをスローし、それ以外の場合は、UnsupportedOperationExceptionをスローします。- 例外:
IllegalStateException- 出力が設定されていない場合。UnsupportedOperationException-canInsertEmpty(imageIndex)がfalseを返す場合。IllegalStateException- 対応するendInsertEmptyの呼び出しなしで、先行するprepareInsertEmptyの呼出しが生成されなかった場合。IllegalStateException- 対応するendWriteEmptyの呼び出しなしで、先行するprepareWriteEmptyの呼出しが生成された場合。IllegalStateException- 一致するendReplacePixelsの呼び出しなしで、prepareReplacePixelsの呼出しが生成された場合。IOException- 書込み中に入出力エラーが発生した場合。
-
canReplacePixels
public boolean canReplacePixels(int imageIndex) throws IOException 書込み側で、replacePixelsメソッドを使用して、指定されたイメージのピクセルの置換えを許可する場合、trueを返します。ピクセルの置換えをサポートしない書込み側は、インデックス上での範囲チェックを実行せずに
falseを返すことができます。出力が
nullの場合、デフォルト実装ではIllegalStateExceptionをスローし、それ以外の場合は、imageIndexの値をチェックせずにfalseを返します。- パラメータ:
imageIndex- ピクセルが置き換えられるイメージのインデックス。- 戻り値:
- 指定されたイメージのピクセルを置き換えることができる場合は
true。 - 例外:
IllegalStateException- 出力が設定されていない場合。IndexOutOfBoundsException- 一般に、書込み側がピクセルの置換えをサポートし、imageIndexが0未満、または使用可能な最大インデックスより大きい場合。IOException- 照会中に入出力エラーが発生した場合。
-
prepareReplacePixels
public void prepareReplacePixels(int imageIndex, Rectangle region) throws IOException replacePixelsメソッドの一連の呼出しを処理するために、書込み側を準備します。 影響を受けるピクセル領域は、提供された領域に対してクリップされます。canReplacePixelsがfalseを返す場合、UnsupportedOperationExceptionがスローされます。出力が
nullの場合、デフォルト実装ではIllegalStateExceptionをスローし、それ以外の場合は、UnsupportedOperationExceptionをスローします。- パラメータ:
imageIndex- ピクセルが置き換えられるイメージのインデックス。region- あとのピクセル範囲のクリッピングに使用されるRectangle。- 例外:
IllegalStateException- 出力が設定されていない場合。UnsupportedOperationException-canReplacePixels(imageIndex)がfalseを返す場合。IndexOutOfBoundsException-imageIndexが0未満、または使用可能な最大インデックスより大きい場合。IllegalStateException- 対応するendReplacePixelsの呼び出しなしに、先行するprepareReplacePixelsの呼出しがある(つまり、入れ子が許可されない)場合。IllegalArgumentException-regionがnull、または1未満の幅または高さを持つ場合。IOException- 準備中に入出力エラーが発生した場合。
-
replacePixels
public void replacePixels(RenderedImage image, ImageWriteParam param) throws IOException すでに出力内にあるイメージの一部を、指定されたイメージの一部に置き換えます。 イメージ・データは、既存イメージのイメージ配置と一致するか、または置き換えられる必要があります。出力先範囲は
param引数で指定され、イメージ範囲にクリップされて、その範囲はprepareReplacePixelsに提供されます。 少なくともソースの1つのピクセルは、クリップしてはいけません。そうしないと、例外がスローされます。書込み処理を制御するために、
ImageWriteParamをオプションで提供できます。paramがnullの場合、デフォルトの書き込みparamが使用されます。指定された
ImageWriteParamに、この書込み側がサポートしないオプション設定値(たとえば、プログレッシブ・エンコーディングや形式固有の設定)が含まれる場合、それらは無視されます。メソッドは、
prepareReplacePixelsの呼出し後にのみ呼び出すことができ、それ以外の場合IllegalStateExceptionがスローされます。出力が
nullの場合、デフォルト実装ではIllegalStateExceptionをスローし、それ以外の場合は、UnsupportedOperationExceptionをスローします。- パラメータ:
image- ソース・ピクセルを含むRenderedImage。param-ImageWriteParam、デフォルトのImageWriteParamを使用する場合はnull。- 例外:
IllegalStateException- 出力が設定されていない場合。UnsupportedOperationException-canReplacePixels(imageIndex)がfalseを返す場合。IllegalStateException- 一致するendReplacePixelsの呼び出しなしで、先行するprepareReplacePixelsの呼出しがない場合。IllegalArgumentException- 次のいずれかに当てはまる場合:-
imageがnullです。 - 交差した範囲にピクセルが1つも含まれない。
-
imageの配置が既存のイメージ配置に一致しないか、この書込み側で配置を既存のイメージ配置に置き換えられない。
-
IOException- 書込み中に入出力エラーが発生した場合。
-
replacePixels
public void replacePixels(Raster raster, ImageWriteParam param) throws IOException すでに出力内にあるイメージの一部を、指定されたRasterの一部に置き換えます。 イメージ・データは、既存イメージのイメージ配置と一致するか、または置き換えられる必要があります。書込み処理を制御するために、
ImageWriteParamをオプションで提供できます。paramがnullの場合、デフォルトの書き込みparamが使用されます。出力先範囲は
param引数で指定され、イメージ範囲にクリップされて、その範囲はprepareReplacePixelsに提供されます。 少なくともソースの1つのピクセルは、クリップしてはいけません。そうしないと、例外がスローされます。指定された
ImageWriteParamに、この書込み側がサポートしないオプション設定値(たとえば、プログレッシブ・エンコーディングや形式固有の設定)が含まれる場合、それらは無視されます。メソッドは、
prepareReplacePixelsの呼出し後にのみ呼び出すことができ、それ以外の場合IllegalStateExceptionがスローされます。出力が
nullの場合、デフォルト実装ではIllegalStateExceptionをスローし、それ以外の場合は、UnsupportedOperationExceptionをスローします。- パラメータ:
raster- ソース・ピクセルを含むRaster。param-ImageWriteParam、デフォルトのImageWriteParamを使用する場合はnull。- 例外:
IllegalStateException- 出力が設定されていない場合。UnsupportedOperationException-canReplacePixels(imageIndex)がfalseを返す場合。IllegalStateException- 一致するendReplacePixelsの呼び出しなしで、先行するprepareReplacePixelsの呼出しがない場合。UnsupportedOperationException-canWriteRastersがfalseを返す場合。IllegalArgumentException- 次のいずれかに当てはまる場合:-
rasterがnullです。 - 交差した範囲にピクセルが1つも含まれない。
-
rasterの配置が既存のイメージ配置に一致しないか、この書込み側で配置を既存のイメージ配置に置き換えられない。
-
IOException- 書込み中に入出力エラーが発生した場合。
-
endReplacePixels
public void endReplacePixels() throws IOExceptionreplacePixelsの呼出し処理を終了します。canReplacePixelsがfalseを返す場合、UnsupportedOperationExceptionがスローされます。出力が
nullの場合、デフォルト実装ではIllegalStateExceptionをスローし、それ以外の場合は、UnsupportedOperationExceptionをスローします。- 例外:
IllegalStateException- 出力が設定されていない場合。UnsupportedOperationException-canReplacePixels(imageIndex)がfalseを返す場合。IllegalStateException- 一致するendReplacePixelsの呼び出しなしで、先行するprepareReplacePixelsの呼出しがない場合。IOException- 書込み中に入出力エラーが発生した場合。
-
abort
public void abort()現在の書込みオペレーションの中断を要求します。 中断後の出力内容は定義されません。書込み側は、各書込み操作の始めに
clearAbortRequestを呼び出し、書込み中に定期的にabortRequestedの値をポーリングする必要があります。 -
abortRequested
protected boolean abortRequested()書込み側がインスタンス化された、またはclearAbortRequestが呼び出されたために、現在の書込み操作の中止リクエストが出された場合、trueを返します。- 戻り値:
- 現在の書込みオペレーションを中断する必要がある場合は
true。 - 関連項目:
-
clearAbortRequest
protected void clearAbortRequest()以前の中断リクエストをクリアします。 このメソッドが呼び出されると、abortRequestedはfalseを返します。- 関連項目:
-
addIIOWriteWarningListener
public void addIIOWriteWarningListener(IIOWriteWarningListener listener) 登録された警告リスナーのリストにIIOWriteWarningListenerを追加します。listenerがnullの場合、例外はスローされず、何も処理は行われません。 指定されたリスナーに送られたメッセージは、可能であれば、現在のLocaleに合うようにローカライズされます。Localeが設定されていない場合は、書込み側に適合するよう警告メッセージをローカライズできます。- パラメータ:
listener- 登録されるIIOWriteWarningListener。- 関連項目:
-
removeIIOWriteWarningListener
public void removeIIOWriteWarningListener(IIOWriteWarningListener listener) 登録された警告リスナーのリストから、IIOWriteWarningListenerを削除します。 以前にリスナーが登録されていない場合、またはlistenerがnullの場合、例外はスローされず、何も処理は行われません。- パラメータ:
listener- 登録解除されるIIOWriteWarningListener。- 関連項目:
-
removeAllIIOWriteWarningListeners
public void removeAllIIOWriteWarningListeners()現在登録されているすべてのIIOWriteWarningListenerオブジェクトを削除します。デフォルト実装では
warningListenersとwarningLocalesインスタンスの変数をnullに設定します。 -
addIIOWriteProgressListener
public void addIIOWriteProgressListener(IIOWriteProgressListener listener) 登録された進捗リスナーのリストにIIOWriteProgressListenerを追加します。listenerがnullの場合、例外はスローされず、何も処理は行われません。- パラメータ:
listener- 登録されるIIOWriteProgressListener。- 関連項目:
-
removeIIOWriteProgressListener
public void removeIIOWriteProgressListener(IIOWriteProgressListener listener) 登録された進捗リスナーのリストから、IIOWriteProgressListenerを削除します。 以前にリスナーが登録されていない場合、またはlistenerがnullの場合、例外はスローされず、何も処理は行われません。- パラメータ:
listener- 登録解除されるIIOWriteProgressListener。- 関連項目:
-
removeAllIIOWriteProgressListeners
public void removeAllIIOWriteProgressListeners()現在登録されているすべてのIIOWriteProgressListenerオブジェクトを削除します。デフォルト実装では
progressListenersインスタンスの変数をnullに設定します。 -
processImageStarted
protected void processImageStarted(int imageIndex) 登録されたすべてのIIOWriteProgressListenerに対し、そのimageStartedメソッドを呼び出すことで、イメージ書込みの開始を通知します。 サブクラスは、必要に応じてこのメソッドを使用できます。- パラメータ:
imageIndex- 書き込まれようとしているイメージのインデックス。
-
processImageProgress
protected void processImageProgress(float percentageDone) 登録されたすべてのIIOWriteProgressListenerに対し、そのimageProgressメソッドを呼び出すことで、イメージ完成の現在の割合を通知します。 サブクラスは、必要に応じてこのメソッドを使用できます。- パラメータ:
percentageDone-floatとしての現在の完成した割合。
-
processImageComplete
protected void processImageComplete()登録されたすべてのIIOWriteProgressListenerに対し、そのimageCompleteメソッドを呼び出すことで、イメージ書込みの完了を通知します。 サブクラスは、必要に応じてこのメソッドを使用できます。 -
processThumbnailStarted
protected void processThumbnailStarted(int imageIndex, int thumbnailIndex) 登録されたすべてのIIOWriteProgressListenerに対し、そのthumbnailStartedメソッドを呼び出すことで、サムネール書込みの開始を通知します。 サブクラスは、必要に応じてこのメソッドを使用できます。- パラメータ:
imageIndex- サムネールに関連付けられたイメージのインデックス。thumbnailIndex- サムネールのインデックス。
-
processThumbnailProgress
protected void processThumbnailProgress(float percentageDone) 登録されたすべてのIIOWriteProgressListenerに対し、そのthumbnailProgressメソッドを呼び出すことで、サムネール完成の現在の割合を通知します。 サブクラスは、必要に応じてこのメソッドを使用できます。- パラメータ:
percentageDone-floatとしての現在の完成した割合。
-
processThumbnailComplete
protected void processThumbnailComplete()登録されたすべてのIIOWriteProgressListenerに対し、そのthumbnailCompleteメソッドを呼び出すことで、サムネール書込みの完了を通知します。 サブクラスは、必要に応じてこのメソッドを使用できます。 -
processWriteAborted
protected void processWriteAborted()登録されたすべてのIIOWriteProgressListenerに対し、そのwriteAbortedメソッドを呼び出すことで、書込みが中止されたことを通知します。 サブクラスは、必要に応じてこのメソッドを使用できます。 -
processWarningOccurred
protected void processWarningOccurred(int imageIndex, String warning) warningOccurredメソッドを呼び出すことで、警告メッセージを、登録されたすべてのIIOWriteWarningListenerに通知します。 サブクラスは、必要に応じてこのメソッドを使用できます。- パラメータ:
imageIndex- 警告が発生するイメージのインデックス。warning- 警告メッセージ。- 例外:
IllegalArgumentException-warningがnullの場合。
-
processWarningOccurred
ResourceBundleから取得した文字列を持つwarningOccurredメソッドを呼び出すことで、ローカライズされた警告メッセージを、登録されたすべてのIIOWriteWarningListenerに通知します。 サブクラスは、必要に応じてこのメソッドを使用できます。- パラメータ:
imageIndex- 警告が発生するイメージのインデックス。baseName- ローカライズされた警告メッセージを含むResourceBundleのセットのベース名。keyword-ResourceBundle内の警告メッセージにインデックスを付けるために使用されるキーワード。- 例外:
IllegalArgumentException-baseNameがnullの場合。IllegalArgumentException-keywordがnullの場合。IllegalArgumentException- 適切なResourceBundleが配置されない場合。IllegalArgumentException- 名前付きのリソースが配置されたResourceBundleで検出されない場合。IllegalArgumentException-ResourceBundleから取得したオブジェクトがStringではない場合。
-
reset
public void reset()ImageWriterを初期状態に復元します。デフォルト実装は
setOutput(null)、setLocale(null)、removeAllIIOWriteWarningListeners()、removeAllIIOWriteProgressListeners()、およびclearAbortRequestを呼び出します。 -
dispose
public void dispose()このオブジェクトが保持するすべてのリソースを解放できるようにします。 このメソッドの呼出しのあとに続くfinalize以外のほかのメソッドの呼出しの結果は未定義です。アプリケーションは、この
ImageWriterが不要になった時点でこのメソッドを呼び出すことが重要です。 そうしないと、書込み側はリソース上に無期限に存在し続ける可能性があります。このメソッドのデフォルト実装は、スーパー・クラスでは何も実行しません。 サブクラス実装で、すべてのリソース、特にネイティブ・リソースが解放されたことを確認してください。
-