ImageReader (Java Platform SE 7)

java.lang.Object
- javax.imageio.ImageReader

```
public abstract class ImageReader
extends Object
```
イメージを解析して復号化する抽象スーパークラスです。このクラスは、Java Image I/O フレームワークのコンテキストで、イメージを読み込むクラスによってサブクラス化されます。
ImageReader オブジェクトは、通常、特定の形式のサービスプロバイダインタフェース (SPI) によってインスタンス化されます。ImageReaderSpi インスタンスなどのサービスプロバイダクラスは、それらのクラスの形式の認識と、使用可能な形式の読み取り側と書き込み側の表示に使用する IIORegistry に登録されます。
入力ソースが setInput メソッドを使用して設定される場合、「順方向検索だけ」として指定されます。この設定は、以前に読み取られたイメージと関連付けられたデータを保持する入力部分のキャッシュを回避するために、入力ソースに保持されるイメージが順番に読み取られるだけであることを意味します。

関連項目:
ImageWriter, IIORegistry, ImageReaderSpi

フィールドのサマリー

フィールド
修飾子と型	フィールドと説明
`protected Locale[]`	`availableLocales` 警告メッセージのローカライズに使用する `Locale` の配列、またはローカライズ版がサポートされていない場合は `null` です。
`protected boolean`	`ignoreMetadata` 現在の入力ソースが、`setInput` によってメタデータが無視されるように指定されている場合は `true` です。
`protected Object`	`input` `ImageInputStream` または `setInput` が設定して、`getInput` が取り出したその他の `Object` です。
`protected Locale`	`locale` ローカライズ版に使用する現在の `Locale`、または設定されていない場合は `null` です。
`protected int`	`minIndex` 読み込み用の最小有効インデックスは、初期状態で 0 です。
`protected ImageReaderSpi`	`originatingProvider` このオブジェクトをインスタンス化する `ImageReaderSpi`、または識別情報が不明であるか存在しない場合は `null` です。
`protected List<IIOReadProgressListener>`	`progressListeners` 現在登録されている各 `IIOReadProgressListener` の `List` です。デフォルトでは `null` に初期化され、空の `List` と同じ意味になります。
`protected boolean`	`seekForwardOnly` 現在の入力ソースが、`setInput` による順方向検索だけが可能となるように指定されている場合は `true` です。
`protected List<IIOReadUpdateListener>`	`updateListeners` 現在登録されている各 `IIOReadUpdateListener` の `List` です。デフォルトでは `null` に初期化され、空の `List` と同じ意味になります。
`protected List<IIOReadWarningListener>`	`warningListeners` 現在登録されている各 `IIOReadWarningListener` の `List` です。デフォルトでは `null` に初期化され、空の `List` と同じ意味になります。
`protected List<Locale>`	`warningLocales` 現在登録されている各 `IIOReadWarningListener` に関連付けられた `Locale` の `List` です。デフォルトでは `null` に初期化され、空の `List` と同じ意味になります。

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

コンストラクタ
修飾子	コンストラクタと説明
`protected`	`ImageReader(ImageReaderSpi originatingProvider)` `ImageReader` を構築し、`originatingProvider` フィールドを、指定された値に設定します。

メソッドのサマリー

メソッド
修飾子と型	メソッドと説明
`void`	`abort()` 現在の読み込みオペレーションの中断を要求します。
`protected boolean`	`abortRequested()` 読み取り側がインスタンス化されたか、または `clearAbortRequest` が呼び出されたため、現在の読み込みオペレーションを中断するリクエストが行われた場合、`true` を返します。
`void`	`addIIOReadProgressListener(IIOReadProgressListener listener)` 登録された進捗リスナーのリストに `IIOReadProgressListener` を追加します。
`void`	`addIIOReadUpdateListener(IIOReadUpdateListener listener)` `IIOReadUpdateListener` を、登録された更新リスナーのリストに追加します。
`void`	`addIIOReadWarningListener(IIOReadWarningListener listener)` 登録された警告リスナーのリストに `IIOReadWarningListener` を追加します。
`boolean`	`canReadRaster()` このプラグインがピクセルデータの `Raster` だけの読み込みをサポートする場合、`true` を返します。
`protected static void`	`checkReadParamBandSettings(ImageReadParam param, int numSrcBands, int numDstBands)` `ImageReadParam` のソースおよびデスティネーションのバンド設定の有効性を判定するために、読み取り側が使用するユーティリティーメソッドです。
`protected void`	`clearAbortRequest()` 以前の中断リクエストをクリアします。
`protected static void`	`computeRegions(ImageReadParam param, int srcWidth, int srcHeight, BufferedImage image, Rectangle srcRegion, Rectangle destRegion)` ソースイメージの幅と高さ、オプションのデスティネーションイメージ、およびオプションの `ImageReadParam` を考慮して、対象のソース領域および対象のデスティネーション領域を計算します。
`void`	`dispose()` このオブジェクトが保持するすべてのリソースを解放できるようにします。
`float`	`getAspectRatio(int imageIndex)` 指定されたイメージの縦横比 (つまり、幅を高さで割った値) を `float` で返します。
`Locale[]`	`getAvailableLocales()` 警告リスナーと圧縮設定のローカライズに使用する `Locale` の配列を返します。
`ImageReadParam`	`getDefaultReadParam()` この形式に対して適切なデフォルトの `ImageReadParam` オブジェクトを返します。
`protected static BufferedImage`	`getDestination(ImageReadParam param, Iterator<ImageTypeSpecifier> imageTypes, int width, int height)` 復号化されたピクセルデータが書き込まれる `BufferedImage` を返します。
`String`	`getFormatName()` 入力ソースの形式を識別する `String` を返します。
`abstract int`	`getHeight(int imageIndex)` 入力ソースの指定されたイメージの高さをピクセル単位で返します。
`abstract IIOMetadata`	`getImageMetadata(int imageIndex)` 指定されたイメージに関連付けられたメタデータを保持する `IIOMetadata` オブジェクトを返します。または、読み取り側がメタデータを無視するよう設定され、メタデータの読み込みをサポートしていない場合、あるいはメタデータが使用できない場合は `null` を返します。
`IIOMetadata`	`getImageMetadata(int imageIndex, String formatName, Set<String> nodeNames)` 指定されたイメージに関連付けられたメタデータを表す `IIOMetadata` オブジェクトを返します。読み取り側がメタデータの読み込みをサポートしていない場合、あるいはメタデータを使用できない場合は `null` を返します。
`abstract Iterator<ImageTypeSpecifier>`	`getImageTypes(int imageIndex)` `ImageTypeSpecifiers` の形式で指定されたイメージが復号化されるイメージ型を含む `Iterator` を返します。
`Object`	`getInput()` `ImageInputStream` または以前に入力ソースとして設定されたほかの `Object` を返します。
`Locale`	`getLocale()` 現在設定されている `Locale`、何も設定されていない場合は `null` を返します。
`int`	`getMinIndex()` イメージ、サムネール、またはイメージメタデータの読み込みに対して有効な、最小のインデックスを返します。
`abstract int`	`getNumImages(boolean allowSearch)` 現在の入力ソースから、サムネールを除く使用可能なイメージの数を返します。
`int`	`getNumThumbnails(int imageIndex)` 指定されたイメージに関連付けられたサムネールプレビューイメージの数を返します。
`ImageReaderSpi`	`getOriginatingProvider()` このコンストラクタに渡された `ImageReaderSpi` を返します。
`ImageTypeSpecifier`	`getRawImageType(int imageIndex)` イメージの raw 内部形式にもっとも近い形式を表す `SampleModel` と `ColorModel` を示して、`ImageTypeSpecifier` を返します。
`protected static Rectangle`	`getSourceRegion(ImageReadParam param, int srcWidth, int srcHeight)` 指定された `ImageReadParam` のソース領域とサブサンプリングの座標の設定を考慮して、読み取り側が読み取るソースイメージの領域を計算するために使用するユーティリティーメソッドです。
`abstract IIOMetadata`	`getStreamMetadata()` 入力ソースに全体として関連付けられた、つまり特定のイメージに関連付けられていないメタデータを表す `IIOMetadata` オブジェクトを返します。または、読み取り側がメタデータを無視するよう設定され、メタデータの読み込みをサポートしていない場合、あるいはメタデータが使用できない場合は `null` を返します。
`IIOMetadata`	`getStreamMetadata(String formatName, Set<String> nodeNames)` 入力ソースに全体として関連付けられた、つまり特定のイメージに関連付けられていないメタデータを表す `IIOMetadata` オブジェクトを返します。
`int`	`getThumbnailHeight(int imageIndex, int thumbnailIndex)` `thumbnailIndex` によってインデックスを付けられたサムネールプレビューイメージの高さを返します。このイメージは `ImageIndex` によってインデックスを付けられたイメージに関連付けられています。
`int`	`getThumbnailWidth(int imageIndex, int thumbnailIndex)` `thumbnailIndex` によってインデックスを付けられたサムネールプレビューイメージの幅を返します。このイメージは `ImageIndex` によってインデックスを付けられたイメージに関連付けられています。
`int`	`getTileGridXOffset(int imageIndex)` 指定されたイメージのタイル (0, 0) の左上隅の X 座標を返します。
`int`	`getTileGridYOffset(int imageIndex)` 指定されたイメージのタイル (0, 0) の左上隅の Y 座標を返します。
`int`	`getTileHeight(int imageIndex)` 指定されたイメージのタイルの高さを返します。
`int`	`getTileWidth(int imageIndex)` 指定されたイメージのタイルの幅を返します。
`abstract int`	`getWidth(int imageIndex)` 入力ソースの指定されたイメージの幅をピクセル単位で返します。
`boolean`	`hasThumbnails(int imageIndex)` 指定されたイメージが、それに関連付けられたサムネールプレビューイメージを持つ場合、`true` を返します。
`boolean`	`isIgnoringMetadata()` 現在の入力ソースが、`setInput` メソッドの `ignoreMetadata` 引数として `true` を渡すことにより、メタデータを無視できるように指定されている場合は `true` を返します。
`boolean`	`isImageTiled(int imageIndex)` イメージがタイル、つまりオーバーラップしない等しいサイズの矩形に組み入れられる場合は `true` を返します。
`boolean`	`isRandomAccessEasy(int imageIndex)` ピクセルへのランダムアクセスに関して、指定されたイメージの格納形式に固有の障害が何もない場合は `true` を返します。
`boolean`	`isSeekForwardOnly()` 現在の入力ソースが、`setInput` メソッドの `seekForwardOnly` 引数として `true` を渡すことにより、順方向検索だけで実施と指定されている場合は `true` を返します。
`protected void`	`processImageComplete()` 登録されたすべての `IIOReadProgressListener` に対し、その `imageComplete` メソッドを呼び出すことで、イメージ読み込みの完了を通知します。
`protected void`	`processImageProgress(float percentageDone)` 登録されたすべての `IIOReadProgressListener` に対し、その `imageProgress` メソッドを呼び出すことで、イメージ完成の現在の割合を通知します。
`protected void`	`processImageStarted(int imageIndex)` 登録されたすべての `IIOReadProgressListener` に対し、その `imageStarted` メソッドを呼び出すことで、イメージ読み込みの開始を通知します。
`protected void`	`processImageUpdate(BufferedImage theImage, int minX, int minY, int width, int height, int periodX, int periodY, int[] bands)` 登録されたすべての `IIOReadUpdateListener` に対し、その `imageUpdate` メソッドを呼び出すことで、サンプルのセットの更新を通知します。
`protected void`	`processPassComplete(BufferedImage theImage)` 登録されたすべての `IIOReadUpdateListener` に対し、その `passComplete` メソッドを呼び出すことで、プログレッシブパスの終了を通知します。
`protected void`	`processPassStarted(BufferedImage theImage, int pass, int minPass, int maxPass, int minX, int minY, int periodX, int periodY, int[] bands)` 登録されたすべての `IIOReadUpdateListener` に対し、その `passStarted` メソッドを呼び出すことで、プログレッシブパスの開始を通知します。
`protected void`	`processReadAborted()` `readAborted` メソッドを呼び出すことで、読み込みが中断されたことを、登録されたすべての `IIOReadProgressListener` に通知します。
`protected void`	`processSequenceComplete()` 登録されたすべての `IIOReadProgressListener` に対し、その `sequenceComplete` メソッドを呼び出すことで、イメージ読み込みのシーケンスの完了を通知します。
`protected void`	`processSequenceStarted(int minIndex)` 登録されたすべての `IIOReadProgressListener` に対し、その `sequenceStarted` メソッドを呼び出すことで、イメージ読み込みのシーケンスの開始を通知します。
`protected void`	`processThumbnailComplete()` 登録されたすべての `IIOReadProgressListener` に対し、その `thumbnailComplete` メソッドを呼び出すことで、サムネール読み込みの完了を通知します。
`protected void`	`processThumbnailPassComplete(BufferedImage theThumbnail)` 登録されたすべての `IIOReadUpdateListener` に対し、`thumbnailPassComplete` メソッドを呼び出すことで、サムネールのプログレッシブパスの終了を通知します。
`protected void`	`processThumbnailPassStarted(BufferedImage theThumbnail, int pass, int minPass, int maxPass, int minX, int minY, int periodX, int periodY, int[] bands)` 登録されたすべての `IIOReadUpdateListener` に対し、その `thumbnailPassStarted` メソッドを呼び出すことで、サムネールのプログレッシブパスの開始を通知します。
`protected void`	`processThumbnailProgress(float percentageDone)` 登録されたすべての `IIOReadProgressListener` に対し、その `thumbnailProgress` メソッドを呼び出すことで、サムネール完成の現在の割合を通知します。
`protected void`	`processThumbnailStarted(int imageIndex, int thumbnailIndex)` 登録されたすべての `IIOReadProgressListener` に対し、その `thumbnailStarted` メソッドを呼び出すことで、サムネール読み込みの開始を通知します。
`protected void`	`processThumbnailUpdate(BufferedImage theThumbnail, int minX, int minY, int width, int height, int periodX, int periodY, int[] bands)` 登録されたすべての `IIOReadUpdateListener` に対し、その `thumbnailUpdate` メソッドを呼び出すことで、サムネールイメージのサンプルのセットの更新を通知します。
`protected void`	`processWarningOccurred(String warning)` `warningOccurred` メソッドを呼び出すことで、警告メッセージを、登録されたすべての `IIOReadWarningListener` に通知します。
`protected void`	`processWarningOccurred(String baseName, String keyword)` `ResourceBundle` から取得した文字列を持つ `warningOccurred` メソッドを呼び出すことで、ローカライズされた警告メッセージを、登録されたすべての `IIOReadWarningListener` に通知します。
`BufferedImage`	`read(int imageIndex)` `imageIndex` によってインデックスを付けられたイメージを読み込み、デフォルトの `ImageReadParam` を使用して、完全な `BufferedImage` として返します。
`abstract BufferedImage`	`read(int imageIndex, ImageReadParam param)` `imageIndex` によってインデックスを付けられたイメージを読み込み、指定された `ImageReadParam` を使用して、完全な `BufferedImage` として返します。
`IIOImage`	`readAll(int imageIndex, ImageReadParam param)` `imageIndex` によってインデックスを付けられたイメージを読み込み、指定された `ImageReadParam` を使用して、イメージ、サムネール、および関連するイメージのメタデータを保持する `IIOImage` を返します。
`Iterator<IIOImage>`	`readAll(Iterator<? extends ImageReadParam> params)` すべてのイメージ、サムネール、およびメタデータを保持し、`getMinIndex` によって指定されたインデックスで始まる `Iterator` を、`IIOImage` オブジェクトの形式で入力ソースから返します。
`RenderedImage`	`readAsRenderedImage(int imageIndex, ImageReadParam param)` `imageIndex` によってインデックスを付けられたイメージの内容を保持する `RenderedImage` オブジェクトを返します。
`boolean`	`readerSupportsThumbnails()` この読み取り側によって認識されるイメージ形式が、それに関連付けられたサムネールプレビューイメージをサポートする場合、`true` を返します。
`Raster`	`readRaster(int imageIndex, ImageReadParam param)` 色変換を適用せずに、イメージストリームからのピクセルデータを保持する新しい `Raster` オブジェクトを返します。
`BufferedImage`	`readThumbnail(int imageIndex, int thumbnailIndex)` `thumbnailIndex` によってインデックスを付けられたサムネールプレビューイメージを返します。このイメージは、`BufferedImage` として `ImageIndex` によってインデックスを付けられたイメージに関連付けられています。
`BufferedImage`	`readTile(int imageIndex, int tileX, int tileY)` `tileX` および `tileY` 引数によって指定され、`BufferedImage` として返されるタイルを読み込みます。
`Raster`	`readTileRaster(int imageIndex, int tileX, int tileY)` 色変換を適用せずに、タイルからの raw ピクセルデータを保持する新しい `Raster` オブジェクトを返します。
`void`	`removeAllIIOReadProgressListeners()` 現在登録されているすべての `IIOReadProgressListener` オブジェクトを削除します。
`void`	`removeAllIIOReadUpdateListeners()` 現在登録されているすべての `IIOReadUpdateListener` オブジェクトを削除します。
`void`	`removeAllIIOReadWarningListeners()` 現在登録されているすべての `IIOReadWarningListener` オブジェクトを削除します。
`void`	`removeIIOReadProgressListener(IIOReadProgressListener listener)` 登録された進捗リスナーのリストから、`IIOReadProgressListener` を削除します。
`void`	`removeIIOReadUpdateListener(IIOReadUpdateListener listener)` 登録された更新リスナーのリストから、`IIOReadUpdateListener` を削除します。
`void`	`removeIIOReadWarningListener(IIOReadWarningListener listener)` 登録されたエラーリスナーのリストから、`IIOReadWarningListener` を削除します。
`void`	`reset()` `ImageReader` を初期状態に復元します。
`void`	`setInput(Object input)` 指定された `ImageInputStream` またはほかの `Object` に使用するために入力ソースを設定します。
`void`	`setInput(Object input, boolean seekForwardOnly)` 指定された `ImageInputStream` またはほかの `Object` に使用するために入力ソースを設定します。
`void`	`setInput(Object input, boolean seekForwardOnly, boolean ignoreMetadata)` 指定された `ImageInputStream` またはほかの `Object` に使用するために入力ソースを設定します。
`void`	`setLocale(Locale locale)` この `ImageReader` の現在の `Locale` を、指定された値に設定します。

クラス java.lang.Object から継承されたメソッド
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- フィールドの詳細
  - originatingProvider
```
protected ImageReaderSpi originatingProvider
```
    このオブジェクトをインスタンス化する ImageReaderSpi、または識別情報が不明であるか存在しない場合は null です。デフォルトでは、null に初期化されます。
  - input
```
protected Object input
```
    ImageInputStream または setInput が設定して、getInput が取り出したその他の Object です。デフォルトでは、null に初期化されます。
  - seekForwardOnly
```
protected boolean seekForwardOnly
```
    現在の入力ソースが、setInput による順方向検索だけが可能となるように指定されている場合は true です。デフォルト値は false です。
    
    関連項目:
    minIndex, setInput(java.lang.Object, boolean, boolean)
  - ignoreMetadata
```
protected boolean ignoreMetadata
```
    現在の入力ソースが、setInput によってメタデータが無視されるように指定されている場合は true です。デフォルト値は false です。
    
    関連項目:
    setInput(java.lang.Object, boolean, boolean)
  - minIndex
```
protected int minIndex
```
    読み込み用の最小有効インデックスは、初期状態で 0 です。seekForwardOnly が true の場合、さまざまなメソッドが、より小さいインデックスを持つイメージに関連付けられたデータにアクセスしようとして IndexOutOfBoundsException をスローします。
    
    関連項目:
    seekForwardOnly, setInput(java.lang.Object, boolean, boolean)
  - availableLocales
```
protected Locale[] availableLocales
```
    警告メッセージのローカライズに使用する Locale の配列、またはローカライズ版がサポートされていない場合は null です。
  - locale
```
protected Locale locale
```
    ローカライズ版に使用する現在の Locale、または設定されていない場合は null です。
  - warningListeners
```
protected List<IIOReadWarningListener> warningListeners
```
    現在登録されている各 IIOReadWarningListener の List です。デフォルトでは null に初期化され、空の List と同じ意味になります。
  - warningLocales
```
protected List<Locale> warningLocales
```
    現在登録されている各 IIOReadWarningListener に関連付けられた Locale の List です。デフォルトでは null に初期化され、空の List と同じ意味になります。
  - progressListeners
```
protected List<IIOReadProgressListener> progressListeners
```
    現在登録されている各 IIOReadProgressListener の List です。デフォルトでは null に初期化され、空の List と同じ意味になります。
  - updateListeners
```
protected List<IIOReadUpdateListener> updateListeners
```
    現在登録されている各 IIOReadUpdateListener の List です。デフォルトでは null に初期化され、空の List と同じ意味になります。
- コンストラクタの詳細
  - ImageReader
```
protected ImageReader(ImageReaderSpi originatingProvider)
```
    ImageReader を構築し、originatingProvider フィールドを、指定された値に設定します。
    拡張機能を使用するサブクラスは、拡張オブジェクトを取り出すために、シグニチャー ((ImageReaderSpi, Object)) を持つコンストラクタを提供する必要があります。拡張オブジェクトが適切でない場合、IllegalArgumentException がスローされます。
    
    パラメータ:
    originatingProvider - このコンストラクタを呼び出す ImageReaderSpi または null。
- メソッドの詳細
  - getFormatName
```
public String getFormatName()
                     throws IOException
```
    入力ソースの形式を識別する String を返します。
    デフォルトの実装では originatingProvider.getFormatNames()[0] を返します。発生元のサービスプロバイダを持たないか、異なるネーミングポリシーが必要な実装はこのメソッドをオーバーライドする必要があります。
    
    戻り値:
    String としての形式名。
    
    例外:
    
    IOException - 入力ソースからの情報の読み込みエラーが発生した場合。
  - getOriginatingProvider
```
public ImageReaderSpi getOriginatingProvider()
```
    このコンストラクタに渡された ImageReaderSpi を返します。この値は null の場合があることに注意してください。
    
    戻り値:
    ImageReaderSpi、または null。
    関連項目:
    ImageReaderSpi
  - setInput
```
public void setInput(Object input,
            boolean seekForwardOnly,
            boolean ignoreMetadata)
```
    指定された ImageInputStream またはほかの Object に使用するために入力ソースを設定します。入力ソースは、照会または読み込みメソッドを使用する前に設定します。input が null の場合、現在設定されている入力ソースは削除されます。どの場合も、minIndex の値は 0 に初期化されます。
    seekForwardOnly パラメータは、getMinIndex によって返された値が、イメージ、サムネール、またはイメージメタデータが読み取られるごとに増加するかどうかを制御します。seekForwardOnly が true の場合、index < this.minIndex の場合は read(index) の呼び出しによって IndexOutOfBoundsException がスローされます。それ以外の場合は、minIndex の値が index に設定されます。seekForwardOnly が false の場合、読み込みオペレーションにかかわらず minIndex の値は 0 のままになります。
    true に設定されている場合、ignoreMetadata パラメータは、読み込み中に発生したメタデータを読み取り側が無視できるようにします。そのあとの getStreamMetadata および getImageMetadata メソッドの呼び出しは null を返し、readAll から返された IIOImage は getMetadata メソッドから null を返します。このパラメータの設定により、読み取り側はより効率的に作業できるようになります。読み取り側は、この設定を無効にして通常どおりメタデータを返すこともできます。
    サブクラスは、ヘッダー情報や部分的に復号化されたイメージデータなど、以前のストリームに基づくキャッシュ情報の削除に注意する必要があります。
    ImageInputStream 以外の一般の Object は、取得デバイスまたはイメージングプロトコルと直接対話する読み取り側のために使用されます。読み取り側のサービスプロバイダの getInputTypes メソッドにより、正規のクラスのセットが公示されます。ほとんどの読み取り側が、ImageInputStream だけを受け入れることを示すために、ImageInputStream.class だけを含む 1 つの要素の配列を返します。
    デフォルト実装は、originatingProvider.getInputTypes() によって返されるリストに対して input 引数を確認して、引数がリスト内の 1 つのクラスのインスタンスでない場合は失敗します。発生元のプロバイダが null に設定されている場合、入力が ImageInputStream である場合にだけ受け取られます。
    
    パラメータ:
    input - ImageInputStream または今後、復号化で使用するほかの Object。
    seekForwardOnly - true の場合、イメージとメタデータはこの入力ソースから昇順でのみ読み取られる。
    ignoreMetadata - true の場合、メタデータは読み込み中に無視される。
    
    例外:
    
    IllegalArgumentException - input が発生元サービスプロバイダの getInputTypes メソッドによって返されたいずれかのクラスのインスタンスではない場合、または ImageInputStream ではない場合。
    関連項目:
    ImageInputStream, getInput(), ImageReaderSpi.getInputTypes()
  - setInput
```
public void setInput(Object input,
            boolean seekForwardOnly)
```
    指定された ImageInputStream またはほかの Object に使用するために入力ソースを設定します。入力ソースは、照会または読み込みメソッドを使用する前に設定します。input が null の場合、現在設定されている入力ソースは削除されます。どの場合も、minIndex の値は 0 に初期化されます。
    seekForwardOnly パラメータは、getMinIndex によって返された値が、イメージ、サムネール、またはイメージメタデータが読み取られるごとに増加するかどうかを制御します。seekForwardOnly が true の場合、index < this.minIndex の場合は read(index) の呼び出しによって IndexOutOfBoundsException がスローされます。それ以外の場合は、minIndex の値が index に設定されます。seekForwardOnly が false の場合、読み込みオペレーションにかかわらず minIndex の値は 0 のままになります。
    このメソッドは、setInput(input, seekForwardOnly, false) と同等です。
    
    パラメータ:
    input - ImageInputStream または今後、復号化で使用するほかの Object。
    seekForwardOnly - true の場合、イメージとメタデータはこの入力ソースから昇順でのみ読み取られる。
    
    例外:
    
    IllegalArgumentException - input が発生元サービスプロバイダの getInputTypes メソッドによって返されたいずれかのクラスのインスタンスではない場合、または ImageInputStream ではない場合。
    関連項目:
    getInput()
  - setInput
```
public void setInput(Object input)
```
    指定された ImageInputStream またはほかの Object に使用するために入力ソースを設定します。入力ソースは、照会または読み込みメソッドを使用する前に設定します。input が null の場合、現在設定されている入力ソースは削除されます。どの場合も、minIndex の値は 0 に初期化されます。
    このメソッドは、setInput(input, false, false) と同等です。
    
    パラメータ:
    input - ImageInputStream または今後、復号化で使用するほかの Object。
    
    例外:
    
    IllegalArgumentException - input が発生元サービスプロバイダの getInputTypes メソッドによって返されたいずれかのクラスのインスタンスではない場合、または ImageInputStream ではない場合。
    関連項目:
    getInput()
  - getInput
```
public Object getInput()
```
    ImageInputStream または以前に入力ソースとして設定されたほかの Object を返します。入力ソースが設定されていない場合、null が返されます。
    
    戻り値:
    今後、復号化で使用される Object または null。
    関連項目:
    ImageInputStream, setInput(java.lang.Object, boolean, boolean)
  - isSeekForwardOnly
```
public boolean isSeekForwardOnly()
```
    現在の入力ソースが、setInput メソッドの seekForwardOnly 引数として true を渡すことにより、順方向検索だけで実施と指定されている場合は true を返します。
    
    戻り値:
    入力ソースが順方向検索だけの場合は true。
    関連項目:
    setInput(java.lang.Object, boolean, boolean)
  - isIgnoringMetadata
```
public boolean isIgnoringMetadata()
```
    現在の入力ソースが、setInput メソッドの ignoreMetadata 引数として true を渡すことにより、メタデータを無視できるように指定されている場合は true を返します。
    
    戻り値:
    メタデータが無視できる場合は true。
    関連項目:
    setInput(java.lang.Object, boolean, boolean)
  - getMinIndex
```
public int getMinIndex()
```
    イメージ、サムネール、またはイメージメタデータの読み込みに対して有効な、最小のインデックスを返します。seekForwardOnly() が false の場合、この値は通常 0 のままとなり、ランダムアクセスが可能であることを示します。それ以外の場合、直前にアクセスされたインデックスの値を保持し、単調に増加します。
    
    戻り値:
    読み込み用の正当な最小インデックス
  - getAvailableLocales
```
public Locale[] getAvailableLocales()
```
    警告リスナーと圧縮設定のローカライズに使用する Locale の配列を返します。戻り値 null は、ローカライズ版がサポートされていないことを示します。
    デフォルトの実装では、それが null 以外の場合は availableLocales インスタンス変数のクローンを返し、それ以外の場合は null を返します。
    
    戻り値:
    setLocale の引数として使用する Locale の配列、または null。
  - setLocale
```
public void setLocale(Locale locale)
```
    この ImageReader の現在の Locale を、指定された値に設定します。値 null は、以前の設定を削除して、読み取り側が適切にローカライズする必要があることを示します。
    
    パラメータ:
    locale - 目的の Locale、または null。
    
    例外:
    
    IllegalArgumentException - locale が null ではないが、getAvailableLocales によって返された値の 1 つではない場合。
    関連項目:
    getLocale()
  - getLocale
```
public Locale getLocale()
```
    現在設定されている Locale、何も設定されていない場合は null を返します。
    
    戻り値:
    現在の Locale、または null。
    関連項目:
    setLocale(java.util.Locale)
  - getNumImages
```
public abstract int getNumImages(boolean allowSearch)
                          throws IOException
```
    現在の入力ソースから、サムネールを除く使用可能なイメージの数を返します。
    動画 GIF など一部のイメージ形式は、現在のストリームにあるイメージの数を指定しないことに注意してください。このため、イメージ数を確認するにはストリーム全体の走査が必要で、バッファリングを行うために多くのメモリーが必要になることがあります。イメージが順番に処理される場合は、単純に read を呼び出し、IndexOutOfBoundsException がスローされることにより使用できるイメージがこれ以上ないことが示されるまでインデックスを増加させるほうが効率的です。allowSearch パラメータを false に設定して、徹底的な検索が不要であることを指示できます。この場合、戻り値は -1 となり、検索が必要であることを示します。入力が seekForwardOnly で指定され、true に設定されているとき、このメソッドは、allowSearch が true に設定されていれば、IllegalStateException をスローします。
    
    パラメータ:
    allowSearch - true の場合、検索が必要なときでも実際のイメージの数を返す。false の場合、読み取り側は検索を実行せずに -1 を返す。
    
    戻り値:
    int としてのイメージの数、または allowSearch が false の場合は -1 を返し、検索を要求する。
    
    例外:
    
    IllegalStateException - 入力ソースが設定されていない場合、または入力が seekForwardOnly で指定され、true に設定されている場合。
    
    IOException - 入力ソースからの情報の読み込みエラーが発生した場合。
    関連項目:
    setInput(java.lang.Object, boolean, boolean)
  - getWidth
```
public abstract int getWidth(int imageIndex)
                      throws IOException
```
    入力ソースの指定されたイメージの幅をピクセル単位で返します。
    ユーザー指定のサイズでイメージを描画できる場合、このメソッドはデフォルトの幅を返します。
    
    パラメータ:
    imageIndex - 照会されるイメージのインデックス。
    
    戻り値:
    int としてのイメージの幅。
    
    例外:
    
    IllegalStateException - 入力ソースが設定されていない場合。
    
    IndexOutOfBoundsException - 指定したインデックスが範囲外にある場合。
    
    IOException - 入力ソースからの幅情報の読み込みでエラーが発生した場合。
  - getHeight
```
public abstract int getHeight(int imageIndex)
                       throws IOException
```
    入力ソースの指定されたイメージの高さをピクセル単位で返します。
    ユーザー指定のサイズでイメージを描画できる場合、このメソッドはデフォルトの高さを返します。
    
    パラメータ:
    imageIndex - 照会されるイメージのインデックス。
    
    戻り値:
    int としてのイメージの高さ。
    
    例外:
    
    IllegalStateException - 入力ソースが設定されていない場合。
    
    IndexOutOfBoundsException - 指定したインデックスが範囲外にある場合。
    
    IOException - 入力ソースからの高さ情報の読み込みでエラーが発生した場合。
  - isRandomAccessEasy
```
public boolean isRandomAccessEasy(int imageIndex)
                           throws IOException
```
    ピクセルへのランダムアクセスに関して、指定されたイメージの格納形式に固有の障害が何もない場合は true を返します。JPEG などほとんどの圧縮形式では、対象の領域に加えて大規模なセクションを復号化する必要があるため、このメソッドは false を返します。
    これはプログラムを効率的に行うためのヒントにすぎません。すべての読み取り側は ImageReadParam に指定されているとおり、任意の領域を読み取る必要があります。
    その場合でも、このメソッドから false を返す形式は、JPEG の Restart Marker のようなタイリングが可能であり、タイル上のランダムアクセスが非常に効率的になることに注意してください。isImageTiled を参照してください。
    すべてのイメージが簡単なランダムアクセスのサポートを保証されている読み取り側、または簡単なランダムアクセスのサポートが保証されない読み取り側は、イメージデータにアクセスせずに、それぞれ true または false を返します。このような場合、入力ソースが設定されていないか、またはイメージのインデックスが範囲外にある場合でも、例外をスローする必要はありません。
    デフォルトの実装では false を返します。
    
    パラメータ:
    imageIndex - 照会されるイメージのインデックス。
    
    戻り値:
    指定されたイメージの対象領域の読み込みが効率的になると考えられる場合は true。
    
    例外:
    
    IllegalStateException - 入力ソースが戻り値の決定を要求される場合で、何も設定されていない場合。
    
    IndexOutOfBoundsException - 戻り値を決定するためにイメージにアクセスする必要があるが、指定されたインデックスが範囲外にある場合。
    
    IOException - 読み込み中にエラーが発生した場合。
  - getAspectRatio
```
public float getAspectRatio(int imageIndex)
                     throws IOException
```
    指定されたイメージの縦横比 (つまり、幅を高さで割った値) を float で返します。本来サイズ変更が可能なイメージの場合、このメソッドは指定された適切な高さを持つ幅 (またはその逆) を決定する方法を提供します。サイズ変更ができないイメージの場合、実際の幅と高さを使用します。
    デフォルトの実装では、(float)getWidth(imageIndex)/getHeight(imageIndex) を返すだけです。
    
    パラメータ:
    imageIndex - 照会されるイメージのインデックス。
    
    戻り値:
    指定されたイメージの縦横比を示す float。
    
    例外:
    
    IllegalStateException - 入力ソースが設定されていない場合。
    
    IndexOutOfBoundsException - 指定したインデックスが範囲外にある場合。
    
    IOException - 読み込み中にエラーが発生した場合。
  - getRawImageType
```
public ImageTypeSpecifier getRawImageType(int imageIndex)
                                   throws IOException
```
    イメージの raw 内部形式にもっとも近い形式を表す SampleModel と ColorModel を示して、ImageTypeSpecifier を返します。たとえば、JPEG イメージの場合、通常、表示される前にイメージを RGB カラースペースに変換する場合でも、raw 型は YCbCr カラースペースを持ちます。また、戻り値は getImageTypes によって返された値のリストに含まれる必要があります。
    デフォルト実装は、getImageType が提供するリストから最初のエントリを返すだけです。
    
    パラメータ:
    imageIndex - 照会されるイメージのインデックス。
    
    戻り値:
    ImageTypeSpecifier。
    
    例外:
    
    IllegalStateException - 入力ソースが設定されていない場合。
    
    IndexOutOfBoundsException - 指定したインデックスが範囲外にある場合。
    
    IOException - 入力ソースからの形式情報の読み込みでエラーが発生した場合。
  - getImageTypes
```
public abstract Iterator<ImageTypeSpecifier> getImageTypes(int imageIndex)
                                                    throws IOException
```
    ImageTypeSpecifiers の形式で指定されたイメージが復号化されるイメージ型を含む Iterator を返します。少なくとも 1 つの有効なイメージ型が返されます。
    イテレータの最初の要素は、イメージを最小の損失で復号化するために、もっとも「自然な」型でなければいけません。たとえば、JPEG イメージの場合、イメージデータが内部的に YCbCr カラースペースに格納されている場合でも、最初のエントリは RGB イメージになります。
    
    パラメータ:
    imageIndex - 取得されるイメージのインデックス。
    
    戻り値:
    現在指定されているイメージを復号化するために、推奨されたイメージ型を表す、少なくとも 1 つの ImageTypeSpecifier を保持する Iterator。
    
    例外:
    
    IllegalStateException - 入力ソースが設定されていない場合。
    
    IndexOutOfBoundsException - 指定したインデックスが範囲外にある場合。
    
    IOException - 入力ソースからの形式情報の読み込みでエラーが発生した場合。
    関連項目:
    ImageReadParam.setDestination(BufferedImage), ImageReadParam.setDestinationType(ImageTypeSpecifier)
  - getDefaultReadParam
```
public ImageReadParam getDefaultReadParam()
```
    この形式に対して適切なデフォルトの ImageReadParam オブジェクトを返します。すべてのサブクラスは、すべてのパラメータのデフォルト値のセットを定義して、この呼び出しでそれらを返さなければいけません。このメソッドは、入力ソースが設定される前に呼び出されます。
    デフォルト実装は、ソースのスケーリングを実行できない新しい ImageReadParam オブジェクトを構築して返します。つまり、new ImageReadParam() を返します。
    
    戻り値:
    一連のデフォルト設定を使用して、復号化プロセスを制御するために使用される ImageReadParam オブジェクト。
  - getStreamMetadata
```
public abstract IIOMetadata getStreamMetadata()
                                       throws IOException
```
    入力ソースに全体として関連付けられた、つまり特定のイメージに関連付けられていないメタデータを表す IIOMetadata オブジェクトを返します。または、読み取り側がメタデータを無視するよう設定され、メタデータの読み込みをサポートしていない場合、あるいはメタデータが使用できない場合は null を返します。
    
    戻り値:
    IIOMetadata オブジェクト、または null。
    
    例外:
    
    IOException - 読み込み中にエラーが発生した場合。
  - getStreamMetadata
```
public IIOMetadata getStreamMetadata(String formatName,
                            Set<String> nodeNames)
                              throws IOException
```
    入力ソースに全体として関連付けられた、つまり特定のイメージに関連付けられていないメタデータを表す IIOMetadata オブジェクトを返します。このようなデータが存在しない場合は null を返します。
    結果のメタデータオブジェクトは formatName と名前の付けられた形式のドキュメントを返すだけです。返されるドキュメント内では、名前が nodeNames のメンバーであるノードだけを返すよう要求されます。このようにして、読み取り側によって処理されたメタデータの量が、実際に必要な情報に基づく最小の量になるように管理されます。
    formatName がサポートされたメタデータ形式の名前ではない場合、null を返します。
    どのような場合でも、厳密に必要なオブジェクトにとどまらず、有効なメタデータオブジェクトを返すようにすることができます。形式名およびノード名は、読み取り側の作業負荷を削減するために使用するヒントに過ぎません。
    デフォルト実装は、形式名がサポートされていることを確認してから getStreamMetadata() の呼び出しの結果を返すだけです。それ以外の場合は、null が返されます。
    
    パラメータ:
    formatName - 返された IIOMetadata オブジェクトからドキュメントを取得するために使用するメタデータの形式名。
    nodeNames - 取得されたドキュメントに含まれるノード名を保持する Set。
    
    戻り値:
    IIOMetadata オブジェクト、または null。
    
    例外:
    
    IllegalArgumentException - formatName が null の場合。
    
    IllegalArgumentException - nodeNames が null の場合。
    
    IOException - 読み込み中にエラーが発生した場合。
  - getImageMetadata
```
public abstract IIOMetadata getImageMetadata(int imageIndex)
                                      throws IOException
```
    指定されたイメージに関連付けられたメタデータを保持する IIOMetadata オブジェクトを返します。または、読み取り側がメタデータを無視するよう設定され、メタデータの読み込みをサポートしていない場合、あるいはメタデータが使用できない場合は null を返します。
    
    パラメータ:
    imageIndex - メタデータの取得元イメージのインデックス。
    
    戻り値:
    IIOMetadata オブジェクト、または null。
    
    例外:
    
    IllegalStateException - 入力ソースが設定されていない場合。
    
    IndexOutOfBoundsException - 指定したインデックスが範囲外にある場合。
    
    IOException - 読み込み中にエラーが発生した場合。
  - getImageMetadata
```
public IIOMetadata getImageMetadata(int imageIndex,
                           String formatName,
                           Set<String> nodeNames)
                             throws IOException
```
    指定されたイメージに関連付けられたメタデータを表す IIOMetadata オブジェクトを返します。読み取り側がメタデータの読み込みをサポートしていない場合、あるいはメタデータを使用できない場合は null を返します。
    結果のメタデータオブジェクトは formatName と名前の付けられた形式のドキュメントを返すだけです。返されるドキュメント内では、名前が nodeNames のメンバーであるノードだけを返すよう要求されます。このようにして、読み取り側によって処理されたメタデータの量が、実際に必要な情報に基づく最小の量になるように管理されます。
    formatName がサポートされたメタデータ形式の名前ではない場合、null を返します。
    どのような場合でも、厳密に必要なオブジェクトにとどまらず、有効なメタデータオブジェクトを返すようにすることができます。形式名およびノード名は、読み取り側の作業負荷を削減するために使用するヒントに過ぎません。
    デフォルト実装は、形式名がサポートされていることを確認してから getImageMetadata(imageIndex) の呼び出しの結果を返すだけです。それ以外の場合は、null が返されます。
    
    パラメータ:
    imageIndex - メタデータの取得元イメージのインデックス。
    formatName - 返された IIOMetadata オブジェクトからドキュメントを取得するために使用するメタデータの形式名。
    nodeNames - 取得されたドキュメントに含まれるノード名を保持する Set。
    
    戻り値:
    IIOMetadata オブジェクト、または null。
    
    例外:
    
    IllegalStateException - 入力ソースが設定されていない場合。
    
    IndexOutOfBoundsException - 指定したインデックスが範囲外にある場合。
    
    IllegalArgumentException - formatName が null の場合。
    
    IllegalArgumentException - nodeNames が null の場合。
    
    IOException - 読み込み中にエラーが発生した場合。
  - read
```
public BufferedImage read(int imageIndex)
                   throws IOException
```
    imageIndex によってインデックスを付けられたイメージを読み込み、デフォルトの ImageReadParam を使用して、完全な BufferedImage として返します。これは read(imageIndex, null) を呼び出す簡易メソッドです。
    返されるイメージは getImageTypes から返される最初の ImageTypeSpecifier によってフォーマットされます。
    登録された IIOReadProgressListener オブジェクトは imageStarted メソッドの呼び出しによって通知され、そのあとに読み込みの進捗とともに imageProgress メソッドの呼び出しが続きます。最後に imageComplete メソッドが呼び出されます。IIOReadUpdateListener オブジェクトは、読み込み中にピクセルが復号化されるときに更新されます。最後に、IIOReadWarningListener オブジェクトは、復号化中に発生する致命的ではない警告の通知を受け取ります。
    
    パラメータ:
    imageIndex - 取得されるイメージのインデックス。
    
    戻り値:
    BufferedImage としてのイメージの必要な部分。
    
    例外:
    
    IllegalStateException - 入力ソースが設定されていない場合。
    
    IndexOutOfBoundsException - 指定したインデックスが範囲外にある場合。
    
    IOException - 読み込み中にエラーが発生した場合。
  - read
```
public abstract BufferedImage read(int imageIndex,
                 ImageReadParam param)
                            throws IOException
```
    imageIndex によってインデックスを付けられたイメージを読み込み、指定された ImageReadParam を使用して、完全な BufferedImage として返します。
    返される実際の BufferedImage は、getDestination メソッドによって定義されたアルゴリズムを使用して選択されます。
    登録された IIOReadProgressListener オブジェクトは imageStarted メソッドの呼び出しによって通知され、そのあとに読み込みの進捗とともに imageProgress メソッドの呼び出しが続きます。最後に imageComplete メソッドが呼び出されます。IIOReadUpdateListener オブジェクトは、読み込み中にピクセルが復号化されるときに更新されます。最後に、IIOReadWarningListener オブジェクトは、復号化中に発生する致命的ではない警告の通知を受け取ります。
    読み取られるソースバンドおよび書き込まれるデスティネーションバンドのセットは、指定された ImageReadParam で getSourceBands と getDestinationBands を呼び出すことによって決定されます。これらのメソッドによって返される配列の長さが異なる場合、ソースバンドのセットが使用可能な最大のソースインデックスより大きいインデックスを保持する場合、またはデスティネーションバンドのセットが有効な最大のデスティネーションインデックスより大きいインデックスを保持する場合、IllegalArgumentException がスローされます。
    指定された ImageReadParam が、この読み取り側によってサポートされないオプションの設定値 (たとえば、ソースの描画サイズや形式固有の設定) を保持する場合、これらは無視されます。
    
    パラメータ:
    imageIndex - 取得されるイメージのインデックス。
    param - 読み込みプロセスの制御に使用する ImageReadParam、または null。
    
    戻り値:
    BufferedImage としてのイメージの必要な部分。
    
    例外:
    
    IllegalStateException - 入力ソースが設定されていない場合。
    
    IndexOutOfBoundsException - 指定したインデックスが範囲外にある場合。
    
    IllegalArgumentException - param.getSourceBands および param.getDestinationBands によって指定されたソースバンドとデスティネーションバンドのセットの長さが異なる場合、または範囲外のインデックスを含んでいる場合。
    
    IllegalArgumentException - 結果のイメージが 1 より小さい幅または高さを持つ場合。
    
    IOException - 読み込み中にエラーが発生した場合。
  - readAll
```
public IIOImage readAll(int imageIndex,
               ImageReadParam param)
                 throws IOException
```
    imageIndex によってインデックスを付けられたイメージを読み込み、指定された ImageReadParam を使用して、イメージ、サムネール、および関連するイメージのメタデータを保持する IIOImage を返します。
    返される IIOImage によって参照される実際の BufferedImage は、getDestination メソッドによって定義されたアルゴリズムを使用して選択されます。
    登録された IIOReadProgressListener オブジェクトは imageStarted メソッドの呼び出しによって通知され、そのあとに読み込みの進捗とともに imageProgress メソッドの呼び出しが続きます。最後に imageComplete メソッドが呼び出されます。IIOReadUpdateListener オブジェクトは、読み込み中にピクセルが復号化されるときに更新されます。最後に、IIOReadWarningListener オブジェクトは、復号化中に発生する致命的ではない警告の通知を受け取ります。
    読み取られるソースバンドおよび書き込まれるデスティネーションバンドのセットは、指定された ImageReadParam で getSourceBands と getDestinationBands を呼び出すことによって決定されます。これらのメソッドによって返される配列の長さが異なる場合、ソースバンドのセットが使用可能な最大のソースインデックスより大きいインデックスを保持する場合、またはデスティネーションバンドのセットが有効な最大のデスティネーションインデックスより大きいインデックスを保持する場合、IllegalArgumentException がスローされます。
    領域の設定に関係なく、サムネールの全体が返されます。
    指定された ImageReadParam が、この読み取り側によってサポートされないオプションの設定値 (たとえば、ソースの描画サイズや形式固有の設定) を保持する場合、これらの値は無視されます。
    
    パラメータ:
    imageIndex - 取得されるイメージのインデックス。
    param - 読み込みプロセスの制御に使用する ImageReadParam、または null。
    
    戻り値:
    イメージの必要な部分、サムネールのセット、および関連するイメージメタデータを保持する IIOImage。
    
    例外:
    
    IllegalStateException - 入力ソースが設定されていない場合。
    
    IndexOutOfBoundsException - 指定したインデックスが範囲外にある場合。
    
    IllegalArgumentException - param.getSourceBands および param.getDestinationBands によって指定されたソースバンドとデスティネーションバンドのセットの長さが異なる場合、または範囲外のインデックスを含んでいる場合。
    
    IllegalArgumentException - 結果のイメージが 1 より小さい幅または高さを持つ場合。
    
    IOException - 読み込み中にエラーが発生した場合。
  - readAll
```
public Iterator<IIOImage> readAll(Iterator<? extends ImageReadParam> params)
                           throws IOException
```
    すべてのイメージ、サムネール、およびメタデータを保持し、getMinIndex によって指定されたインデックスで始まる Iterator を、IIOImage オブジェクトの形式で入力ソースから返します。ImageReadParam オブジェクトを保持する Iterator が提供されます。使用できるイメージがなくなるまで、入力ソースから読み取られるイメージごとに 1 つの要素が消費されます。読み込みパラメータの Iterator が、要素を消費し尽くした場合で、入力ソースから使用できるイメージがまだあるときは、残されたイメージに対してデフォルトの読み込みパラメータが使用されます。
    params が null の場合、すべてのイメージに対してデフォルトの読み込みパラメータが使用されます。
    返される IIOImage によって参照される実際の BufferedImage は、getDestination メソッドによって定義されたアルゴリズムを使用して選択されます。
    登録された IIOReadProgressListener オブジェクトは sequenceStarted メソッドの呼び出しによって 1 回通知されます。次に、復号化された各イメージに対して、imageStarted の呼び出しが行われ、そのあとに読み込みの進捗とともに imageProgress が呼び出され、最後に imageComplete が呼び出されます。sequenceComplete メソッドは、最後のイメージがデコートされたあとに呼び出されます。IIOReadUpdateListener オブジェクトは、読み込み中にピクセルが復号化されるときに更新されます。最後に、IIOReadWarningListener オブジェクトは、復号化中に発生する致命的ではない警告の通知を受け取ります。
    読み取られるソースバンドおよび書き込まれるデスティネーションバンドのセットは、指定された ImageReadParam で getSourceBands と getDestinationBands を呼び出すことによって決定されます。これらのメソッドによって返される配列の長さが異なる場合、ソースバンドのセットが使用可能な最大のソースインデックスより大きいインデックスを保持する場合、またはデスティネーションバンドのセットが有効な最大のデスティネーションインデックスより大きいインデックスを保持する場合、IllegalArgumentException がスローされます。
    領域の設定に関係なく、サムネールの全体が返されます。
    指定された ImageReadParam が、この読み取り側によってサポートされないオプションの設定値 (たとえば、ソースの描画サイズや形式固有の設定) を保持する場合、これらは無視されます。
    
    パラメータ:
    params - ImageReadParam オブジェクトを保持する Iterator。
    
    戻り値:
    IIOImage として、入力ソースの内容を表す Iterator。
    
    例外:
    
    IllegalStateException - 入力ソースが設定されていない場合。
    
    IllegalArgumentException - params の null 以外の要素が ImageReadParam ではない場合。
    
    IllegalArgumentException - param.getSourceBands および param.getDestinationBands によって指定されたソースバンドとデスティネーションバンドのセットの長さが異なる場合、または範囲外のインデックスを含んでいる場合。
    
    IllegalArgumentException - 結果のイメージが 1 より小さい幅または高さを持つ場合。
    
    IOException - 読み込み中にエラーが発生した場合。
    関連項目:
    ImageReadParam, IIOImage
  - canReadRaster
```
public boolean canReadRaster()
```
    このプラグインがピクセルデータの Raster だけの読み込みをサポートする場合、true を返します。このメソッドが false を返す場合、readRaster または readTileRaster の呼び出しは UnsupportedOperationException をスローします。
    デフォルトの実装では false を返します。
    
    戻り値:
    このプラグインが raw Raster の読み込みをサポートする場合は true。
    関連項目:
    readRaster(int, javax.imageio.ImageReadParam), readTileRaster(int, int, int)
  - readRaster
```
public Raster readRaster(int imageIndex,
                ImageReadParam param)
                  throws IOException
```
    色変換を適用せずに、イメージストリームからのピクセルデータを保持する新しい Raster オブジェクトを返します。アプリケーションは、別の方法でピクセルデータを解釈する方法を指定します。指定された ImageReadParam オブジェクトのデスティネーションまたはイメージ型のパラメータは無視されます。ただし、ほかのすべてのパラメータは、デスティネーション座標が物理座標ではなく論理座標として使用されることを除いて、read メソッドの場合とまったく同様に使用されます。返される Raster のサイズは、常に実際のイメージにクリップされたソース領域のサイズになります。ストリーム自体の論理座標は無視されます。
    このメソッドは JPEG など通常、色変換を適用する形式や、リモートセンシングまたは医療用イメージデータなど通常、関連するカラースペースを持たない形式が raw ピクセルデータにアクセスできるようにします。
    登録された readUpdateListener は無視されるので、BufferedImage はありませんが、ほかのすべてのリスナーは、read メソッドの場合のように正確に呼び出されます。
    canReadRaster() が false を返す場合、このメソッドは UnsupportedOperationException をスローします。
    指定された ImageReadParam が、この読み取り側によってサポートされないオプションの設定値 (たとえば、ソースの描画サイズや形式固有の設定) を保持する場合、これらは無視されます。
    デフォルトの実装では UnsupportedOperationException をスローします。
    
    パラメータ:
    imageIndex - 読み取られるイメージのインデックス。
    param - 読み込みプロセスの制御に使用する ImageReadParam、または null。
    
    戻り値:
    Raster としてのイメージの必要な部分。
    
    例外:
    
    UnsupportedOperationException - このプラグインが Raster の読み込みをサポートしない場合。
    
    IllegalStateException - 入力ソースが設定されていない場合。
    
    IndexOutOfBoundsException - 指定したインデックスが範囲外にある場合。
    
    IOException - 読み込み中にエラーが発生した場合。
    関連項目:
    canReadRaster(), read(int), Raster
  - isImageTiled
```
public boolean isImageTiled(int imageIndex)
                     throws IOException
```
    イメージがタイル、つまりオーバーラップしない等しいサイズの矩形に組み入れられる場合は true を返します。
    読み取り側のプラグインは、イメージに存在するタイリングを格納されているとおりに表示するかどうかを選択できます。明らかに何も存在しない場合でも、タイリングの通知を選択できます。一般に、個々のタイルにアクセスするときに何らかの利点 (速度や容量など) がある場合にだけ、タイリングは通知されます。読み取り側は、タイリングを通知するかどうかにかかわらず、ImageReadParam に指定された任意の矩形領域を読み取ることができる必要があります。
    すべてのイメージをタイリングするように保証されている、あるいはタイリングしないように保証されている読み取り側は、イメージデータにアクセスせずにそれぞれ true または false を返します。このような場合、入力ソースが設定されていないか、またはイメージのインデックスが範囲外にある場合でも、例外をスローする必要はありません。
    デフォルト実装は false を返します。
    
    パラメータ:
    imageIndex - 照会されるイメージのインデックス。
    
    戻り値:
    イメージがタイリングされる場合は true。
    
    例外:
    
    IllegalStateException - 入力ソースが戻り値の決定を要求される場合で、何も設定されていない場合。
    
    IndexOutOfBoundsException - 戻り値を決定するためにイメージにアクセスする必要があるが、指定されたインデックスが範囲外にある場合。
    
    IOException - 読み込み中にエラーが発生した場合。
  - getTileWidth
```
public int getTileWidth(int imageIndex)
                 throws IOException
```
    指定されたイメージのタイルの幅を返します。
    デフォルト実装では、単にタイリングされないイメージに対して正しい getWidth(imageIndex) を返します。タイリングをサポートする読み取り側は、このメソッドをオーバーライドする必要があります。
    
    パラメータ:
    imageIndex - 照会されるイメージのインデックス。
    
    戻り値:
    タイルの幅
    
    例外:
    
    IllegalStateException - 入力ソースが設定されていない場合。
    
    IndexOutOfBoundsException - 指定したインデックスが範囲外にある場合。
    
    IOException - 読み込み中にエラーが発生した場合。
  - getTileHeight
```
public int getTileHeight(int imageIndex)
                  throws IOException
```
    指定されたイメージのタイルの高さを返します。
    デフォルト実装では、単にタイリングされないイメージに対して正しい getHeight(imageIndex) を返します。タイリングをサポートする読み取り側は、このメソッドをオーバーライドする必要があります。
    
    パラメータ:
    imageIndex - 照会されるイメージのインデックス。
    
    戻り値:
    タイルの高さ
    
    例外:
    
    IllegalStateException - 入力ソースが設定されていない場合。
    
    IndexOutOfBoundsException - 指定したインデックスが範囲外にある場合。
    
    IOException - 読み込み中にエラーが発生した場合。
  - getTileGridXOffset
```
public int getTileGridXOffset(int imageIndex)
                       throws IOException
```
    指定されたイメージのタイル (0, 0) の左上隅の X 座標を返します。
    タイルグリッドの X 座標が常に同じ値 (通常は 0) を持つ読み取り側は、イメージデータにアクセスせずに値を返します。このような場合、入力ソースが設定されていないか、またはイメージのインデックスが範囲外にある場合でも、例外をスローする必要はありません。
    デフォルト実装は、ほとんどの形式のタイリングされないイメージとタイリングされたイメージに対して正しい値 0 を返すだけです。(0, 0) 以外の座標を持つタイリングをサポートする読み取り側は、このメソッドをオーバーライドする必要があります。
    
    パラメータ:
    imageIndex - 照会されるイメージのインデックス。
    
    戻り値:
    タイルグリッドの X 座標
    
    例外:
    
    IllegalStateException - 入力ソースが戻り値の決定を要求される場合で、何も設定されていない場合。
    
    IndexOutOfBoundsException - 戻り値を決定するためにイメージにアクセスする必要があるが、指定されたインデックスが範囲外にある場合。
    
    IOException - 読み込み中にエラーが発生した場合。
  - getTileGridYOffset
```
public int getTileGridYOffset(int imageIndex)
                       throws IOException
```
    指定されたイメージのタイル (0, 0) の左上隅の Y 座標を返します。
    タイルグリッドの Y 座標が常に同じ値 (通常は 0) を持つ読み取り側は、イメージデータにアクセスせずに値を返します。このような場合、入力ソースが設定されていないか、またはイメージのインデックスが範囲外にある場合でも、例外をスローする必要はありません。
    デフォルト実装は、ほとんどの形式のタイリングされないイメージとタイリングされたイメージに対して正しい値 0 を返すだけです。(0, 0) 以外の座標を持つタイリングをサポートする読み取り側は、このメソッドをオーバーライドする必要があります。
    
    パラメータ:
    imageIndex - 照会されるイメージのインデックス。
    
    戻り値:
    タイルグリッドの Y 座標
    
    例外:
    
    IllegalStateException - 入力ソースが戻り値の決定を要求される場合で、何も設定されていない場合。
    
    IndexOutOfBoundsException - 戻り値を決定するためにイメージにアクセスする必要があるが、指定されたインデックスが範囲外にある場合。
    
    IOException - 読み込み中にエラーが発生した場合。
  - readTile
```
public BufferedImage readTile(int imageIndex,
                     int tileX,
                     int tileY)
                       throws IOException
```
    tileX および tileY 引数によって指定され、BufferedImage として返されるタイルを読み込みます。引数が領域外にある場合、IllegalArgumentException がスローされます。イメージがタイリングされない場合、値 0, 0 はイメージ全体を返します。その他の値では IllegalArgumentException がスローされます。
    このメソッドは、単に読み込みパラメータを使用して read(int, ImageReadParam) を読み取る場合と同等の簡易メソッドです。この読み込みパラメータは、tileX*getTileWidth(imageIndex)、tileY*getTileHeight(imageIndex) の座標および getTileWidth(imageIndex)、getTileHeight(imageIndex) の幅と高さを持つソース領域を指定し、サブサンプリング係数 1 および座標 0 を指定します。タイルを間引きするには、この領域と異なるサブサンプリングパラメータを指定する読み込みパラメータを使用して、read を呼び出します。
    デフォルト実装は、tileX および tileY が 0 の場合、イメージ全体を返し、0 以外の場合は IllegalArgumentException をスローします。
    
    パラメータ:
    imageIndex - 取得されるイメージのインデックス。
    tileX - 取得されるタイルの 0 で始まる列インデックス。
    tileY - 取得されるタイルの 0 で始まる行インデックス。
    
    戻り値:
    BufferedImage としてのタイル。
    
    例外:
    
    IllegalStateException - 入力ソースが設定されていない場合。
    
    IndexOutOfBoundsException - imageIndex が範囲外にある場合。
    
    IllegalArgumentException - タイルのインデックスが範囲外の場合。
    
    IOException - 読み込み中にエラーが発生した場合。
  - readTileRaster
```
public Raster readTileRaster(int imageIndex,
                    int tileX,
                    int tileY)
                      throws IOException
```
    色変換を適用せずに、タイルからの raw ピクセルデータを保持する新しい Raster オブジェクトを返します。アプリケーションは、別の方法でピクセルデータを解釈する方法を指定します。
    canReadRaster() が false を返す場合、このメソッドは UnsupportedOperationException をスローします。
    デフォルト実装は、Raster の読み込みをサポートしているかどうかを確認します。サポートしている場合は、tileX および tileY が 0 の場合、readRaster(imageIndex, null) を呼び出します。0 以外の場合は IllegalArgumentException をスローします。
    
    パラメータ:
    imageIndex - 取得されるイメージのインデックス。
    tileX - 取得されるタイルの 0 で始まる列インデックス。
    tileY - 取得されるタイルの 0 で始まる行インデックス。
    
    戻り値:
    Raster としてのタイル。
    
    例外:
    
    UnsupportedOperationException - このプラグインが Raster の読み込みをサポートしない場合。
    
    IllegalArgumentException - タイルのインデックスが範囲外の場合。
    
    IllegalStateException - 入力ソースが設定されていない場合。
    
    IndexOutOfBoundsException - imageIndex が範囲外にある場合。
    
    IOException - 読み込み中にエラーが発生した場合。
    関連項目:
    readTile(int, int, int), readRaster(int, javax.imageio.ImageReadParam), Raster
  - readAsRenderedImage
```
public RenderedImage readAsRenderedImage(int imageIndex,
                                ImageReadParam param)
                                  throws IOException
```
    imageIndex によってインデックスを付けられたイメージの内容を保持する RenderedImage オブジェクトを返します。デフォルトでは、返されるイメージは単純に read(imageIndex, param) によって返される BufferedImage です。
    このメソッドのセマンティクスは、ほかの read メソッドのセマンティクスといくつかの点で異なることがあります。まず、ImageReadParam に設定される任意のデスティネーションイメージまたはイメージ型、あるいはその両方は無視されます。次に、通常のリスナーの呼び出しは、それらが実行されること、または実行されても意味があることは保証されません。これは、イメージが返されたとき、あるいは実際には任意の時点で、返されたイメージがピクセルデータにより完全には生成されないことがあるためです。
    指定された ImageReadParam が、この読み取り側によってサポートされないオプションの設定値 (たとえば、ソースの描画サイズや形式固有の設定) を保持する場合、これらは無視されます。
    デフォルト実装は、read(imageIndex, param) を呼び出すだけです。
    
    パラメータ:
    imageIndex - 取得されるイメージのインデックス。
    param - 読み込みプロセスの制御に使用する ImageReadParam、または null。
    
    戻り値:
    イメージのビューを提供する RenderedImage オブジェクト。
    
    例外:
    
    IllegalStateException - 入力ソースが設定されていない場合。
    
    IndexOutOfBoundsException - 指定したインデックスが範囲外にある場合。
    
    IllegalArgumentException - param.getSourceBands および param.getDestinationBands によって指定されたソースバンドとデスティネーションバンドのセットの長さが異なる場合、または範囲外のインデックスを含んでいる場合。
    
    IllegalArgumentException - 結果のイメージが 1 より小さい幅または高さを持つ場合。
    
    IOException - 読み込み中にエラーが発生した場合。
  - readerSupportsThumbnails
```
public boolean readerSupportsThumbnails()
```
    この読み取り側によって認識されるイメージ形式が、それに関連付けられたサムネールプレビューイメージをサポートする場合、true を返します。デフォルトの実装では false を返します。
    このメソッドが false を返す場合、hasThumbnails と getNumThumbnails は、それぞれ false と 0 を返します。また、readThumbnail は、引数にかかわらず UnsupportedOperationException を返します。
    サムネールをサポートしない読み取り側は、サムネールに関連するメソッドを実装する必要がありません。
    
    戻り値:
    サムネールがサポートされる場合は true。
  - hasThumbnails
```
public boolean hasThumbnails(int imageIndex)
                      throws IOException
```
    指定されたイメージが、それに関連付けられたサムネールプレビューイメージを持つ場合、true を返します。形式がサムネールをサポートしない場合、つまり readerSupportsThumbnails が false を返す場合、入力ソースが設定されているかどうか、または imageIndex が境界内にあるかどうかにかかわらず false を返します。
    getNumThumbnails が 0 より大きい値を返す場合、デフォルト実装は true を返します。
    
    パラメータ:
    imageIndex - 照会されるイメージのインデックス。
    
    戻り値:
    指定されたイメージがサムネールの場合は true。
    
    例外:
    
    IllegalStateException - 読み取り側がサムネールをサポートするが、入力ソースが設定されていない場合。
    
    IndexOutOfBoundsException - 読み取り側がサムネールをサポートするが、imageIndex が範囲外にある場合。
    
    IOException - 読み込み中にエラーが発生した場合。
  - getNumThumbnails
```
public int getNumThumbnails(int imageIndex)
                     throws IOException
```
    指定されたイメージに関連付けられたサムネールプレビューイメージの数を返します。形式がサムネールをサポートしない場合、つまり readerSupportsThumbnails が false を返す場合、入力ソースが設定されているかどうか、または imageIndex が境界内にあるかどうかにかかわらず 0 を返します。
    デフォルト実装は、その引数を確認することなく、0 を返します。
    
    パラメータ:
    imageIndex - 照会されるイメージのインデックス。
    
    戻り値:
    指定されたイメージに関連付けられたサムネールの数。
    
    例外:
    
    IllegalStateException - 読み取り側がサムネールをサポートするが、入力ソースが設定されていない場合。
    
    IndexOutOfBoundsException - 読み取り側がサムネールをサポートするが、imageIndex が範囲外にある場合。
    
    IOException - 読み込み中にエラーが発生した場合。
  - getThumbnailWidth
```
public int getThumbnailWidth(int imageIndex,
                    int thumbnailIndex)
                      throws IOException
```
    thumbnailIndex によってインデックスを付けられたサムネールプレビューイメージの幅を返します。このイメージは ImageIndex によってインデックスを付けられたイメージに関連付けられています。
    読み取り側がサムネールをサポートしない場合、つまり readerSupportsThumbnails が false を返す場合、UnsupportedOperationException がスローされます。
    デフォルトの実装では、readThumbnail(imageindex, thumbnailIndex).getWidth() を返すだけです。したがって、サブクラスはサムネールを読み取らないようにするために、可能な場合はこのメソッドをオーバーライドする必要があります。
    
    パラメータ:
    imageIndex - 取得されるイメージのインデックス。
    thumbnailIndex - 取得されるサムネールのインデックス。
    
    戻り値:
    int として望ましいサムネールの幅。
    
    例外:
    
    UnsupportedOperationException - サムネールがサポートされない場合。
    
    IllegalStateException - 入力ソースが設定されていない場合。
    
    IndexOutOfBoundsException - 指定されたインデックスのいずれかが範囲外にある場合。
    
    IOException - 読み込み中にエラーが発生した場合。
  - getThumbnailHeight
```
public int getThumbnailHeight(int imageIndex,
                     int thumbnailIndex)
                       throws IOException
```
    thumbnailIndex によってインデックスを付けられたサムネールプレビューイメージの高さを返します。このイメージは ImageIndex によってインデックスを付けられたイメージに関連付けられています。
    読み取り側がサムネールをサポートしない場合、つまり readerSupportsThumbnails が false を返す場合、UnsupportedOperationException がスローされます。
    デフォルトの実装では、readThumbnail(imageindex, thumbnailIndex).getHeight() を返すだけです。したがって、サブクラスはサムネールを読み取らないようにするために、可能な場合はこのメソッドをオーバーライドする必要があります。
    
    パラメータ:
    imageIndex - 取得されるイメージのインデックス。
    thumbnailIndex - 取得されるサムネールのインデックス。
    
    戻り値:
    int として望ましいサムネールの高さ。
    
    例外:
    
    UnsupportedOperationException - サムネールがサポートされない場合。
    
    IllegalStateException - 入力ソースが設定されていない場合。
    
    IndexOutOfBoundsException - 指定されたインデックスのいずれかが範囲外にある場合。
    
    IOException - 読み込み中にエラーが発生した場合。
  - readThumbnail
```
public BufferedImage readThumbnail(int imageIndex,
                          int thumbnailIndex)
                            throws IOException
```
    thumbnailIndex によってインデックスを付けられたサムネールプレビューイメージを返します。このイメージは、BufferedImage として ImageIndex によってインデックスを付けられたイメージに関連付けられています。
    登録された IIOReadProgressListener オブジェクトは、thumbnailStarted、thumbnailProgress、および thumbnailComplete メソッドを呼び出すことにより通知されます。
    読み取り側がサムネールをサポートしない場合、つまり readerSupportsThumbnails が false を返すとき、入力ソースが設定されているかどうか、またはインデックスが境界内にあるかどうかにかかわらず UnsupportedOperationException をスローします。
    デフォルトの実装では UnsupportedOperationException をスローします。
    
    パラメータ:
    imageIndex - 取得されるイメージのインデックス。
    thumbnailIndex - 取得されるサムネールのインデックス。
    
    戻り値:
    BufferedImage としての目的のサムネール。
    
    例外:
    
    UnsupportedOperationException - サムネールがサポートされない場合。
    
    IllegalStateException - 入力ソースが設定されていない場合。
    
    IndexOutOfBoundsException - 指定されたインデックスのいずれかが範囲外にある場合。
    
    IOException - 読み込み中にエラーが発生した場合。
  - abort
```
public void abort()
```
    現在の読み込みオペレーションの中断を要求します。中断後のイメージの内容は定義されません。
    読み取り側は各読み込みオペレーションの開始時に clearAbortRequest を呼び出して、読み込み中に abortRequested の値を定期的にポーリングする必要があります。
  - abortRequested
```
protected boolean abortRequested()
```
    読み取り側がインスタンス化されたか、または clearAbortRequest が呼び出されたため、現在の読み込みオペレーションを中断するリクエストが行われた場合、true を返します。
    
    戻り値:
    現在の読み込みオペレーションを中断する必要がある場合は true。
    関連項目:
    abort(), clearAbortRequest()
  - clearAbortRequest
```
protected void clearAbortRequest()
```
    以前の中断リクエストをクリアします。このメソッドが呼び出されると、abortRequested は false を返します。
    
    関連項目:
    abort(), abortRequested()
  - addIIOReadWarningListener
```
public void addIIOReadWarningListener(IIOReadWarningListener listener)
```
    登録された警告リスナーのリストに IIOReadWarningListener を追加します。listener が null の場合、例外はスローされず、何も処理は行われません。指定されたリスナーに送られたメッセージは、可能であれば、現在の Locale に合うようにローカライズされます。Locale が設定されていない場合は、読み取り側に適合するよう警告メッセージをローカライズできます。
    
    パラメータ:
    listener - 登録される IIOReadWarningListener。
    関連項目:
    removeIIOReadWarningListener(javax.imageio.event.IIOReadWarningListener)
  - removeIIOReadWarningListener
```
public void removeIIOReadWarningListener(IIOReadWarningListener listener)
```
    登録されたエラーリスナーのリストから、IIOReadWarningListener を削除します。以前にリスナーが登録されていない場合、または listener が null の場合、例外はスローされず、何も処理は行われません。
    
    パラメータ:
    listener - 登録解除される IIOReadWarningListener。
    関連項目:
    addIIOReadWarningListener(javax.imageio.event.IIOReadWarningListener)
  - removeAllIIOReadWarningListeners
```
public void removeAllIIOReadWarningListeners()
```
    現在登録されているすべての IIOReadWarningListener オブジェクトを削除します。
    デフォルト実装では warningListeners と warningLocales インスタンスの変数を null に設定します。
  - addIIOReadProgressListener
```
public void addIIOReadProgressListener(IIOReadProgressListener listener)
```
    登録された進捗リスナーのリストに IIOReadProgressListener を追加します。listener が null の場合、例外はスローされず、何も処理は行われません。
    
    パラメータ:
    listener - 登録される IIOReadProgressListener。
    関連項目:
    removeIIOReadProgressListener(javax.imageio.event.IIOReadProgressListener)
  - removeIIOReadProgressListener
```
public void removeIIOReadProgressListener(IIOReadProgressListener listener)
```
    登録された進捗リスナーのリストから、IIOReadProgressListener を削除します。以前にリスナーが登録されていない場合、または listener が null の場合、例外はスローされず、何も処理は行われません。
    
    パラメータ:
    listener - 登録解除される IIOReadProgressListener。
    関連項目:
    addIIOReadProgressListener(javax.imageio.event.IIOReadProgressListener)
  - removeAllIIOReadProgressListeners
```
public void removeAllIIOReadProgressListeners()
```
    現在登録されているすべての IIOReadProgressListener オブジェクトを削除します。
    デフォルト実装では progressListeners インスタンスの変数を null に設定します。
  - addIIOReadUpdateListener
```
public void addIIOReadUpdateListener(IIOReadUpdateListener listener)
```
    IIOReadUpdateListener を、登録された更新リスナーのリストに追加します。listener が null の場合、例外はスローされず、何も処理は行われません。リスナーは、イメージとサムネールが復号化されるときに、プログレッシブパスの開始と終了を含むピクセルデータ更新の通知を受け取ります。
    更新リスナーが存在しない場合、読み取り側はデスティネーションイメージまたはサムネール、あるいはその両方のピクセルの更新を、より少なく実行するように選択できます。これにより、復号化がより効率的に行われるようになります。
    たとえば、プログレッシブ JPEG デコーディングでは、各パスに一連の係数の更新が含まれます。リスナーが存在する場合、これらの係数はピクセル値に変換され、各パスの RGB カラースペースに変換される必要があります。リスナーが存在しない場合、係数は単純に累積され、最終結果の変換と色の変換が一度だけ行われます。
    復号化の最終結果は、中間更新が実行されているかどうかに関係なく同じです。したがって、最終イメージだけが必要な場合は、IIOReadUpdateListener を登録しないほうが望ましい結果が得られます。一般的には、ローカル CPU の処理に比べて非常に遅いネットワーク接続を介してイメージを取得する場合は、プログレッシブな更新がもっとも効率的です。高速接続による場合は、プログレッシブな更新によりイメージの表示が実際には遅くなります。
    
    パラメータ:
    listener - 登録される IIOReadUpdateListener。
    関連項目:
    removeIIOReadUpdateListener(javax.imageio.event.IIOReadUpdateListener)
  - removeIIOReadUpdateListener
```
public void removeIIOReadUpdateListener(IIOReadUpdateListener listener)
```
    登録された更新リスナーのリストから、IIOReadUpdateListener を削除します。以前にリスナーが登録されていない場合、または listener が null の場合、例外はスローされず、何も処理は行われません。
    
    パラメータ:
    listener - 登録解除される IIOReadUpdateListener。
    関連項目:
    addIIOReadUpdateListener(javax.imageio.event.IIOReadUpdateListener)
  - removeAllIIOReadUpdateListeners
```
public void removeAllIIOReadUpdateListeners()
```
    現在登録されているすべての IIOReadUpdateListener オブジェクトを削除します。
    デフォルト実装では updateListeners インスタンスの変数を null に設定します。
  - processSequenceStarted
```
protected void processSequenceStarted(int minIndex)
```
    登録されたすべての IIOReadProgressListener に対し、その sequenceStarted メソッドを呼び出すことで、イメージ読み込みのシーケンスの開始を通知します。サブクラスは、必要に応じてこのメソッドを使用できます。
    
    パラメータ:
    minIndex - 読み取られた最小のインデックス。
  - processSequenceComplete
```
protected void processSequenceComplete()
```
    登録されたすべての IIOReadProgressListener に対し、その sequenceComplete メソッドを呼び出すことで、イメージ読み込みのシーケンスの完了を通知します。サブクラスは、必要に応じてこのメソッドを使用できます。
  - processImageStarted
```
protected void processImageStarted(int imageIndex)
```
    登録されたすべての IIOReadProgressListener に対し、その imageStarted メソッドを呼び出すことで、イメージ読み込みの開始を通知します。サブクラスは、必要に応じてこのメソッドを使用できます。
    
    パラメータ:
    imageIndex - 読み取られるイメージのインデックス。
  - processImageProgress
```
protected void processImageProgress(float percentageDone)
```
    登録されたすべての IIOReadProgressListener に対し、その imageProgress メソッドを呼び出すことで、イメージ完成の現在の割合を通知します。サブクラスは、必要に応じてこのメソッドを使用できます。
    
    パラメータ:
    percentageDone - float としての現在の完成した割合。
  - processImageComplete
```
protected void processImageComplete()
```
    登録されたすべての IIOReadProgressListener に対し、その imageComplete メソッドを呼び出すことで、イメージ読み込みの完了を通知します。サブクラスは、必要に応じてこのメソッドを使用できます。
  - processThumbnailStarted
```
protected void processThumbnailStarted(int imageIndex,
                           int thumbnailIndex)
```
    登録されたすべての IIOReadProgressListener に対し、その thumbnailStarted メソッドを呼び出すことで、サムネール読み込みの開始を通知します。サブクラスは、必要に応じてこのメソッドを使用できます。
    
    パラメータ:
    imageIndex - サムネールに関連付けられたイメージのインデックス。
    thumbnailIndex - サムネールのインデックス。
  - processThumbnailProgress
```
protected void processThumbnailProgress(float percentageDone)
```
    登録されたすべての IIOReadProgressListener に対し、その thumbnailProgress メソッドを呼び出すことで、サムネール完成の現在の割合を通知します。サブクラスは、必要に応じてこのメソッドを使用できます。
    
    パラメータ:
    percentageDone - float としての現在の完成した割合。
  - processThumbnailComplete
```
protected void processThumbnailComplete()
```
    登録されたすべての IIOReadProgressListener に対し、その thumbnailComplete メソッドを呼び出すことで、サムネール読み込みの完了を通知します。サブクラスは、必要に応じてこのメソッドを使用できます。
  - processReadAborted
```
protected void processReadAborted()
```
    readAborted メソッドを呼び出すことで、読み込みが中断されたことを、登録されたすべての IIOReadProgressListener に通知します。サブクラスは、必要に応じてこのメソッドを使用できます。
  - processPassStarted
```
protected void processPassStarted(BufferedImage theImage,
                      int pass,
                      int minPass,
                      int maxPass,
                      int minX,
                      int minY,
                      int periodX,
                      int periodY,
                      int[] bands)
```
    登録されたすべての IIOReadUpdateListener に対し、その passStarted メソッドを呼び出すことで、プログレッシブパスの開始を通知します。サブクラスは、必要に応じてこのメソッドを使用できます。
    
    パラメータ:
    theImage - 更新される BufferedImage。
    pass - 0 から始まる現在のパスのインデックス。
    minPass - 復号化される最初のパスのインデックス。
    maxPass - 復号化される最後のパスのインデックス。
    minX - パスに含まれる左上隅のピクセルの X 座標。
    minY - パスに含まれる左上隅のピクセルの X 座標。
    periodX - ピクセル間の水平方向の区切り。
    periodY - ピクセル間の垂直方向の区切り。
    bands - 影響を受けるデスティネーションバンドのセットを示す int の配列。
  - processImageUpdate
```
protected void processImageUpdate(BufferedImage theImage,
                      int minX,
                      int minY,
                      int width,
                      int height,
                      int periodX,
                      int periodY,
                      int[] bands)
```
    登録されたすべての IIOReadUpdateListener に対し、その imageUpdate メソッドを呼び出すことで、サンプルのセットの更新を通知します。サブクラスは、必要に応じてこのメソッドを使用できます。
    
    パラメータ:
    theImage - 更新される BufferedImage。
    minX - パスに含まれる左上隅のピクセルの X 座標。
    minY - パスに含まれる左上隅のピクセルの X 座標。
    width - periodX > 1 の場合にスキップされたピクセルを含む、更新された領域の幅の合計。
    height - periodY > 1 の場合にスキップされたピクセルを含む、更新された領域の高さの合計。
    periodX - ピクセル間の水平方向の区切り。
    periodY - ピクセル間の垂直方向の区切り。
    bands - 影響を受けるデスティネーションバンドのセットを示す int の配列。
  - processPassComplete
```
protected void processPassComplete(BufferedImage theImage)
```
    登録されたすべての IIOReadUpdateListener に対し、その passComplete メソッドを呼び出すことで、プログレッシブパスの終了を通知します。サブクラスは、必要に応じてこのメソッドを使用できます。
    
    パラメータ:
    theImage - 更新される BufferedImage。
  - processThumbnailPassStarted
```
protected void processThumbnailPassStarted(BufferedImage theThumbnail,
                               int pass,
                               int minPass,
                               int maxPass,
                               int minX,
                               int minY,
                               int periodX,
                               int periodY,
                               int[] bands)
```
    登録されたすべての IIOReadUpdateListener に対し、その thumbnailPassStarted メソッドを呼び出すことで、サムネールのプログレッシブパスの開始を通知します。サブクラスは、必要に応じてこのメソッドを使用できます。
    
    パラメータ:
    theThumbnail - 更新される BufferedImage サムネール。
    pass - 0 から始まる現在のパスのインデックス。
    minPass - 復号化される最初のパスのインデックス。
    maxPass - 復号化される最後のパスのインデックス。
    minX - パスに含まれる左上隅のピクセルの X 座標。
    minY - パスに含まれる左上隅のピクセルの X 座標。
    periodX - ピクセル間の水平方向の区切り。
    periodY - ピクセル間の垂直方向の区切り。
    bands - 影響を受けるデスティネーションバンドのセットを示す int の配列。
  - processThumbnailUpdate
```
protected void processThumbnailUpdate(BufferedImage theThumbnail,
                          int minX,
                          int minY,
                          int width,
                          int height,
                          int periodX,
                          int periodY,
                          int[] bands)
```
    登録されたすべての IIOReadUpdateListener に対し、その thumbnailUpdate メソッドを呼び出すことで、サムネールイメージのサンプルのセットの更新を通知します。サブクラスは、必要に応じてこのメソッドを使用できます。
    
    パラメータ:
    theThumbnail - 更新される BufferedImage サムネール。
    minX - パスに含まれる左上隅のピクセルの X 座標。
    minY - パスに含まれる左上隅のピクセルの X 座標。
    width - periodX > 1 の場合にスキップされたピクセルを含む、更新された領域の幅の合計。
    height - periodY > 1 の場合にスキップされたピクセルを含む、更新された領域の高さの合計。
    periodX - ピクセル間の水平方向の区切り。
    periodY - ピクセル間の垂直方向の区切り。
    bands - 影響を受けるデスティネーションバンドのセットを示す int の配列。
  - processThumbnailPassComplete
```
protected void processThumbnailPassComplete(BufferedImage theThumbnail)
```
    登録されたすべての IIOReadUpdateListener に対し、thumbnailPassComplete メソッドを呼び出すことで、サムネールのプログレッシブパスの終了を通知します。サブクラスは、必要に応じてこのメソッドを使用できます。
    
    パラメータ:
    theThumbnail - 更新される BufferedImage サムネール。
  - processWarningOccurred
```
protected void processWarningOccurred(String warning)
```
    warningOccurred メソッドを呼び出すことで、警告メッセージを、登録されたすべての IIOReadWarningListener に通知します。サブクラスは、必要に応じてこのメソッドを使用できます。
    
    パラメータ:
    warning - 送信する警告メッセージ。
    
    例外:
    
    IllegalArgumentException - warning が null の場合。
  - processWarningOccurred
```
protected void processWarningOccurred(String baseName,
                          String keyword)
```
    ResourceBundle から取得した文字列を持つ warningOccurred メソッドを呼び出すことで、ローカライズされた警告メッセージを、登録されたすべての IIOReadWarningListener に通知します。サブクラスは、必要に応じてこのメソッドを使用できます。
    
    パラメータ:
    baseName - ローカライズされた警告メッセージを含む ResourceBundle のセットのベース名。
    keyword - ResourceBundle 内の警告メッセージにインデックスを付けるために使用されるキーワード。
    
    例外:
    
    IllegalArgumentException - baseName が null の場合。
    
    IllegalArgumentException - keyword が null の場合。
    
    IllegalArgumentException - 適切な ResourceBundle が配置されない場合。
    
    IllegalArgumentException - 名前付きのリソースが配置された ResourceBundle で検出されない場合。
    
    IllegalArgumentException - ResourceBundle から取得したオブジェクトが String ではない場合。
  - reset
```
public void reset()
```
    ImageReader を初期状態に復元します。
    デフォルト実装は setInput(null, false)、setLocale(null)、removeAllIIOReadUpdateListeners()、removeAllIIOReadWarningListeners()、removeAllIIOReadProgressListeners()、および clearAbortRequest を呼び出します。
  - dispose
```
public void dispose()
```
    このオブジェクトが保持するすべてのリソースを解放できるようにします。このメソッドの呼び出しのあとに続く finalize 以外のほかのメソッドの呼び出しの結果は未定義です。
    アプリケーションは、この ImageReader が不要になった時点でこのメソッドを呼び出すことが重要です。そうしないと、読み取り側はリソース上に無期限に存在し続ける可能性があります。
    このメソッドのデフォルト実装は、スーパークラスでは何も実行しません。サブクラス実装で、すべてのリソース、特にネイティブリソースが解放されたことを確認してください。
  - getSourceRegion
```
protected static Rectangle getSourceRegion(ImageReadParam param,
                        int srcWidth,
                        int srcHeight)
```
    指定された ImageReadParam のソース領域とサブサンプリングの座標の設定を考慮して、読み取り側が読み取るソースイメージの領域を計算するために使用するユーティリティーメソッドです。実際のサブサンプリング係数、デスティネーションのサイズ、およびデスティネーションの座標は考慮されません。このため、さらにクリッピングが必要になります。computeRegions メソッドは必要なすべてのクリッピングを実行します。
    
    パラメータ:
    param - 使用された ImageReadParam、または null。
    srcWidth - ソースイメージの幅。
    srcHeight - ソースイメージの高さ。
    
    戻り値:
    Rectangle としてのソース領域。
  - computeRegions
```
protected static void computeRegions(ImageReadParam param,
                  int srcWidth,
                  int srcHeight,
                  BufferedImage image,
                  Rectangle srcRegion,
                  Rectangle destRegion)
```
    ソースイメージの幅と高さ、オプションのデスティネーションイメージ、およびオプションの ImageReadParam を考慮して、対象のソース領域および対象のデスティネーション領域を計算します。ソース領域は、全体のソースイメージから開始されます。ついで、ImageReadParam に指定されたソース領域 (指定されている場合) にクリップされます。
    デスティネーション座標のいずれかが負の場合、ソース領域はサブサンプリングを考慮して、左上がデスティネーションイメージの左上に一致するようにクリップされます。ついで、その結果がサブサンプリングおよびデスティネーション座標を考慮して、右および下のデスティネーションイメージ (指定されている場合) にクリップされます。
    同じように、デスティネーション領域がソースイメージから開始され、ImageReadParam に指定されたデスティネーション座標 (存在する場合) に変換され、最後にデスティネーションイメージ (存在する場合) にクリップされます。
    ソースまたはデスティネーション領域のいずれかが幅または高さ 0 で終わる場合、IllegalArgumentException がスローされます。
    ソースのクリッピングだけが必要な場合は getSourceRegion メソッドを使用します。
    
    パラメータ:
    param - ImageReadParam、または null。
    srcWidth - ソースイメージの幅。
    srcHeight - ソースイメージの高さ。
    image - デスティネーションイメージとなる BufferedImage、または null。
    srcRegion - 対象のソース領域が挿入される Rectangle。
    destRegion - 対象のデスティネーション領域が挿入される Rectangle。
    
    例外:
    
    IllegalArgumentException - srcRegion が null の場合。
    
    IllegalArgumentException - dstRegion が null の場合。
    
    IllegalArgumentException - 結果のソースまたはデスティネーションが空の場合。
  - checkReadParamBandSettings
```
protected static void checkReadParamBandSettings(ImageReadParam param,
                              int numSrcBands,
                              int numDstBands)
```
    ImageReadParam のソースおよびデスティネーションのバンド設定の有効性を判定するために、読み取り側が使用するユーティリティーメソッドです。このメソッドは、入力ストリームに存在するソースイメージのバンド数と書き込まれたデスティネーションイメージのバンド数の両方を、読み取り側が認識するとすぐに呼び出されます。
    メソッドは、getSourceBands と getDestinationBands メソッドを使用して、param からソースおよびデスティネーションバンドの設定の配列を取り出します。param が null の場合は、これらは null と見なします。ソースバンドの設定の配列が null の場合、配列 { 0, 1, ..., numSrcBands - 1 } と同等と見なします。デスティネーションバンドの設定の配列の場合も同様です。
    次に、メソッドは、両方の配列が長さが等しく、どの配列とも有効なバンドの最大のインデックスより大きい値を持っていないことを判定します。
    失敗すると、IllegalArgumentException がスローされ、成功するとそのままメソッドが返されます。
    
    パラメータ:
    param - イメージの読み込みに使用された ImageReadParam。
    numSrcBands - 入力ソースに存在するイメージのバンドの数。
    numDstBands - 書き込まれたデスティネーションイメージのバンドの数。
    
    例外:
    
    IllegalArgumentException - param が、ソースまたはデスティネーション、あるいはその両方のバンドのサブセットの無効な仕様を持つ場合。
  - getDestination
```
protected static BufferedImage getDestination(ImageReadParam param,
                           Iterator<ImageTypeSpecifier> imageTypes,
                           int width,
                           int height)
                                       throws IIOException
```
    復号化されたピクセルデータが書き込まれる BufferedImage を返します。イメージは、null 以外の場合、指定された ImageReadParam を確認することにより判定されます。getDestination メソッドが null 以外の値を返す場合は、単にそのイメージが返されます。それ以外の場合は、param.getDestinationType メソッドが呼び出されて、特定のイメージの型が指定されているかどうかを確認します。その場合には、imageTypes に含まれるものの 1 つと同じであることを確認してから、返された ImageTypeSpecifier が使用されます。
    param が null、または前述の手順がイメージあるいは ImageTypeSpecifier を発生させない場合、imageTypes パラメータから取得された最初の値が使用されます。通常、呼び出し側が imageTypes を getImageTypes(imageIndex) の値に設定します。
    次に、イメージの寸法が computeRegions の呼び出しによって決定されます。復号化されたイメージの実際の幅と高さが、width および height パラメータとして渡されます。
    
    パラメータ:
    param - デスティネーションイメージまたはイメージ型を取得するために使用する ImageReadParam、または null。
    imageTypes - 正当なイメージ型を示す ImageTypeSpecifier の Iterator。デフォルトが最初。
    width - 復号化が要求されるイメージまたはタイルの真の幅。
    height - 復号化が要求されるイメージまたはタイルの真の幅。
    
    戻り値:
    復号化されたピクセルデータが書き込まれる BufferedImage。
    
    例外:
    
    IIOException - param によって指定された ImageTypeSpecifier が imageTypes からの正当な型と一致しない場合。
    
    IllegalArgumentException - imageTypes が null または空の場合、または ImageTypeSpecifier が指定する型ではないオブジェクトを取り出した場合。
    
    IllegalArgumentException - 結果のイメージが 1 より小さい幅または高さを持つ場合。
    
    IllegalArgumentException - width と height の積が Integer.MAX_VALUE より大きい場合。

バグまたは機能を送信
詳細な API リファレンスおよび開発者ドキュメントについては、Java SE のドキュメントを参照してください。そのドキュメントには、概念的な概要、用語の定義、回避方法、有効なコード例などの、開発者を対象にしたより詳細な説明が含まれています。
Copyright © 1993, 2013, Oracle and/or its affiliates. All rights reserved.

クラス ImageReader

フィールドのサマリー

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

メソッドのサマリー

クラス java.lang.Object から継承されたメソッド

フィールドの詳細

originatingProvider

input

seekForwardOnly

ignoreMetadata

minIndex

availableLocales

locale

warningListeners

warningLocales

progressListeners

updateListeners

コンストラクタの詳細

ImageReader

メソッドの詳細

getFormatName

getOriginatingProvider

setInput

setInput

setInput

getInput

isSeekForwardOnly

isIgnoringMetadata

getMinIndex

getAvailableLocales

setLocale

getLocale

getNumImages

getWidth

getHeight

isRandomAccessEasy

getAspectRatio

getRawImageType

getImageTypes

getDefaultReadParam

getStreamMetadata

getStreamMetadata

getImageMetadata

getImageMetadata

read

read

readAll

readAll

canReadRaster

readRaster

isImageTiled

getTileWidth

getTileHeight

getTileGridXOffset

getTileGridYOffset

readTile

readTileRaster

readAsRenderedImage

readerSupportsThumbnails

hasThumbnails

getNumThumbnails

getThumbnailWidth

getThumbnailHeight

readThumbnail

abort

abortRequested

clearAbortRequest

addIIOReadWarningListener

removeIIOReadWarningListener

removeAllIIOReadWarningListeners

addIIOReadProgressListener

removeIIOReadProgressListener

removeAllIIOReadProgressListeners

addIIOReadUpdateListener

removeIIOReadUpdateListener

removeAllIIOReadUpdateListeners

processSequenceStarted

processSequenceComplete

processImageStarted

processImageProgress