ImageReader (Java Platform SE 8 )

java.lang.Object
- javax.imageio.ImageReader

```
public abstract class ImageReader
extends Object
```
解析和解码图像的一个抽象类。这个类必须被继承的类读取图像的java图像I / O框架下。
ImageReader对象通常由服务提供者接口（SPI）实例化为具体格式类。服务提供程序类（例如，实例ImageReaderSpi）与IIORegistry注册，以他们的格式识别和可用的格式的读者和作者介绍。

当输入源设置（使用setInput法），它可能被标记为“寻求”。此设置意味着输入源中包含的图像将只读取顺序，可能允许读者避免缓存包含先前已读取的图像的输入的数据的部分。

另请参见：

ImageWriter， IIORegistry， ImageReaderSpi

Field Summary

Fields
Modifier and Type	Field and Description
`protected Locale[]`	`availableLocales` 对 `Locale`s可定位报警信息的数组，或 `null`如果定位不支持。
`protected boolean`	`ignoreMetadata` `true`如果当前输入源已被标记为允许元数据被忽视的 `setInput`。
`protected Object`	`input` 的 `ImageInputStream`或其他 `Object`通过 `setInput`和检索 `getInput`。
`protected Locale`	`locale` 用于定位当前 `Locale`，或 `null`如果没有设置。
`protected int`	`minIndex` 阅读的最小有效索引，最初为0。
`protected ImageReaderSpi`	`originatingProvider` 的 `ImageReaderSpi`实例化该对象，或 `null`如果其身份尚不清楚或不存在。
`protected List<IIOReadProgressListener>`	`progressListeners` 一个 `List`目前注册 `IIOReadProgressListener`s，默认 `null`初始化，这是一个空 `List`同义。
`protected boolean`	`seekForwardOnly` `true`如果当前输入源已被标记为只允许正寻求通过 `setInput`。
`protected List<IIOReadUpdateListener>`	`updateListeners` 一个 `List`目前注册 `IIOReadUpdateListener`s，默认 `null`初始化，这是一个空 `List`同义。
`protected List<IIOReadWarningListener>`	`warningListeners` 一个 `List`目前注册 `IIOReadWarningListener`s，默认 `null`初始化，这是一个空 `List`同义。
`protected List<Locale>`	`warningLocales` 一个 `List`与每个目前注册 `IIOReadWarningListener`相关的 `Locale`s，默认 `null`初始化，这是一个空 `List`同义。

构造方法摘要

构造方法
Modifier	Constructor and Description
`protected`	`ImageReader(ImageReaderSpi originatingProvider)` 构建了一个 `ImageReader`和集提供的价值 `originatingProvider`场。

方法摘要

所有方法静态方法接口方法抽象方法具体的方法
Modifier and Type	Method and Description
`void`	`abort()` 请中止当前读取操作的请求。
`protected boolean`	`abortRequested()` 返回 `true`如果请求中止当前的读操作以来，读者被实例化或 `clearAbortRequest`叫了。
`void`	`addIIOReadProgressListener(IIOReadProgressListener listener)` 增加了一个 `IIOReadProgressListener`注册进展的侦听器列表。
`void`	`addIIOReadUpdateListener(IIOReadUpdateListener listener)` 增加了一个 `IIOReadUpdateListener`注册侦听器列表的更新。
`void`	`addIIOReadWarningListener(IIOReadWarningListener listener)` 增加了一个 `IIOReadWarningListener`来注册警告听众名单。
`boolean`	`canReadRaster()` 返回 `true`如果该插件支持阅读只是一个 `Raster`像素数据。
`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`s可以用来定位警告听众和压缩设置数组。
`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)` 返回一个 `Iterator`可能包含图像类型的图像可以解码，在 `ImageTypeSpecifiers`s形式。
`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)` 返回一个 `ImageTypeSpecifier`指示 `SampleModel`和 `ColorModel`最密切代表的形象”的原“内部格式。
`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()` 返回 `true`如果当前输入源已被标记为允许将元数据通过 `true`为 `ignoreMetadata`争论的 `setInput`方法忽略。
`boolean`	`isImageTiled(int imageIndex)` 返回 `true`如果图像组织成瓷砖，即大小相等的非重叠的矩形。
`boolean`	`isRandomAccessEasy(int imageIndex)` 返回 `true`如果给定图像的地方，随机存取的存储格式，像素没有内在的障碍。
`boolean`	`isSeekForwardOnly()` 返回 `true`如果当前输入源已被标记为寻求 `true`只有通过对 `setInput` `seekForwardOnly`论证方法。
`protected void`	`processImageComplete()` 广播的图像完成阅读所有注册 `IIOReadProgressListener`s调用 `imageComplete`方法。
`protected void`	`processImageProgress(float percentageDone)` 广播的图像完成当前占所有注册 `IIOReadProgressListener`s调用 `imageProgress`方法。
`protected void`	`processImageStarted(int imageIndex)` 广播的图像开始阅读所有注册 `IIOReadProgressListener`s调用 `imageStarted`方法。
`protected void`	`processImageUpdate(BufferedImage theImage, int minX, int minY, int width, int height, int periodX, int periodY, int[] bands)` 广播的一组样本的所有注册 `IIOReadUpdateListener`s调用 `imageUpdate`方法的更新。
`protected void`	`processPassComplete(BufferedImage theImage)` 广播的一个渐进的通过所有注册 `IIOReadUpdateListener`s调用 `passComplete`方法结束。
`protected void`	`processPassStarted(BufferedImage theImage, int pass, int minPass, int maxPass, int minX, int minY, int periodX, int periodY, int[] bands)` 广播开始逐步通过对所有已注册的 `IIOReadUpdateListener`s调用 `passStarted`方法。
`protected void`	`processReadAborted()` 广播，读已中止所有注册 `IIOReadProgressListener`s调用 `readAborted`方法。
`protected void`	`processSequenceComplete()` 播放图像序列完成读取所有已注册的 `IIOReadProgressListener`s调用 `sequenceComplete`方法。
`protected void`	`processSequenceStarted(int minIndex)` 播放图像序列的开始读所有的注册 `IIOReadProgressListener`s调用 `sequenceStarted`方法。
`protected void`	`processThumbnailComplete()` 广播一个缩略图完成阅读所有的注册 `IIOReadProgressListener`s调用 `thumbnailComplete`方法。
`protected void`	`processThumbnailPassComplete(BufferedImage theThumbnail)` 广播给所有的缩略图进行注册 `IIOReadUpdateListener`s调用 `thumbnailPassComplete`方法结束。
`protected void`	`processThumbnailPassStarted(BufferedImage theThumbnail, int pass, int minPass, int maxPass, int minX, int minY, int periodX, int periodY, int[] bands)` 播放缩略图逐步通过开始所有注册 `IIOReadUpdateListener`s调用 `thumbnailPassStarted`方法。
`protected void`	`processThumbnailProgress(float percentageDone)` 播放缩略图完成当前占所有注册 `IIOReadProgressListener`s调用 `thumbnailProgress`方法。
`protected void`	`processThumbnailStarted(int imageIndex, int thumbnailIndex)` 广播一个缩略图开始阅读所有的注册 `IIOReadProgressListener`s调用 `thumbnailStarted`方法。
`protected void`	`processThumbnailUpdate(BufferedImage theThumbnail, int minX, int minY, int width, int height, int periodX, int periodY, int[] bands)` 广播一组样品中的缩略图，所有注册 `IIOReadUpdateListener`s调用 `thumbnailUpdate`方法的更新。
`protected void`	`processWarningOccurred(String warning)` 广播警告所有注册 `IIOReadWarningListener`s调用 `warningOccurred`方法。
`protected void`	`processWarningOccurred(String baseName, String keyword)` 广播本地化警告所有注册 `IIOReadWarningListener`s通过用来自 `ResourceBundle`字符串调用他们的 `warningOccurred`方法。
`BufferedImage`	`read(int imageIndex)` 读取图像索引的 `imageIndex`返回为一个完整的 `BufferedImage`，使用默认 `ImageReadParam`。
`abstract BufferedImage`	`read(int imageIndex, ImageReadParam param)` 读取图像索引的 `imageIndex`返回为一个完整的 `BufferedImage`，使用提供的 `ImageReadParam`。
`IIOImage`	`readAll(int imageIndex, ImageReadParam param)` 读取图像索引的 `imageIndex`并返回一个 `IIOImage`包含图像、缩略图和相关的图像元数据，使用提供的 `ImageReadParam`。
`Iterator<IIOImage>`	`readAll(Iterator<? extends ImageReadParam> params)` 返回一个包含所有的 `Iterator`图像缩略图，和元数据，从 `getMinIndex`给出的指标，在 `IIOImage`对象形式的输入源。
`RenderedImage`	`readAsRenderedImage(int imageIndex, ImageReadParam param)` 返回一个 `RenderedImage`对象包含的图像索引的 `imageIndex`内容。
`boolean`	`readerSupportsThumbnails()` 返回 `true`如果图像格式的理解这本书支持缩略图预览图像与它相关联的。
`Raster`	`readRaster(int imageIndex, ImageReadParam param)` 返回一个新的图像流中包含的原始像素数据 `Raster`对象，没有任何色彩的转换应用。
`BufferedImage`	`readThumbnail(int imageIndex, int thumbnailIndex)` 返回缩略图预览图像索引的 `thumbnailIndex`，与图像索引的 `ImageIndex`作为 `BufferedImage`相关。
`BufferedImage`	`readTile(int imageIndex, int tileX, int tileY)` 读的 `tileX`和 `tileY`实参的瓦，还为 `BufferedImage`。
`Raster`	`readTileRaster(int imageIndex, int tileX, int tileY)` 返回一个新的瓷砖含有原始像素数据 `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`。

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - originatingProvider
```
protected ImageReaderSpi originatingProvider
```
    的 ImageReaderSpi实例化该对象，或 null如果其身份尚不清楚或不存在。默认情况下，它被初始化为 null。
  - input
```
protected Object input
```
    的 ImageInputStream或其他 Object通过 setInput和检索 getInput。默认情况下，它被初始化为 null。
  - seekForwardOnly
```
protected boolean seekForwardOnly
```
    true如果当前输入源已被标记为只允许正寻求通过 setInput。默认情况下，该值是 false。
    
    另请参见：
    
    minIndex， setInput(java.lang.Object, boolean, boolean)
  - ignoreMetadata
```
protected boolean ignoreMetadata
```
    true如果当前输入源已被标记为允许元数据被忽视的 setInput。默认情况下，该值是 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
```
    对 Locales可定位报警信息的数组，或 null如果定位不支持。
  - locale
```
protected Locale locale
```
    用于定位当前 Locale，或 null如果没有设置。
  - warningListeners
```
protected List<IIOReadWarningListener> warningListeners
```
    一个 List目前注册 IIOReadWarningListeners，默认 null初始化，这是一个空 List同义。
  - warningLocales
```
protected List<Locale> warningLocales
```
    一个 List与每个目前注册 IIOReadWarningListener相关的 Locales，默认 null初始化，这是一个空 List同义。
  - progressListeners
```
protected List<IIOReadProgressListener> progressListeners
```
    一个 List目前注册 IIOReadProgressListeners，默认 null初始化，这是一个空 List同义。
  - updateListeners
```
protected List<IIOReadUpdateListener> updateListeners
```
    一个 List目前注册 IIOReadUpdateListeners，默认 null初始化，这是一个空 List同义。
- Constructor Detail
  - 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是真的，然后一个电话read(index)如果index < this.minIndex抛出IndexOutOfBoundsException；否则，minIndex的值将被设置为index。如果seekForwardOnly是false，minIndex的价值将保持0无论任何读操作。
    
    的ignoreMetadata参数，如果设置为true，让读者在阅读时忽略任何元数据。随后调用的getStreamMetadata和getImageMetadata方法可以返回null，和IIOImage返回readAll可能返回null从getMetadata方法。设置此参数可以让读者更有效地工作。读者可能会选择忽略此设置并返回元数据。
    
    子类应小心删除基于上一流的任何缓存信息，如头信息或部分解码的图像数据。
    
    使用一个通用Object以外的ImageInputStream供读者直接与捕获装置和成像协议。法律类集合是由读者的服务提供商的getInputTypes方法广告；大多数读者会返回一个单一的元素的数组只包含ImageInputStream.class表示，他们只接受ImageInputStream。
    
    默认的实现检查input反对返回的列表originatingProvider.getInputTypes()失败如果参数不是列表中某类的一个实例。如果源提供者将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是真的，然后一个电话read(index)如果index < this.minIndex抛出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()
```
    返回 true如果当前输入源已被标记为寻求只有通过 true为 seekForwardOnly争论的 setInput方法。
    
    结果
    
    true如果输入源是寻求唯一。
    
    另请参见：
    
    setInput(java.lang.Object, boolean, boolean)
  - isIgnoringMetadata
```
public boolean isIgnoringMetadata()
```
    返回 true如果当前输入源已被标记为允许将元数据通过 true为 ignoreMetadata争论的 setInput方法忽略。
    
    结果
    
    true如果元数据可以忽略。
    
    另请参见：
    
    setInput(java.lang.Object, boolean, boolean)
  - getMinIndex
```
public int getMinIndex()
```
    返回读取图像、缩略图或图像元数据的最低有效索引。如果 seekForwardOnly()是 false，这个值通常是0，表明随机访问是可能的。否则，它将包含最近访问的索引的值，并增加一个单调的方式。
    
    结果
    
    阅读的最低法律指标。
  - getAvailableLocales
```
public Locale[] getAvailableLocales()
```
    返回 Locales可以用来定位警告听众和压缩设置数组。一个 null返回值表明定位不支持。
    如果是non-null默认实现将返回的availableLocales实例变量的一个克隆，否则返回null。
    
    结果
    
    对 Locales可以作为论据来 setLocale数组，或 null。
  - setLocale
```
public void setLocale(Locale locale)
```
    设置为给定值这 ImageReader当前 Locale。一个价值 null删除任何以前的设置，指出读者应该定位在它认为合适的。
    
    参数
    
    locale -所需的 Locale，或 null。
    
    异常
    
    IllegalArgumentException -如果 locale是非 null但不在返回的值 getAvailableLocales。
    
    另请参见：
    
    getLocale()
  - getLocale
```
public Locale getLocale()
```
    返回当前设置 Locale，或 null如果没有设置。
    
    结果
    
    目前 Locale，或 null。
    
    另请参见：
    
    setLocale(java.util.Locale)
  - getNumImages
```
public abstract int getNumImages(boolean allowSearch)
                          throws IOException
```
    返回图像的数量，不包括缩略图，可以从当前输入源。
    值得注意的是，一些图像格式（如GIF动画）不指定多个图像流中存在。因此，确定图像的数量将需要整个流进行扫描，并可能需要用于缓冲的内存。如果图像是按顺序处理的，它可能会更有效，只是随着指数直到IndexOutOfBoundsException是抛出没有更多的图像可用电话read。的allowSearch参数可以设置为false表明穷举搜索是不需要的；返回值是-1表明搜索是必要的。如果输入了指定seekForwardOnly设置true，该方法抛出一个IllegalStateException如果allowSearch设置true。
    
    参数
    
    allowSearch -如果 true，图像的真实数量将即使搜索要求返回。如果 false，读者可能会返回 -1不进行搜索。
    
    结果
    
    图像中的数字，作为一个 int，或 -1如果 allowSearch是 false和搜索将需要。
    
    异常
    
    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），随机将可能对瓷砖是合理有效的。看到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
```
    返回一个 ImageTypeSpecifier指示 SampleModel和 ColorModel最密切代表的形象”的原“内部格式。例如，对于一个JPEG图像的原始类型可能有YCbCr颜色空间，即使图像通常被转化为RGB颜色空间，在显示之前。返回值也应列入名单 getImageTypes
    默认的实现是返回从提供的列表中的第一个条目getImageType。
    返回的值。
    
    参数
    
    imageIndex -图像要查询的索引。
    
    结果
    
    一个 ImageTypeSpecifier。
    
    异常
    
    IllegalStateException -如果输入源尚未确定。
    
    IndexOutOfBoundsException -如果提供的索引越界。
    
    IOException -如果出现错误，从输入源读取的格式信息。
  - getImageTypes
```
public abstract Iterator<ImageTypeSpecifier> getImageTypes(int imageIndex)
                                                    throws IOException
```
    返回一个 Iterator可能包含图像类型的图像可以解码，在 ImageTypeSpecifierss形式。至少有一个合法的图像类型将被返回。
    迭代器的第一个元素应该是最“自然”的类型，用于对图像进行解码，尽可能少的损失。例如，对于一个JPEG图像的第一项应该是RGB图像，虽然图像数据存储在内部在YCbCr色彩空间。
    
    参数
    
    imageIndex -图像是 retrieved指数。
    
    结果
    
    一个 Iterator包含代表建议类型的图像解码电流给定图像的至少一个 ImageTypeSpecifier。
    
    异常
    
    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。
    
    异常
    
    如果是 null formatName IllegalArgumentException。
    
    如果是 null nodeNames IllegalArgumentException。
    
    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 -如果提供的索引越界。
    
    如果是 null formatName IllegalArgumentException。
    
    如果是 null nodeNames IllegalArgumentException。
    
    IOException -如果在阅读过程中出现错误。
  - read
```
public BufferedImage read(int imageIndex)
                   throws IOException
```
    读取图像索引的 imageIndex返回为一个完整的 BufferedImage，使用默认 ImageReadParam。这是一个方便的方法，称 read(imageIndex, null)。
    返回的图像将根据第一ImageTypeSpecifier返回getImageTypes格式化。
    
    任何注册IIOReadProgressListener对象将调用imageStarted方法通知，随后拨打其imageProgress方法作为阅读的进展。最后他们imageComplete方法会被调用。IIOReadUpdateListener对象可以被更新，有时在读像素解码。最后，IIOReadWarningListener对象将接受任何非致命警告在解码过程中发生的通知。
    
    参数
    
    imageIndex -图像检索索引。
    
    结果
    
    所需的部分的图像作为一个 BufferedImage。
    
    异常
    
    IllegalStateException -如果输入源尚未确定。
    
    IndexOutOfBoundsException -如果提供的索引越界。
    
    IOException -如果在阅读过程中出现错误。
  - read
```
public abstract BufferedImage read(int imageIndex,
                                   ImageReadParam param)
                            throws IOException
```
    读取图像索引的 imageIndex返回为一个完整的 BufferedImage，使用提供的 ImageReadParam。
    实际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并返回一个 IIOImage包含图像、缩略图和相关的图像元数据，使用提供的 ImageReadParam。
    实际BufferedImage IIOImage返回的引用将被选择使用的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
```
    返回一个包含所有的 Iterator图像缩略图，和元数据，从 getMinIndex给出的指标，在 IIOImage对象形式的输入源。提供一 Iterator含 ImageReadParam对象；一部分是为每个图像从输入源消耗，直到没有更多的图像可。如果读取参数 Iterator跑出来的元素，但仍有更多的图像可以从输入源，默认读取参数用于其余的图像。
    如果params是null，默认读取参数将被用于所有的图像。
    
    实际BufferedImage IIOImage返回的引用将被选择使用的getDestination方法定义的算法。
    
    任何注册IIOReadProgressListener对象将调用sequenceStarted方法一旦被通知。然后，为每个图像解码，会有一个叫imageStarted，其次是电话imageProgress作为阅读的进展，最后imageComplete，sequenceComplete方法将在最后的图像已经被解码为。IIOReadUpdateListener对象可以被更新，有时在读像素解码。最后，IIOReadWarningListener对象将接受任何非致命警告在解码过程中发生的通知。
    
    这套源带读和写的目的带上提供的ImageReadParam调用getSourceBands和getDestinationBands确定。如果阵列的长度由这些方法不同，源带集包含一个指数较大，可用最大来源索引，或者目的条带集包含一个指数大比最大的法律目的索引，一个IllegalArgumentException抛出。
    
    缩略图则会在整体上不分区域设置。
    
    如果提供的ImageReadParams包含可选的设置值的读者不支持（例如源渲染尺寸或任何特定格式的设置），他们将被忽略。
    
    参数
    
    params - Iterator含 ImageReadParam对象。
    
    结果
    
    代表输入源的内容作为一个 Iterator IIOImages。
    
    异常
    
    IllegalStateException -如果输入源尚未确定。
    
    IllegalArgumentException -如果任何非- params null元不是一个 ImageReadParam。
    
    IllegalArgumentException -如果设置源和目的带 param.getSourceBands和 param.getDestinationBands指定的长度不同或有指标，出界。
    
    IllegalArgumentException如果得到的图像会有一个宽度或高度小于1。
    
    IOException -如果在阅读过程中出现错误。
    
    另请参见：
    
    ImageReadParam， IIOImage
  - canReadRaster
```
public boolean canReadRaster()
```
    返回 true如果该插件支持阅读只是一个 Raster像素数据。如果此方法返回 false，调用 readRaster或 readTileRaster将抛出一个 UnsupportedOperationException。
    默认的实现返回false。
    
    结果
    
    true如果该插件支持阅读原 Rasters。
    
    另请参见：
    
    readRaster(int, javax.imageio.ImageReadParam)， readTileRaster(int, int, int)
  - readRaster
```
public Raster readRaster(int imageIndex,
                         ImageReadParam param)
                  throws IOException
```
    返回一个新的图像流中包含的原始像素数据 Raster对象，没有任何色彩的转换应用。应用程序必须确定如何通过其他方法来解释像素数据。在提供的 ImageReadParam对象的任何目的地或图像类型参数被忽略，但所有其他参数使用完全在 read方法，除了任何目的地偏移作为逻辑的而不是物理偏移。返回的 Raster大小会对源区夹到实际图像。流中的逻辑偏移量将被忽略。
    这种方法允许的格式，通常采用一种颜色转换，如JPEG格式，通常没有相关的色彩，如遥感、医学影像数据，提供原始像素数据。
    
    任何注册readUpdateListeners被忽略，因为没有BufferedImage，但是其他所有的听众都说他们对read方法。
    
    如果canReadRaster()返回false，该方法抛出一个UnsupportedOperationException。
    
    如果提供的ImageReadParam包含可选的设置值的读者不支持（例如源渲染尺寸或任何特定格式的设置），他们将被忽略。
    
    默认实现将抛出一个UnsupportedOperationException。
    
    参数
    
    imageIndex -图像读入索引。
    
    param -一个用于控制阅读过程 ImageReadParam，或 null。
    
    结果
    
    所需的部分的图像作为一个 Raster。
    
    异常
    
    UnsupportedOperationException -如果这个插件不支持读取原 Rasters。
    
    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被。
    这种方法仅仅是一种方便，相当于一个读参数指定具有抵消tileX*getTileWidth(imageIndex)源区称read(int, ImageReadParam)，tileY*getTileHeight(imageIndex)和宽度和高度getTileWidth(imageIndex)，getTileHeight(imageIndex)；抽样因素1和偏移0。对样本的瓷砖，打一个读取参数指定这个区域和不同的采样参数read。
    
    如果tileX和tileY 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
```
    返回一个新的瓷砖含有原始像素数据 Raster对象，没有任何色彩的转换应用。应用程序必须确定如何通过其他方法来解释像素数据。
    如果canReadRaster()返回false，该方法抛出一个UnsupportedOperationException。
    
    默认的实现检查阅读Rasters是支持的，如果这样的电话readRaster(imageIndex, null)如果tileX和tileY 0，或抛出一个IllegalArgumentException否则。
    
    参数
    
    imageIndex -图像检索索引。
    
    tileX的列的索引（从0开始）的瓷砖要检索。
    
    tileY的行的索引（从0开始）的瓷砖要检索。
    
    结果
    
    瓷砖作为 Raster。
    
    异常
    
    UnsupportedOperationException -如果这个插件不支持读取原 Rasters。
    
    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
```
    返回一个 RenderedImage对象包含的图像索引的 imageIndex内容。默认情况下，返回的图像仅仅是 BufferedImage返回 read(imageIndex, param)。
    这种方法的语义可能不同于在几个方面的其他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）， false将返回无论输入源已定或是 imageIndex是界限。
    如果getNumThumbnails返回一个大于0的值默认实现将返回true。
    
    参数
    
    imageIndex -图像被查询的索引。
    
    结果
    
    true如果给定的图像缩略图。
    
    异常
    
    IllegalStateException -如果读者支持缩略图，但输入源尚未确定。
    
    IndexOutOfBoundsException -如果读者支持缩略图，但 imageIndex出界。
    
    IOException -如果在阅读过程中出现错误。
  - getNumThumbnails
```
public int getNumThumbnails(int imageIndex)
                     throws IOException
```
    返回与给定图像相关联的缩略图预览图像的数量。如果格式不支持缩略图，（ readerSupportsThumbnails返回 false）， 0将返回无论输入源已定或是 imageIndex是界限。
    默认实现返回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，与图像索引的 ImageIndex作为 BufferedImage相关。
    任何注册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()
```
    返回 true如果请求中止当前的读操作以来，读者被实例化或 clearAbortRequest叫了。
    
    结果
    
    true如果当前读操作应中止。
    
    另请参见：
    
    abort()， clearAbortRequest()
  - clearAbortRequest
```
protected void clearAbortRequest()
```
    清除任何以前的中止请求。在这个方法被调用时，将返回 false abortRequested。
    
    另请参见：
    
    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颜色空间，每次如果听众是。如果没有侦听器，则该系数可以简单地累积，并将最终结果转换和颜色转换一次。
    
    解码的最终结果将是相同的，是否进行中间更新。因此，如果最终的图像所需的可能最好不登记任何IIOReadUpdateListeners。一般来说，逐步更新时是最有效的获取图像在一个网络连接，是很慢的本地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)
```
    播放图像序列的开始读所有的注册 IIOReadProgressListeners调用 sequenceStarted方法。子类可以使用这个方法作为一个方便。
    
    参数
    
    minIndex -指数最低被阅读。
  - processSequenceComplete
```
protected void processSequenceComplete()
```
    播放图像序列完成读取所有已注册的 IIOReadProgressListeners调用 sequenceComplete方法。子类可以使用这个方法作为一个方便。
  - processImageStarted
```
protected void processImageStarted(int imageIndex)
```
    广播的图像开始阅读所有注册 IIOReadProgressListeners调用 imageStarted方法。子类可以使用这个方法作为一个方便。
    
    参数
    
    imageIndex -索引的图像被读取。
  - processImageProgress
```
protected void processImageProgress(float percentageDone)
```
    广播的图像完成当前占所有注册 IIOReadProgressListeners调用 imageProgress方法。子类可以使用这个方法作为一个方便。
    
    参数
    
    percentageDone -完成电流的百分比，作为一个 float。
  - processImageComplete
```
protected void processImageComplete()
```
    广播的图像完成阅读所有注册 IIOReadProgressListeners调用 imageComplete方法。子类可以使用这个方法作为一个方便。
  - processThumbnailStarted
```
protected void processThumbnailStarted(int imageIndex,
                                       int thumbnailIndex)
```
    广播一个缩略图开始阅读所有的注册 IIOReadProgressListeners调用 thumbnailStarted方法。子类可以使用这个方法作为一个方便。
    
    参数
    
    imageIndex -与缩略图相关的图像的索引。
    
    thumbnailIndex -缩略图索引。
  - processThumbnailProgress
```
protected void processThumbnailProgress(float percentageDone)
```
    播放缩略图完成当前占所有注册 IIOReadProgressListeners调用 thumbnailProgress方法。子类可以使用这个方法作为一个方便。
    
    参数
    
    percentageDone -完成电流的百分比，作为一个 float。
  - processThumbnailComplete
```
protected void processThumbnailComplete()
```
    广播一个缩略图完成阅读所有的注册 IIOReadProgressListeners调用 thumbnailComplete方法。子类可以使用这个方法作为一个方便。
  - processReadAborted
```
protected void processReadAborted()
```
    广播，读已中止所有注册 IIOReadProgressListeners调用 readAborted方法。子类可以使用这个方法作为一个方便。
  - processPassStarted
```
protected void processPassStarted(BufferedImage theImage,
                                  int pass,
                                  int minPass,
                                  int maxPass,
                                  int minX,
                                  int minY,
                                  int periodX,
                                  int periodY,
                                  int[] bands)
```
    广播开始逐步通过对所有已注册的 IIOReadUpdateListeners调用 passStarted方法。子类可以使用这个方法作为一个方便。
    
    参数
    
    theImage - BufferedImage更新。
    
    pass ---电流通过索引从0开始。
    
    minPass -第一关，将解码后的指标。
    
    maxPass -将被解码的最后通过指数。
    
    minX -包括在通过左上角的像素坐标。
    
    minY -包括在通过左上角的像素坐标。
    
    periodX -像素点之间的水平间隔。
    
    periodY -像素之间的垂直分离。
    
    bands - ints指示目的地的影响带的设置一个数组。
  - processImageUpdate
```
protected void processImageUpdate(BufferedImage theImage,
                                  int minX,
                                  int minY,
                                  int width,
                                  int height,
                                  int periodX,
                                  int periodY,
                                  int[] bands)
```
    广播的一组样本的所有注册 IIOReadUpdateListeners调用 imageUpdate方法的更新。子类可以使用这个方法作为一个方便。
    
    参数
    
    theImage - BufferedImage更新。
    
    minX -包括在通过左上角的像素坐标。
    
    minY -包括在通过左上角的像素坐标。
    
    width -总宽度的区域被更新，包括像素被跳过，如果 periodX > 1。
    
    height -总高度的区域被更新，包括像素被跳过，如果 periodY > 1。
    
    periodX -像素点之间的水平间隔。
    
    periodY -像素之间的垂直分离。
    
    bands - ints指示目的地的影响带的设置一个数组。
  - processPassComplete
```
protected void processPassComplete(BufferedImage theImage)
```
    广播的一个渐进的通过所有注册 IIOReadUpdateListeners调用 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)
```
    播放缩略图逐步通过开始所有注册 IIOReadUpdateListeners调用 thumbnailPassStarted方法。子类可以使用这个方法作为一个方便。
    
    参数
    
    theThumbnail - BufferedImage缩略图更新。
    
    pass ---电流通过索引从0开始。
    
    minPass -第一关，将解码后的指标。
    
    maxPass -将被解码的最后通过指数。
    
    minX -包括在通过左上角的像素坐标。
    
    minY -包括在通过左上角的像素坐标。
    
    periodX -像素点之间的水平间隔。
    
    periodY -像素之间的垂直分离。
    
    bands - ints指示目的地的影响带的设置一个数组。
  - processThumbnailUpdate
```
protected void processThumbnailUpdate(BufferedImage theThumbnail,
                                      int minX,
                                      int minY,
                                      int width,
                                      int height,
                                      int periodX,
                                      int periodY,
                                      int[] bands)
```
    广播一组样品中的缩略图，所有注册 IIOReadUpdateListeners调用 thumbnailUpdate方法的更新。子类可以使用这个方法作为一个方便。
    
    参数
    
    theThumbnail - BufferedImage缩略图更新。
    
    minX -包括在通过左上角的像素坐标。
    
    minY -包括在通过左上角的像素坐标。
    
    width -总宽度的区域被更新，包括像素被跳过，如果 periodX > 1。
    
    height -区域总高度更新，包括像素被跳过，如果 periodY > 1。
    
    periodX -像素点之间的水平间隔。
    
    periodY -像素之间的垂直分离。
    
    bands - ints指示目的地的影响带的设置一个数组。
  - processThumbnailPassComplete
```
protected void processThumbnailPassComplete(BufferedImage theThumbnail)
```
    广播给所有的缩略图进行注册 IIOReadUpdateListeners调用 thumbnailPassComplete方法结束。子类可以使用这个方法作为一个方便。
    
    参数
    
    theThumbnail - BufferedImage缩略图更新。
  - processWarningOccurred
```
protected void processWarningOccurred(String warning)
```
    广播警告所有注册 IIOReadWarningListeners调用 warningOccurred方法。子类可以使用这个方法作为一个方便。
    
    参数
    
    warning -警告消息发送。
    
    异常
    
    如果是 null warning IllegalArgumentException。
  - processWarningOccurred
```
protected void processWarningOccurred(String baseName,
                                      String keyword)
```
    广播本地化警告所有注册 IIOReadWarningListeners通过用来自 ResourceBundle字符串调用他们的 warningOccurred方法。子类可以使用这个方法作为一个方便。
    
    参数
    
    baseName -一套包含本地化的警告消息 ResourceBundles基名称。
    
    keyword用于索引的警告消息在 ResourceBundles设定关键字。
    
    异常
    
    如果是 null baseName IllegalArgumentException。
    
    如果是 null keyword IllegalArgumentException。
    
    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将充满兴趣的目的区域。
    
    异常
    
    如果是 null srcRegion IllegalArgumentException。
    
    如果是 null dstRegion IllegalArgumentException。
    
    IllegalArgumentException -如果得到的源或目标区域是空的。
  - checkReadParamBandSettings
```
protected static void checkReadParamBandSettings(ImageReadParam param,
                                                 int numSrcBands,
                                                 int numDstBands)
```
    一个实用的方法，可用于读者测试源和目的地的 ImageReadParam带设置的有效性。此方法可以被调用，只要读者知道源图像的频带的数目，因为它存在于输入流中，并被写入的目标图像的频带的数目。
    方法检索的源和目的带设置数组参数使用getSourceBands和getDestinationBandsmethods（或认为他们是null如果param是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，解码的像素数据应写。图像是通过检查所提供的 ImageReadParam如果是非 null确定；如果其 getDestination方法返回一个非 null值，图像是简单地返回。否则， param.getDestinationType方法来确定是否一个特定的图像类型已被指定。如果是这样的话，返回的 ImageTypeSpecifier用于检查后说，这等于那些包含在 imageTypes。
    如果param是null或以上步骤没有取得一个图像或ImageTypeSpecifier，用于从imageTypes参数获得的第一个值。通常情况下，调用者将imageTypes到getImageTypes(imageIndex)价值。
    
    其次，图像的尺寸是由一种叫决心computeRegions。该图像被解码的实际宽度和高度都是通过为width和height参数。
    
    参数
    
    param - ImageReadParam用来得到目标图像或图像的形式，或 null。
    
    imageTypes - ImageTypeSpecifiers指示法律图像类型 Iterator，与默认的第一。
    
    width -图像或瓷砖的真实宽度开始解码。
    
    height -图像或瓷砖被解码的真实宽度。
    
    结果
    
    它的 BufferedImage解码的像素数据应写。
    
    异常
    
    IIOException -如果指定 param的 ImageTypeSpecifier不匹配的任何法律的 imageTypes。
    
    IllegalArgumentException -如果 imageTypes是 null或空的，或如果一个对象不 ImageTypeSpecifier型检索从它。
    
    IllegalArgumentException -如果得到的图像会有一个宽度或高度小于1。
    
    IllegalArgumentException -如果 width和 height产品大于 Integer.MAX_VALUE。

Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2014, Oracle and/or its affiliates. All rights reserved.

Class ImageReader

Field Summary

构造方法摘要

方法摘要

Methods inherited from class java.lang.Object

Field Detail

originatingProvider

input

seekForwardOnly

ignoreMetadata

minIndex

availableLocales

locale

warningListeners

warningLocales

progressListeners

updateListeners

Constructor Detail

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