ImageWriter (Java Platform SE 8 )

java.lang.Object
- javax.imageio.ImageWriter

All Implemented Interfaces:

ImageTranscoder
```
public abstract class ImageWriter
extends Object
implements ImageTranscoder
```
一个抽象类编码和文字的图像。这个类必须被继承的类写出来的图像在图像的java I/O框架下。
ImageWriter实例化对象通常是由服务提供者类特定格式。服务提供程序类与IIORegistry注册，以他们的格式识别和可用的格式的读者和作者介绍。

另请参见：

ImageReader， ImageWriteParam， IIORegistry， ImageWriterSpi

Field Summary

Fields
Modifier and Type	Field and Description
`protected Locale[]`	`availableLocales` 一系列的 `Locale`s可以用来定位报警信息和压缩设置值，或 `null`如果定位不支持。
`protected Locale`	`locale` 用于定位当前 `Locale`，或 `null`如果没有设置。
`protected ImageWriterSpi`	`originatingProvider` 的 `ImageWriterSpi`实例化该对象，或 `null`如果其身份尚不清楚或不存在。
`protected Object`	`output` 的 `ImageOutputStream`或其他 `Object`由 `setOutput`和检索 `getOutput`。
`protected List<IIOWriteProgressListener>`	`progressListeners` 一个 `List`目前注册 `IIOWriteProgressListener`s，默认情况下 `null`初始化，这是一个空 `List`同义。
`protected List<IIOWriteWarningListener>`	`warningListeners` 一个 `List`目前注册 `IIOWriteWarningListener`s，默认 `null`初始化，这是一个空 `List`同义。
`protected List<Locale>`	`warningLocales` 一个 `List`的 `Locale`s，一为 `warningListeners`每个元素，默认情况下 `null`初始化，这是一个空 `List`同义。

构造方法摘要

构造方法
Modifier	Constructor and Description
`protected`	`ImageWriter(ImageWriterSpi originatingProvider)` 构建了一个 `ImageWriter`和集提供的价值 `originatingProvider`实例变量。

方法摘要

所有方法接口方法抽象方法具体的方法
Modifier and Type	Method and Description
`void`	`abort()` 请求任何当前写操作被中止。
`protected boolean`	`abortRequested()` 返回 `true`如果请求中止当前的写操作已经从作家被实例化或 `clearAbortRequest`叫了。
`void`	`addIIOWriteProgressListener(IIOWriteProgressListener listener)` 增加了一个 `IIOWriteProgressListener`注册进展的侦听器列表。
`void`	`addIIOWriteWarningListener(IIOWriteWarningListener listener)` 增加了一个 `IIOWriteWarningListener`来注册警告听众名单。
`boolean`	`canInsertEmpty(int imageIndex)` 返回 `true`如果支持插入一个新的、空的图像在给定的索引。
`boolean`	`canInsertImage(int imageIndex)` 返回 `true`作者是否支持给定索引处的一种新的图像插入。
`boolean`	`canRemoveImage(int imageIndex)` 返回 `true`作者是否支持给定索引处的现有图像处理。
`boolean`	`canReplaceImageMetadata(int imageIndex)` 返回 `true`是否有可能取代现有的图像相关的图像元数据索引 `imageIndex`。
`boolean`	`canReplacePixels(int imageIndex)` 返回 `true`如果作者允许给定的图像的像素被替换使用 `replacePixels`方法。
`boolean`	`canReplaceStreamMetadata()` 返回 `true`是否可以代替数据流已经在输出。
`boolean`	`canWriteEmpty()` 返回 `true`如果作者支持组成一个未定义的像素值的单帧图像和相关的元数据和缩略图输出完整的图像流的写作。
`boolean`	`canWriteRasters()` 返回 `true`如果采取 `IIOImage`参数的方法能够处理一个 `Raster`（反对 `RenderedImage`）源图像。
`boolean`	`canWriteSequence()` 返回 `true`如果作者能够附加一个图像的图像流，已经包含头信息和可能的先验图像。
`protected void`	`clearAbortRequest()` 清除任何以前的中止请求。
`abstract IIOMetadata`	`convertImageMetadata(IIOMetadata inData, ImageTypeSpecifier imageType, ImageWriteParam param)` 返回一个 `IIOMetadata`对象可用于编码和随意修改使用文件接口或其他接口具体到作家的插件，将用于编码。
`abstract IIOMetadata`	`convertStreamMetadata(IIOMetadata inData, ImageWriteParam param)` 返回一个 `IIOMetadata`对象可用于编码和随意修改使用文件接口或其他接口具体到作家的插件，将用于编码。
`void`	`dispose()` 允许此对象所持有的任何资源被释放。
`void`	`endInsertEmpty()` 完成一个新的形象，开始与现有的电话 `prepareInsertEmpty`插入。
`void`	`endReplacePixels()` 终止序列调用 `replacePixels`。
`void`	`endWriteEmpty()` 完成一个新的形象，开始与现有的电话 `prepareWriteEmpty`写作。
`void`	`endWriteSequence()` 完成图像序列的开始与 `prepareWriteSequence`写作。
`Locale[]`	`getAvailableLocales()` 返回 `Locale`s可以用来定位警告听众和压缩设置数组。
`abstract IIOMetadata`	`getDefaultImageMetadata(ImageTypeSpecifier imageType, ImageWriteParam param)` 返回一个 `IIOMetadata`对象包含默认值的编码特定类型的图像。
`abstract IIOMetadata`	`getDefaultStreamMetadata(ImageWriteParam param)` 返回一个 `IIOMetadata`对象包含默认值的一个流中的图像编码。
`ImageWriteParam`	`getDefaultWriteParam()` 返回一个新的文件格式包含默认值，即适当的类型 `ImageWriteParam`对象，这些价值观就是如果没有 `ImageWriteParam`对象被指定使用。
`Locale`	`getLocale()` 返回当前设置 `Locale`，或 `null`如果没有设置。
`int`	`getNumThumbnailsSupported(ImageTypeSpecifier imageType, ImageWriteParam param, IIOMetadata streamMetadata, IIOMetadata imageMetadata)` 返回由格式写入支持缩略图数量，给出的图像类型和任何附加的参数写入和元数据对象将用于在编码。
`ImageWriterSpi`	`getOriginatingProvider()` 返回的 `ImageWriterSpi` `ImageWriter`创建这个对象，或 `null`如果这个对象不是通过 `IIORegistry`创建。
`Object`	`getOutput()` 返回 `ImageOutputStream`或其他 `Object`由最近一次调用的 `setOutput`方法。
`Dimension[]`	`getPreferredThumbnailSizes(ImageTypeSpecifier imageType, ImageWriteParam param, IIOMetadata streamMetadata, IIOMetadata imageMetadata)` 返回 `Dimension`s显示缩略图的尺寸范围为法律他们将输出文件或流中编码的数组。
`void`	`prepareInsertEmpty(int imageIndex, ImageTypeSpecifier imageType, int width, int height, IIOMetadata imageMetadata, List<? extends BufferedImage> thumbnails, ImageWriteParam param)` 开始将未定义的像素值插入到现有的图像流中的新图像的插入。
`void`	`prepareReplacePixels(int imageIndex, Rectangle region)` 准备作家处理一系列的 `replacePixels`方法调用。
`void`	`prepareWriteEmpty(IIOMetadata streamMetadata, ImageTypeSpecifier imageType, int width, int height, IIOMetadata imageMetadata, List<? extends BufferedImage> thumbnails, ImageWriteParam param)` 开始一个完整的图像流的写作，由一个未定义的像素值的单帧图像和相关的元数据和缩略图的输出。
`void`	`prepareWriteSequence(IIOMetadata streamMetadata)` 准备一个流接受一系列的后续 `writeToSequence`调用，使用提供的数据流对象。
`protected void`	`processImageComplete()` 广播的图像完成写信给所有注册 `IIOWriteProgressListener`s调用 `imageComplete`方法。
`protected void`	`processImageProgress(float percentageDone)` 广播的图像完成当前占所有注册 `IIOWriteProgressListener`s调用 `imageProgress`方法。
`protected void`	`processImageStarted(int imageIndex)` 广播的图像开始写信给所有注册 `IIOWriteProgressListener`s调用 `imageStarted`方法。
`protected void`	`processThumbnailComplete()` 广播一个缩略图完成写信给所有注册 `IIOWriteProgressListener`s调用 `thumbnailComplete`方法。
`protected void`	`processThumbnailProgress(float percentageDone)` 播放缩略图完成当前占所有注册 `IIOWriteProgressListener`s调用 `thumbnailProgress`方法。
`protected void`	`processThumbnailStarted(int imageIndex, int thumbnailIndex)` 广播一个缩略图开始写信给所有注册 `IIOWriteProgressListener`s调用 `thumbnailStarted`方法。
`protected void`	`processWarningOccurred(int imageIndex, String warning)` 广播警告所有注册 `IIOWriteWarningListener`s调用 `warningOccurred`方法。
`protected void`	`processWarningOccurred(int imageIndex, String baseName, String keyword)` 广播本地化警告所有注册 `IIOWriteWarningListener`s通过用来自 `ResourceBundle`字符串调用他们的 `warningOccurred`方法。
`protected void`	`processWriteAborted()` 广播，写已中止所有注册 `IIOWriteProgressListener`s调用 `writeAborted`方法。
`void`	`removeAllIIOWriteProgressListeners()` 删除所有目前注册 `IIOWriteProgressListener`对象。
`void`	`removeAllIIOWriteWarningListeners()` 删除所有目前注册 `IIOWriteWarningListener`对象。
`void`	`removeIIOWriteProgressListener(IIOWriteProgressListener listener)` 删除从注册侦听器列表的一个 `IIOWriteProgressListener`进展。
`void`	`removeIIOWriteWarningListener(IIOWriteWarningListener listener)` 删除从注册侦听器列表的一个 `IIOWriteWarningListener`警告。
`void`	`removeImage(int imageIndex)` 从流中删除图像。
`void`	`replaceImageMetadata(int imageIndex, IIOMetadata imageMetadata)` 替换与现有图像相关联的图像元数据。
`void`	`replacePixels(Raster raster, ImageWriteParam param)` 将图像的一部分 `Raster`输出中已经存在的一部分。
`void`	`replacePixels(RenderedImage image, ImageWriteParam param)` 替换已在给定图像的一部分的输出中的图像的一部分。
`void`	`replaceStreamMetadata(IIOMetadata streamMetadata)` 用新信息替换输出中的流元数据。
`void`	`reset()` `ImageWriter`恢复到其初始状态。
`void`	`setLocale(Locale locale)` 设置为给定值这 `ImageWriter`当前 `Locale`。
`void`	`setOutput(Object output)` 设置为给定 `ImageOutputStream`或其他 `Object`目的地。
`void`	`write(IIOImage image)` 在一个完整的图像流包含一个图像的默认元数据和缩略图的输出。
`abstract void`	`write(IIOMetadata streamMetadata, IIOImage image, ImageWriteParam param)` 在一个完整的图像流包含一个图像和相关的流和图像元数据和缩略图的输出。
`void`	`write(RenderedImage image)` 添加一个包含一个默认元数据和缩略图输出单帧图像完整的图像流。
`void`	`writeInsert(int imageIndex, IIOImage image, ImageWriteParam param)` 将一个新的图像插入到现有的图像流中。
`void`	`writeToSequence(IIOImage image, ImageWriteParam param)` 添加一个单一的形象和可能相关的元数据和缩略图的输出。

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

- Field Detail
  - originatingProvider
```
protected ImageWriterSpi originatingProvider
```
    的 ImageWriterSpi实例化该对象，或 null如果其身份尚不清楚或不存在。默认情况下，它被初始化为 null。
  - output
```
protected Object output
```
    的 ImageOutputStream或其他 Object由 setOutput和检索 getOutput。默认情况下，它被初始化为 null。
  - availableLocales
```
protected Locale[] availableLocales
```
    对 Locales可以用来定位报警信息和压缩设置值的数组，或 null如果定位不支持。默认情况下，它被初始化为 null。
  - locale
```
protected Locale locale
```
    用于定位当前 Locale，或 null如果没有设置。默认情况下，它被初始化为 null。
  - warningListeners
```
protected List<IIOWriteWarningListener> warningListeners
```
    一个 List目前注册 IIOWriteWarningListeners，默认 null初始化，这是一个空 List同义。
  - warningLocales
```
protected List<Locale> warningLocales
```
    一个 List的 Locales，一为 warningListeners每个元素，默认情况下 null初始化，这是一个空 List同义。
  - progressListeners
```
protected List<IIOWriteProgressListener> progressListeners
```
    一个 List目前注册 IIOWriteProgressListeners，默认情况下 null初始化，这是一个空 List同义。
- Constructor Detail
  - ImageWriter
```
protected ImageWriter(ImageWriterSpi originatingProvider)
```
    构建了一个 ImageWriter和集提供的价值 originatingProvider实例变量。
    子类，利用扩展应检索扩展对象提供一个要签名(ImageWriterSpi, Object)构造函数。如果扩展对象是不适合的，一个IllegalArgumentException应该扔。
    
    参数
    
    originatingProvider - ImageWriterSpi是构建这个对象，或 null。
- 方法详细信息
  - getOriginatingProvider
```
public ImageWriterSpi getOriginatingProvider()
```
    返回的 ImageWriterSpi ImageWriter创建这个对象，或 null如果这个对象不是通过 IIORegistry创建。
    默认实现将返回的originatingProvider实例变量的值。
    
    结果
    
    一个 ImageWriterSpi，或 null。
    
    另请参见：
    
    ImageWriterSpi
  - setOutput
```
public void setOutput(Object output)
```
    设置为给定 ImageOutputStream或其他 Object目的地。目标被假定为准备接受数据，并不会在每个写结束时关闭。这允许分布式成像应用程序在一个单一的网络连接传输一系列的图像。如果 output是 null，任何当前设置的输出将被删除。
    如果output是ImageOutputStream，呼吁write，writeToSequence，和prepareWriteEmpty / endWriteEmpty方法将保留现有的内容流。其他写的方法，如writeInsert，replaceStreamMetadata，replaceImageMetadata，replacePixels，prepareInsertEmpty / endInsertEmpty，和endWriteSequence，需要流的全部内容是可读写的，并可能改变流的任何部分。
    
    使用一个通用Object以外的ImageOutputStream是作家直接与输出设备或成像协议。法律类集合是由作家的服务提供商的getOutputTypes方法广告；大多数作家将返回一个元素的数组只包含ImageOutputStream.class表示，他们只接受ImageOutputStream。
    
    默认的实现设置output实例变量的output检查后output反对由始发提供商广告类的设置值，如果有一个。
    
    参数
    
    output - ImageOutputStream或其他 Object用于未来的写作。
    
    异常
    
    如果不是 IllegalArgumentException output实例一个类由发起的服务提供商的 getOutputTypes方法返回。
    
    另请参见：
    
    getOutput()
  - getOutput
```
public Object getOutput()
```
    返回 ImageOutputStream或其他 Object由最近一次调用的 setOutput方法。如果没有目的地已定， null返回。
    默认实现将返回的output实例变量的值。
    
    结果
    
    在指定的 Object使用 setOutput，或 null。
    
    另请参见：
    
    setOutput(java.lang.Object)
  - getAvailableLocales
```
public Locale[] getAvailableLocales()
```
    返回 Locales可以用来定位警告听众和压缩设置数组。一个 null返回值表明定位不支持。
    如果是non-null默认实现将返回的availableLocales实例变量的一个克隆，否则返回null。
    
    结果
    
    一系列的 Locales可以作为论据来 setLocale，或 null。
  - setLocale
```
public void setLocale(Locale locale)
```
    设置为给定值这 ImageWriter当前 Locale。一个价值 null删除任何以前的设置，指出作家应将其认为合适的。
    默认的执行情况进行检查locale对getAvailableLocales返回的值，并设置locale实例变量如果被发现。如果locale是null，实例变量设置为null没有任何检查。
    
    参数
    
    locale -所需的 Locale，或 null。
    
    异常
    
    IllegalArgumentException -如果 locale是非 null但不在返回的值 getAvailableLocales。
    
    另请参见：
    
    getLocale()
  - getLocale
```
public Locale getLocale()
```
    返回当前设置 Locale，或 null如果没有设置。
    默认实现将返回的locale实例变量的值。
    
    结果
    
    目前 Locale，或 null。
    
    另请参见：
    
    setLocale(java.util.Locale)
  - getDefaultWriteParam
```
public ImageWriteParam getDefaultWriteParam()
```
    返回一个新的文件格式包含默认值，即适当的类型 ImageWriteParam对象，这些价值观就是如果没有 ImageWriteParam对象被指定使用。这是作为调整几个参数出发点，否则默认设置单独留下。
    默认的实现构建并返回一个新的ImageWriteParam对象不允许拼接，进行编码，或压缩，这将对当前Locale本地化（即，你会打电话new ImageWriteParam(getLocale())。
    
    个别插件可以返回更多的可选功能ImageWriteParam实例启用，或者他们可以返回一个具体子类的一个实例ImageWriteParam插件。
    
    结果
    
    一个新的包含默认值的 ImageWriteParam对象。
  - getDefaultStreamMetadata
```
public abstract IIOMetadata getDefaultStreamMetadata(ImageWriteParam param)
```
    返回一个 IIOMetadata对象包含默认值的一个流中的图像编码。对象的内容可以使用XML树结构的 IIOMetadata.getAsTree方法返回一个对象的操作， IIOMetadataController，或通过插件特定的接口，以及由此产生的一个 write提供方法，把数据流参数数据。
    一个可选的ImageWriteParam可提供的情况下，它可能会影响的数据流结构。
    
    如果提供的ImageWriteParam包含可选的设定值由笔者不支持（例如渐进编码或任何特定格式的设置），他们将被忽略。
    
    作家不使用数据流（例如，作家单格式图像）应该返回null。
    
    参数
    
    param - ImageWriteParam将用于对图像进行编码，或 null。
    
    结果
    
    一个 IIOMetadata对象。
  - getDefaultImageMetadata
```
public abstract IIOMetadata getDefaultImageMetadata(ImageTypeSpecifier imageType,
                                                    ImageWriteParam param)
```
    返回一个 IIOMetadata对象包含默认值的编码特定类型的图像。对象的内容可以使用XML树结构的 IIOMetadata.getAsTree方法返回一个对象的操作， IIOMetadataController，或通过插件特定的接口，以及由此产生的一个 write提供方法，把数据流参数数据。
    一个可选的ImageWriteParam可提供的情况下，它可能会影响图像的元数据结构。
    
    如果提供的ImageWriteParam包含可选的设定值由笔者不支持（例如渐进编码或任何特定格式的设置），他们将被忽略。
    
    参数
    
    imageType - ImageTypeSpecifier表示图像的是后来写的格式。
    
    param - ImageWriteParam将用于对图像进行编码，或 null。
    
    结果
    
    一个 IIOMetadata对象。
  - convertStreamMetadata
```
public abstract IIOMetadata convertStreamMetadata(IIOMetadata inData,
                                                  ImageWriteParam param)
```
    从接口复制的描述： ImageTranscoder
    
    返回一个 IIOMetadata对象可用于编码和随意修改使用文件接口或其他接口具体到作家的插件，将用于编码。
    一个可选的ImageWriteParam可提供的情况下，它可能会影响的数据流结构。
    
    如果提供的ImageWriteParam包含可选的设置值的作家或转码的不理解，他们将被忽略。
    
    Specified by:
    
    convertStreamMetadata 接口 ImageTranscoder
    
    参数
    
    inData - IIOMetadata对象代表数据流，用于初始化返回的对象的状态。
    
    param - ImageWriteParam将用于对图像进行编码，或 null。
    
    结果
    
    一个 IIOMetadata对象，或 null如果插件没有提供元数据编码能力。
  - convertImageMetadata
```
public abstract IIOMetadata convertImageMetadata(IIOMetadata inData,
                                                 ImageTypeSpecifier imageType,
                                                 ImageWriteParam param)
```
    从接口复制的描述： ImageTranscoder
    
    返回一个 IIOMetadata对象可用于编码和随意修改使用文件接口或其他接口具体到作家的插件，将用于编码。
    一个可选的ImageWriteParam可提供的情况下，它可能会影响图像的元数据结构。
    
    如果提供的ImageWriteParam包含可选的设置值的作家或转码的不理解，他们将被忽略。
    
    Specified by:
    
    convertImageMetadata 接口 ImageTranscoder
    
    参数
    
    inData - IIOMetadata对象表示图像的元数据，用于初始化返回的对象的状态。
    
    imageType - ImageTypeSpecifier指示的布局和颜色信息的图像的元数据将相关。
    
    param - ImageWriteParam将用于对图像进行编码，或 null。
    
    结果
    
    一个 IIOMetadata对象，或 null如果插件没有提供元数据编码能力。
  - getNumThumbnailsSupported
```
public int getNumThumbnailsSupported(ImageTypeSpecifier imageType,
                                     ImageWriteParam param,
                                     IIOMetadata streamMetadata,
                                     IIOMetadata imageMetadata)
```
    返回由格式写入支持缩略图数量，给出的图像类型和任何附加的参数写入和元数据对象将用于在编码。一个 -1返回值表明，提供足够的信息。
    一个ImageWriteParam可提供的情况下，它可能会影响缩略图的处理。
    
    如果提供的ImageWriteParam包含可选的设定值由笔者不支持（例如渐进编码或任何特定格式的设置），他们将被忽略。
    
    默认实现返回0。
    
    参数
    
    imageType - ImageTypeSpecifier指示要写入图像的类型，或 null。
    
    param - ImageWriteParam将用于写作，或 null。
    
    streamMetadata - IIOMetadata对象将用于写作，或 null。
    
    imageMetadata - IIOMetadata对象将用于写作，或 null。
    
    结果
    
    缩略图可以书面给予提供的参数个数，或 -1如果提供足够的信息。
  - getPreferredThumbnailSizes
```
public Dimension[] getPreferredThumbnailSizes(ImageTypeSpecifier imageType,
                                              ImageWriteParam param,
                                              IIOMetadata streamMetadata,
                                              IIOMetadata imageMetadata)
```
    返回 Dimensions显示缩略图的尺寸范围为法律他们将输出文件或流中编码的数组。这些信息仅仅是顾问；作者将调整任何提供缩略图是必要的。
    作为一组对的信息返回；一对的第一个元素包含一个（包含）最小宽度和高度，和第二个元素包含一个（包含）最大宽度和高度。在一起，每个对定义了一个有效的大小范围。要指定一个固定的大小，相同的宽度和高度将出现两个元素。一个null返回值表示的大小是任意的或未知的。
    
    一个ImageWriteParam可提供的情况下，它可能会影响缩略图的处理。
    
    如果提供的ImageWriteParam包含可选的设定值由笔者不支持（例如渐进编码或任何特定格式的设置），他们将被忽略。
    
    默认的实现返回null。
    
    参数
    
    imageType - ImageTypeSpecifier指示要写入图像的类型，或 null。
    
    param - ImageWriteParam将用于写作，或 null。
    
    streamMetadata - IIOMetadata对象将用于写作，或 null。
    
    imageMetadata - IIOMetadata对象将用于写作，或 null。
    
    结果
    
    一个至少有两个甚至 Dimensions数组长度，或 null。
  - canWriteRasters
```
public boolean canWriteRasters()
```
    返回 true如果采取 IIOImage参数的方法能够处理一个 Raster（反对 RenderedImage）源图像。如果此方法返回 false，那么这些方法会提供一个 IIOImage含有 Raster抛出 UnsupportedOperationException。
    默认的实现返回false。
    
    结果
    
    true如果 Raster来源支持。
  - write
```
public abstract void write(IIOMetadata streamMetadata,
                           IIOImage image,
                           ImageWriteParam param)
                    throws IOException
```
    在一个完整的图像流包含一个图像和相关的流和图像元数据和缩略图的输出。任何必要的头信息都包括在内。如果输出是一个 ImageOutputStream，其现有的内容当前搜索位置不受影响，并且不需要读或写的。
    输出必须已预先设定的setOutput使用方法。
    
    数据流可以被提供；如果是null，默认的数据流将被使用。
    
    如果canWriteRasters返回的true，IIOImage可能包含一个Raster源。否则，它必须包含一个RenderedImage源。
    
    提供的缩略图将调整大小，如果需要的话，在支持的数量过剩的缩略图将被忽略。如果格式要求不提供额外的缩略图，作家应该产生的内部。
    
    一个ImageWriteParam可提供控制写作过程。如果param是null，默认参数将用于写。
    
    如果提供的ImageWriteParam包含可选的设定值由笔者不支持（例如渐进编码或任何特定格式的设置），他们将被忽略。
    
    参数
    
    streamMetadata - IIOMetadata对象代表数据流，或 null使用默认值。
    
    image -包含一个图像，一个 IIOImage对象的缩略图，并将元数据写入。
    
    param - ImageWriteParam，或 null使用默认 ImageWriteParam。
    
    异常
    
    IllegalStateException -如果输出尚未确定。
    
    UnsupportedOperationException -如果 image包含 Raster和 canWriteRasters返回 false。
    
    如果是 null image IllegalArgumentException。
    
    IOException -如果在写作过程中发生了一个错误。
  - write
```
public void write(IIOImage image)
           throws IOException
```
    在一个完整的图像流包含一个图像的默认元数据和缩略图的输出。这是一种速记 write(null, image, null)。
    
    参数
    
    image -包含一个图像，一个 IIOImage对象的缩略图，并将元数据写入。
    
    异常
    
    IllegalStateException -如果输出尚未确定。
    
    如果是 null image IllegalArgumentException。
    
    UnsupportedOperationException -如果 image包含 Raster和 canWriteRasters返回 false。
    
    IOException -如果在写作过程中发生了一个错误。
  - write
```
public void write(RenderedImage image)
           throws IOException
```
    添加一个包含一个默认元数据和缩略图输出单帧图像完整的图像流。这是一种速记 write(null, new IIOImage(image, null, null), null)。
    
    参数
    
    image - RenderedImage要写。
    
    异常
    
    IllegalStateException -如果输出尚未确定。
    
    如果是 null image IllegalArgumentException。
    
    IOException -如果在写作过程中发生了一个错误。
  - canWriteSequence
```
public boolean canWriteSequence()
```
    返回 true如果作者能够附加一个图像的图像流，已经包含头信息和可能的先验图像。
    如果canWriteSequence返回false，writeToSequence和endWriteSequence将抛出一个UnsupportedOperationException。
    
    默认的实现返回false。
    
    结果
    
    true如果图像可以添加顺序。
  - prepareWriteSequence
```
public void prepareWriteSequence(IIOMetadata streamMetadata)
                          throws IOException
```
    准备一个流接受一系列的后续 writeToSequence调用，使用提供的数据流对象。元数据将被写入到流，如果它应该先于图像数据。如果参数是 null，默认数据流应用。
    如果输出是一个ImageOutputStream，现有的内容输出到当前查找位置刷新之前，不需要读或写的。如果格式要求endWriteSequence能够倒带修补头信息，如在一个单一的TIFF图像序列，然后用这个方法元数据必须留在流可写的部分。其他格式可以刷新该方法后的流，并在每个图像。
    
    如果canWriteSequence返回false，该方法将抛出一个UnsupportedOperationException。
    
    输出必须已预先设定的setOutput使用方法。
    
    默认实现将抛出一个IllegalStateException如果输出是null，否则抛出一个UnsupportedOperationException。
    
    参数
    
    streamMetadata -流元数据对象，或 null。
    
    异常
    
    IllegalStateException -如果输出尚未确定。
    
    UnsupportedOperationException -如果 canWriteSequence返回 false。
    
    IOException -如果出现错误写数据流。
  - writeToSequence
```
public void writeToSequence(IIOImage image,
                            ImageWriteParam param)
                     throws IOException
```
    添加一个单一的形象和可能相关的元数据和缩略图的输出。如果输出是一个 ImageOutputStream，现有的内容输出到当前寻求位置可冲洗之前，不需要读或写，除非插件需要修补时的标题信息， endWriteSequence叫做（例如TIFF）。
    如果canWriteSequence返回false，该方法将抛出一个UnsupportedOperationException。
    
    输出必须已预先设定的setOutput使用方法。
    
    prepareWriteSequence必须被称为事前，或IllegalStateException抛出。
    
    如果canWriteRasters返回的true，IIOImage可能包含一个Raster源。否则，它必须包含一个RenderedImage源。
    
    提供的缩略图将调整大小，如果需要的话，在支持的数量过剩的缩略图将被忽略。如果格式要求不提供额外的缩略图，笔者将产生的内部。
    
    一个ImageWriteParam可提供控制写作过程。如果param是null，默认参数将用于写。
    
    如果提供的ImageWriteParam包含可选的设定值由笔者不支持（例如渐进编码或任何特定格式的设置），他们将被忽略。
    
    默认实现将抛出一个IllegalStateException如果输出是null，否则抛出一个UnsupportedOperationException。
    
    参数
    
    image -包含一个图像，一个 IIOImage对象的缩略图，并将元数据写入。
    
    param - ImageWriteParam，或 null使用默认 ImageWriteParam。
    
    异常
    
    IllegalStateException -如果输出尚未确定，或 prepareWriteSequence称尚未。
    
    UnsupportedOperationException -如果 canWriteSequence返回 false。
    
    如果是 null image IllegalArgumentException。
    
    UnsupportedOperationException -如果 image包含 Raster和 canWriteRasters返回 false。
    
    IOException -如果在写作过程中发生了一个错误。
  - endWriteSequence
```
public void endWriteSequence()
                      throws IOException
```
    完成图像序列的开始与 prepareWriteSequence写作。任何数据流应该在图像序列的末端都是写出来的，并在序列的开始任何标题的信息拼凑的必要时。如果输出是一个 ImageOutputStream，数据通过数据流序列的末尾冲不可读或可写。
    如果canWriteSequence返回false，该方法将抛出一个UnsupportedOperationException。
    
    默认实现将抛出一个IllegalStateException如果输出是null，否则抛出一个UnsupportedOperationException。
    
    异常
    
    IllegalStateException -如果输出尚未确定，或 prepareWriteSequence称尚未。
    
    UnsupportedOperationException -如果 canWriteSequence返回 false。
    
    IOException -如果在写作过程中发生了一个错误。
  - canReplaceStreamMetadata
```
public boolean canReplaceStreamMetadata()
                                 throws IOException
```
    返回 true是否可以代替数据流已经在输出。
    默认实现将抛出一个IllegalStateException如果输出是null，否则返回false。
    
    结果
    
    true如果数据流允许更换。
    
    异常
    
    IllegalStateException -如果输出尚未确定。
    
    IOException -如果在查询时发生I/O错误。
  - replaceStreamMetadata
```
public void replaceStreamMetadata(IIOMetadata streamMetadata)
                           throws IOException
```
    用新信息替换输出中的流元数据。如果输出是一个 ImageOutputStream，流中的现有内容进行检查和可能的编辑制作的新资料室。输出的所有的前内容必须是可供阅读和写作。
    如果canReplaceStreamMetadata返回false，一UnsupportedOperationException将抛出。
    
    默认实现将抛出一个IllegalStateException如果输出是null，否则抛出一个UnsupportedOperationException。
    
    参数
    
    streamMetadata - IIOMetadata对象代表数据流，或 null使用默认值。
    
    异常
    
    IllegalStateException -如果输出尚未确定。
    
    UnsupportedOperationException -如果 canReplaceStreamMetadata返回 false。模式不包括
    
    IOException -如果在写作过程中发生了一个错误。
  - canReplaceImageMetadata
```
public boolean canReplaceImageMetadata(int imageIndex)
                                throws IOException
```
    返回 true是否有可能取代现有的图像相关的图像元数据索引 imageIndex。如果此方法返回 false，电话 replaceImageMetadata(imageIndex)将抛出一个 UnsupportedOperationException。
    一个作家，不支持任何图像元数据替换可能会返回false不执行边界上的指标考核。
    
    默认实现将抛出一个IllegalStateException如果输出是null，否则返回false不检查imageIndex价值。
    
    参数
    
    imageIndex -元数据的可替代的图像索引。
    
    结果
    
    true如果给定图像的图像元数据可以取代。
    
    异常
    
    IllegalStateException -如果输出尚未确定。
    
    IndexOutOfBoundsException -如果作者支持通用图像元数据替换，但 imageIndex小于0或大于最大可用指数。
    
    IOException -如果在查询时发生I/O错误。
  - replaceImageMetadata
```
public void replaceImageMetadata(int imageIndex,
                                 IIOMetadata imageMetadata)
                          throws IOException
```
    替换与现有图像相关联的图像元数据。
    如果canReplaceImageMetadata(imageIndex)返回false，一UnsupportedOperationException将抛出。
    
    默认实现将抛出一个IllegalStateException如果输出是null，否则抛出一个UnsupportedOperationException。
    
    参数
    
    imageIndex -元数据的可替代的图像索引。
    
    imageMetadata - IIOMetadata对象表示图像的元数据，或 null。
    
    异常
    
    IllegalStateException -如果输出尚未确定。
    
    UnsupportedOperationException -如果 canReplaceImageMetadata返回 false。
    
    IndexOutOfBoundsException -如果 imageIndex小于0或大于最大可用指数。
    
    IOException -如果在写作过程中发生了一个错误。
  - canInsertImage
```
public boolean canInsertImage(int imageIndex)
                       throws IOException
```
    返回 true作者是否支持给定索引处的一种新的图像插入。与索引大于或等于插入索引的现有的图像将有他们的指数增加了1。对于 imageIndex的 -1值可以用来表示指数大于当前最大的指数。
    一个作家，不支持任何图像插入可能会返回false不执行边界上的指标考核。
    
    默认实现将抛出一个IllegalStateException如果输出是null，否则返回false不检查imageIndex价值。
    
    参数
    
    imageIndex -索引的图像被插入。
    
    结果
    
    true如果图像可以插在给定的索引。
    
    异常
    
    IllegalStateException -如果输出尚未确定。
    
    IndexOutOfBoundsException -如果作者支持通用图像插入，但 imageIndex小于1或大于最大可用指数。
    
    IOException -如果在查询时发生I/O错误。
  - writeInsert
```
public void writeInsert(int imageIndex,
                        IIOImage image,
                        ImageWriteParam param)
                 throws IOException
```
    将一个新的图像插入到现有的图像流中。大于 imageIndex保存索引存在的图像，和他们的指标是每增加1。一个值 imageIndex - 1可以用来表示指数大于前最大的指标；即会引起图像是逻辑添加到序列结束。如果输出是一个 ImageOutputStream，流的整体必须是可读写的。
    如果canInsertImage(imageIndex)返回false，一UnsupportedOperationException将抛出。
    
    一个ImageWriteParam可提供控制写作过程。如果param是null，默认参数将用于写。
    
    如果提供的ImageWriteParam包含可选的设定值由笔者不支持（例如渐进编码或任何特定格式的设置），他们将被忽略。
    
    默认实现将抛出一个IllegalStateException如果输出是null，否则抛出一个UnsupportedOperationException。
    
    参数
    
    在这 imageIndex指标写的图像。
    
    image -包含一个图像，一个 IIOImage对象的缩略图，并将元数据写入。
    
    param - ImageWriteParam，或 null使用默认 ImageWriteParam。
    
    异常
    
    IllegalStateException -如果输出尚未确定。
    
    UnsupportedOperationException -如果 canInsertImage(imageIndex)返回 false。
    
    如果是 null image IllegalArgumentException。
    
    IndexOutOfBoundsException -如果 imageIndex小于1或大于最大可用指数。
    
    UnsupportedOperationException -如果 image包含 Raster和 canWriteRasters返回 false。
    
    IOException -如果在写作过程中发生了一个错误。
  - canRemoveImage
```
public boolean canRemoveImage(int imageIndex)
                       throws IOException
```
    返回 true作者是否支持给定索引处的现有图像处理。现有的图像索引大于插入索引将有他们的指标下降了1。
    一个作家，不支持任何图像去除可能false不执行边界检查返回的索引。
    
    默认实现将抛出一个IllegalStateException如果输出是null，否则返回false不检查imageIndex价值。
    
    参数
    
    imageIndex -要删除的图像索引。
    
    结果
    
    true如果可以删除给定的图像。
    
    异常
    
    IllegalStateException -如果输出尚未确定。
    
    IndexOutOfBoundsException -如果作者支持通用图像去除，但 imageIndex小于0或大于最大可用指数。
    
    IOException -如果在查询时发生I/O错误。
  - removeImage
```
public void removeImage(int imageIndex)
                 throws IOException
```
    从流中删除图像。
    如果canRemoveImage(imageIndex)返回false，UnsupportedOperationExceptionwill抛出一个。
    
    移除可能或可能不会导致实际文件大小的减少。
    
    默认实现将抛出一个IllegalStateException如果输出是null，否则抛出一个UnsupportedOperationException。
    
    参数
    
    imageIndex -要删除的图像索引。
    
    异常
    
    IllegalStateException -如果输出尚未确定。
    
    UnsupportedOperationException -如果 canRemoveImage(imageIndex)返回 false。
    
    IndexOutOfBoundsException -如果 imageIndex小于0或大于最大可用指数。
    
    IOException -如果在去除发生I/O错误。
  - canWriteEmpty
```
public boolean canWriteEmpty()
                      throws IOException
```
    返回 true如果作者支持组成一个未定义的像素值的单帧图像和相关的元数据和缩略图输出完整的图像流的写作。像素值可以被定义为 replacePixels将来调用方法。如果输出是一个 ImageOutputStream，其现有的内容当前搜索位置不受影响，并且不需要读或写的。
    默认实现将抛出一个IllegalStateException如果输出是null，否则返回false。
    
    结果
    
    true如果内容完整的图像流被定义后是支持写作。
    
    异常
    
    IllegalStateException -如果输出尚未确定。
    
    IOException -如果在查询时发生I/O错误。
  - prepareWriteEmpty
```
public void prepareWriteEmpty(IIOMetadata streamMetadata,
                              ImageTypeSpecifier imageType,
                              int width,
                              int height,
                              IIOMetadata imageMetadata,
                              List<? extends BufferedImage> thumbnails,
                              ImageWriteParam param)
                       throws IOException
```
    开始一个完整的图像流的写作，由一个未定义的像素值的单帧图像和相关的元数据和缩略图的输出。像素值将被未来的 replacePixels方法调用定义。如果输出是一个 ImageOutputStream，其现有的内容当前搜索位置不受影响，并且不需要读或写的。
    直到一个叫endWriteEmpty发生的写作是不完整的。电话prepareReplacePixels，replacePixels，并呼吁prepareWriteEmpty和endWriteEmpty之间可能发生的endReplacePixels。然而，电话prepareWriteEmpty不能嵌套，并呼吁prepareWriteEmpty和prepareInsertEmpty不得穿插。
    
    如果canWriteEmpty返回false，一UnsupportedOperationException将抛出。
    
    一个ImageWriteParam可提供控制写作过程。如果param是null，默认参数将用于写。
    
    如果提供的ImageWriteParam包含可选的设定值由笔者不支持（例如渐进编码或任何特定格式的设置），他们将被忽略。
    
    默认实现将抛出一个IllegalStateException如果输出是null，否则抛出一个UnsupportedOperationException。
    
    参数
    
    streamMetadata - IIOMetadata对象代表数据流，或 null使用默认值。
    
    imageType - ImageTypeSpecifier描述图像的布局。
    
    width -图像的宽度。
    
    height -图像的高度。
    
    imageMetadata - IIOMetadata对象表示图像的元数据，或 null。
    
    thumbnails -这个形象的 List BufferedImage缩略图，或 null。
    
    param - ImageWriteParam，或 null使用默认 ImageWriteParam。
    
    异常
    
    IllegalStateException -如果输出尚未确定。
    
    UnsupportedOperationException -如果 canWriteEmpty返回 false。
    
    IllegalStateException如果以前调用 prepareWriteEmpty一直没有相应的电话 endWriteEmpty。
    
    IllegalStateException如果以前调用 prepareInsertEmpty一直没有相应的电话 endInsertEmpty。
    
    IllegalArgumentException -如果 imageType是 null或 thumbnails包含 null参考文献或其他比 BufferedImages对象。
    
    IllegalArgumentException如果宽度或高度小于1。
    
    IOException -如果在写作发生I/O错误。
  - endWriteEmpty
```
public void endWriteEmpty()
                   throws IOException
```
    完成一个新的形象，开始与现有的电话 prepareWriteEmpty写作。
    如果canWriteEmpty()返回false，一UnsupportedOperationException将抛出。
    
    默认实现将抛出一个IllegalStateException如果输出是null，否则抛出一个UnsupportedOperationException。
    
    异常
    
    IllegalStateException -如果输出尚未确定。
    
    UnsupportedOperationException -如果 canWriteEmpty(imageIndex)返回 false。
    
    IllegalStateException如果以前调用 prepareWriteEmpty没有相应的调用 endWriteEmpty尚未。
    
    IllegalStateException如果以前调用 prepareInsertEmpty没有相应的调用 endInsertEmpty了。
    
    IllegalStateException如果调用 prepareReiplacePixels已经没有匹配调用 endReplacePixels。
    
    IOException -如果在写作发生I/O错误。
  - canInsertEmpty
```
public boolean canInsertEmpty(int imageIndex)
                       throws IOException
```
    返回 true如果支持插入一个新的、空的图像在给定的索引。图像的像素值是未定义的，并且可以使用 replacePixels件指定方法。与索引大于或等于插入索引的现有的图像将有他们的指数增加了1。对于 imageIndex的 -1值可以用来表示指数大于当前最大的指数。
    一个作家不支持空图像插入可能false不执行边界检查返回的索引。
    
    默认实现将抛出一个IllegalStateException如果输出是null，否则返回false不检查imageIndex价值。
    
    参数
    
    imageIndex -索引的图像被插入。
    
    结果
    
    true如果空图像可以插在给定的索引。
    
    异常
    
    IllegalStateException -如果输出尚未确定。
    
    IndexOutOfBoundsException如果支持一般空图像插入，但 imageIndex小于1或大于最大可用指数。
    
    IOException -如果在查询时发生I/O错误。
  - prepareInsertEmpty
```
public void prepareInsertEmpty(int imageIndex,
                               ImageTypeSpecifier imageType,
                               int width,
                               int height,
                               IIOMetadata imageMetadata,
                               List<? extends BufferedImage> thumbnails,
                               ImageWriteParam param)
                        throws IOException
```
    开始将未定义的像素值插入到现有的图像流中的新图像的插入。大于 imageIndex保存索引存在的图像，和他们的指标是每增加1。一个值 imageIndex - 1可以用来表示指数大于前最大的指标；即会引起图像是逻辑添加到序列结束。如果输出是一个 ImageOutputStream，流的整体必须是可读写的。
    图像内容可供以后使用replacePixels方法。直到一个叫endInsertEmpty发生插入是不完整的。电话prepareReplacePixels，replacePixels，并呼吁prepareInsertEmpty和endInsertEmpty之间可能发生的endReplacePixels。然而，电话prepareInsertEmpty不能嵌套，并呼吁prepareWriteEmpty和prepareInsertEmpty不得穿插。
    
    如果canInsertEmpty(imageIndex)返回false，一UnsupportedOperationException将抛出。
    
    一个ImageWriteParam可提供控制写作过程。如果param是null，默认参数将用于写。
    
    如果提供的ImageWriteParam包含可选的设定值由笔者不支持（例如渐进编码或任何特定格式的设置），他们将被忽略。
    
    默认实现将抛出一个IllegalStateException如果输出是null，否则抛出一个UnsupportedOperationException。
    
    参数
    
    在这 imageIndex指标写的图像。
    
    imageType - ImageTypeSpecifier描述图像的布局。
    
    width -图像的宽度。
    
    height -图像的高度。
    
    imageMetadata - IIOMetadata对象表示图像的元数据，或 null。
    
    thumbnails -这个形象的 List BufferedImage缩略图，或 null。
    
    param - ImageWriteParam，或 null使用默认 ImageWriteParam。
    
    异常
    
    IllegalStateException -如果输出尚未确定。
    
    UnsupportedOperationException -如果 canInsertEmpty(imageIndex)返回 false。
    
    IndexOutOfBoundsException -如果 imageIndex小于1或大于最大可用指数。
    
    IllegalStateException如果以前调用 prepareInsertEmpty一直没有相应的电话 endInsertEmpty。
    
    IllegalStateException如果以前调用 prepareWriteEmpty一直没有相应的电话 endWriteEmpty。
    
    IllegalArgumentException -如果 imageType是 null或 thumbnails包含 null参考文献或其他比 BufferedImages对象。
    
    IllegalArgumentException如果宽度或高度小于1。
    
    IOException -如果在写作发生I/O错误。
  - endInsertEmpty
```
public void endInsertEmpty()
                    throws IOException
```
    完成一个新的形象，开始与现有的电话 prepareInsertEmpty
    默认实现将抛出一个IllegalStateException如果输出是null，否则抛出一个UnsupportedOperationException。
    插入。
    
    异常
    
    IllegalStateException -如果输出尚未确定。
    
    UnsupportedOperationException -如果 canInsertEmpty(imageIndex)返回 false。
    
    IllegalStateException -如果没有相应的调用 endInsertEmpty到 prepareInsertEmpty之前调用尚未。
    
    IllegalStateException如果以前调用 prepareWriteEmpty没有相应的调用 endWriteEmpty了。
    
    IllegalStateException如果调用 prepareReplacePixels已经没有匹配调用 endReplacePixels。
    
    IOException -如果在写作发生I/O错误。
  - canReplacePixels
```
public boolean canReplacePixels(int imageIndex)
                         throws IOException
```
    返回 true如果作者允许给定的图像的像素被替换使用 replacePixels方法。
    一个作家，不支持任何像素替换可能false不执行边界检查返回的索引。
    
    默认实现将抛出一个IllegalStateException如果输出是null，否则返回false不检查imageIndex价值。
    
    参数
    
    imageIndex -其像素的图像被替换的指标。
    
    结果
    
    true如果给定的图像的像素可以更换。
    
    异常
    
    IllegalStateException -如果输出尚未确定。
    
    IndexOutOfBoundsException如果支持一般的像素替换，但 imageIndex小于0或大于最大可用指数。
    
    IOException -如果在查询时发生I/O错误。
  - prepareReplacePixels
```
public void prepareReplacePixels(int imageIndex,
                                 Rectangle region)
                          throws IOException
```
    准备作家处理一系列的 replacePixels方法调用。受影响的像素面积将对所提供的
    如果canReplacePixels返回false，和UnsupportedOperationException将抛出。
    
    默认实现将抛出一个IllegalStateException如果输出是null，否则抛出一个UnsupportedOperationException。
    夹
    
    参数
    
    imageIndex -其像素的图像被替换的指标。
    
    region - Rectangle将用来夹未来像素区域。
    
    异常
    
    IllegalStateException -如果输出尚未确定。
    
    UnsupportedOperationException -如果 canReplacePixels(imageIndex)返回 false。
    
    IndexOutOfBoundsException -如果 imageIndex小于0或大于最大可用指数。
    
    IllegalStateException -如果有以前调用 prepareReplacePixels没有匹配调用 endReplacePixels（即，嵌套是不允许的）。
    
    IllegalArgumentException -如果 region是 null或宽度或高度小于1。
    
    IOException -如果在制备过程中发生I/O错误。
  - replacePixels
```
public void replacePixels(RenderedImage image,
                          ImageWriteParam param)
                   throws IOException
```
    替换已在给定图像的一部分的输出中的图像的一部分。图像数据必须匹配，或可转换为，现有图像的图像布局。
    目标区域在param参数指定，将裁剪的图像边界，并提供给prepareReplacePixels区域。至少一个源的至少一个像素不能被剪切，或抛出一个异常。
    
    一个ImageWriteParam可提供控制写作过程。如果param是null，默认参数将用于写。
    
    如果提供的ImageWriteParam包含可选的设定值由笔者不支持（例如渐进编码或任何特定格式的设置），他们将被忽略。
    
    此方法只可打电话prepareReplacePixels后调用，否则将抛出一个IllegalStateException。
    
    默认实现将抛出一个IllegalStateException如果输出是null，否则抛出一个UnsupportedOperationException。
    参数
    
    image - RenderedImage含源像素。
    
    param - ImageWriteParam，或 null使用默认 ImageWriteParam。
    
    异常
    
    IllegalStateException -如果输出尚未确定。
    
    UnsupportedOperationException -如果 canReplacePixels(imageIndex)返回 false。
    
    IllegalStateException -如果没有前一个调用 prepareReplacePixels没有匹配调用 endReplacePixels。
    IllegalArgumentException -如果任何以下是真实的：
    
    image是null。
    
    param是null。
    
    相交的区域不包含至少一个像素。
    
    对image布局不匹配，或者这个作家不能转换，现有的图像布局。
    IOException -如果在写作发生I/O错误。
  - replacePixels
```
public void replacePixels(Raster raster,
                          ImageWriteParam param)
                   throws IOException
```
    将图像的一部分 Raster输出中已经存在的一部分。图像数据必须匹配，或可转换为，现有图像的图像布局。
    一个ImageWriteParam可提供控制写作过程。如果param是null，默认参数将用于写。
    
    目标区域在param参数指定，将裁剪的图像边界，并提供给prepareReplacePixels区域。至少一个源的至少一个像素不能被剪切，或抛出一个异常。
    
    如果提供的ImageWriteParam包含可选的设定值由笔者不支持（例如渐进编码或任何特定格式的设置），他们将被忽略。
    
    此方法只可打电话prepareReplacePixels后调用，否则将抛出一个IllegalStateException。
    
    默认实现将抛出一个IllegalStateException如果输出是null，否则抛出一个UnsupportedOperationException。
    参数
    
    raster - Raster含源像素。
    
    param - ImageWriteParam，或 null使用默认 ImageWriteParam。
    
    异常
    
    IllegalStateException -如果输出尚未确定。
    
    UnsupportedOperationException -如果 canReplacePixels(imageIndex)返回 false。
    
    IllegalStateException -如果没有前一个调用 prepareReplacePixels没有匹配调用 endReplacePixels。
    
    UnsupportedOperationException -如果 canWriteRasters返回 false。
    IllegalArgumentException -如果任何以下是真实的：
    
    raster是null。
    
    param是null。
    
    相交的区域不包含至少一个像素。
    
    对raster布局不匹配，或者这个作家不能转换，现有的图像布局。
    IOException -如果在写作发生I/O错误。
  - endReplacePixels
```
public void endReplacePixels()
                      throws IOException
```
    终止序列调用 replacePixels。
    如果canReplacePixels返回false，和UnsupportedOperationException将抛出。
    
    默认实现将抛出一个IllegalStateException如果输出是null，否则抛出一个UnsupportedOperationException。
    
    异常
    
    IllegalStateException -如果输出尚未确定。
    
    UnsupportedOperationException -如果 canReplacePixels(imageIndex)返回 false。
    
    IllegalStateException -如果没有前一个调用 prepareReplacePixels没有匹配调用 endReplacePixels。
    
    IOException -如果在写作发生I/O错误。
  - abort
```
public void abort()
```
    请求任何当前写操作被中止。中止后的输出的内容将是不确定的。
    作家应该在每次开始写操作的调用clearAbortRequest，和民意调查的价值abortRequested经常在写。
  - abortRequested
```
protected boolean abortRequested()
```
    返回 true如果请求中止当前的写操作已经从作家被实例化或 clearAbortRequest叫了。
    
    结果
    
    true如果当前写操作应中止。
    
    另请参见：
    
    abort()， clearAbortRequest()
  - clearAbortRequest
```
protected void clearAbortRequest()
```
    清除任何以前的中止请求。在这个方法被调用时，将返回 false abortRequested。
    
    另请参见：
    
    abort()， abortRequested()
  - addIIOWriteWarningListener
```
public void addIIOWriteWarningListener(IIOWriteWarningListener listener)
```
    增加了一个 IIOWriteWarningListener来注册警告听众名单。如果 listener是 null，无异常将被抛出并没有将采取行动。送去给听众的邮件将被定位，如果可能的话，以适应当前 Locale。如果没有 Locale已定，警告信息可以作为笔者认为合适的定位。
    
    参数
    
    listener - IIOWriteWarningListener要登记。
    
    另请参见：
    
    removeIIOWriteWarningListener(javax.imageio.event.IIOWriteWarningListener)
  - removeIIOWriteWarningListener
```
public void removeIIOWriteWarningListener(IIOWriteWarningListener listener)
```
    删除从注册侦听器列表的一个 IIOWriteWarningListener警告。如果听众是以前没有注册，或者 listener是 null，无异常将被抛出并没有将采取行动。
    
    参数
    
    listener - IIOWriteWarningListener被注销。
    
    另请参见：
    
    addIIOWriteWarningListener(javax.imageio.event.IIOWriteWarningListener)
  - removeAllIIOWriteWarningListeners
```
public void removeAllIIOWriteWarningListeners()
```
    删除所有目前注册 IIOWriteWarningListener对象。
    默认的实现设置warningListeners和warningLocales实例变量null。
  - addIIOWriteProgressListener
```
public void addIIOWriteProgressListener(IIOWriteProgressListener listener)
```
    增加了一个 IIOWriteProgressListener注册进展的侦听器列表。如果 listener是 null，无异常将被抛出并没有将采取行动。
    
    参数
    
    listener - IIOWriteProgressListener要登记。
    
    另请参见：
    
    removeIIOWriteProgressListener(javax.imageio.event.IIOWriteProgressListener)
  - removeIIOWriteProgressListener
```
public void removeIIOWriteProgressListener(IIOWriteProgressListener listener)
```
    删除从注册侦听器列表的一个 IIOWriteProgressListener进展。如果听众是以前没有注册，或者 listener是 null，无异常将被抛出并没有将采取行动。
    
    参数
    
    listener - IIOWriteProgressListener被注销。
    
    另请参见：
    
    addIIOWriteProgressListener(javax.imageio.event.IIOWriteProgressListener)
  - removeAllIIOWriteProgressListeners
```
public void removeAllIIOWriteProgressListeners()
```
    删除所有目前注册 IIOWriteProgressListener对象。
    默认的实现设置progressListeners实例变量null。
  - processImageStarted
```
protected void processImageStarted(int imageIndex)
```
    广播的图像开始写信给所有注册 IIOWriteProgressListeners调用 imageStarted方法。子类可以使用这个方法作为一个方便。
    
    参数
    
    imageIndex -索引的图像被写入。
  - processImageProgress
```
protected void processImageProgress(float percentageDone)
```
    广播的图像完成当前占所有注册 IIOWriteProgressListeners调用 imageProgress方法。子类可以使用这个方法作为一个方便。
    
    参数
    
    percentageDone -完成电流的百分比，作为一个 float。
  - processImageComplete
```
protected void processImageComplete()
```
    广播的图像完成写信给所有注册 IIOWriteProgressListeners调用 imageComplete方法。子类可以使用这个方法作为一个方便。
  - processThumbnailStarted
```
protected void processThumbnailStarted(int imageIndex,
                                       int thumbnailIndex)
```
    广播一个缩略图开始写信给所有注册 IIOWriteProgressListeners调用 thumbnailStarted方法。子类可以使用这个方法作为一个方便。
    
    参数
    
    imageIndex -与缩略图相关的图像的索引。
    
    thumbnailIndex -缩略图索引。
  - processThumbnailProgress
```
protected void processThumbnailProgress(float percentageDone)
```
    播放缩略图完成当前占所有注册 IIOWriteProgressListeners调用 thumbnailProgress方法。子类可以使用这个方法作为一个方便。
    
    参数
    
    percentageDone -完成电流的百分比，作为一个 float。
  - processThumbnailComplete
```
protected void processThumbnailComplete()
```
    广播一个缩略图完成写信给所有注册 IIOWriteProgressListeners调用 thumbnailComplete方法。子类可以使用这个方法作为一个方便。
  - processWriteAborted
```
protected void processWriteAborted()
```
    广播，写已中止所有注册 IIOWriteProgressListeners调用 writeAborted方法。子类可以使用这个方法作为一个方便。
  - processWarningOccurred
```
protected void processWarningOccurred(int imageIndex,
                                      String warning)
```
    广播警告所有注册 IIOWriteWarningListeners调用 warningOccurred方法。子类可以使用这个方法作为一个方便。
    
    参数
    
    imageIndex -索引的图像上出现的警告。
    
    warning的警告信息。
    
    异常
    
    如果是 null warning IllegalArgumentException。
  - processWarningOccurred
```
protected void processWarningOccurred(int imageIndex,
                                      String baseName,
                                      String keyword)
```
    广播本地化警告所有注册 IIOWriteWarningListeners通过用来自 ResourceBundle字符串调用他们的 warningOccurred方法，子类可以使用此方法作为一种方便的。
    
    参数
    
    imageIndex -索引的图像上出现的警告。
    
    baseName -一套包含本地化的警告消息 ResourceBundles基名称。
    
    keyword用于索引的警告消息在 ResourceBundles设定关键字。
    
    异常
    
    如果是 null baseName IllegalArgumentException。
    
    如果是 null keyword IllegalArgumentException。
    
    IllegalArgumentException -如果没有合适的 ResourceBundle可能位于。
    
    IllegalArgumentException -如果指定的资源不在位于 ResourceBundle发现。
    
    IllegalArgumentException -如果从 ResourceBundle检索的对象不是 String。
  - reset
```
public void reset()
```
    ImageWriter恢复到其初始状态。
    默认实现调用setOutput(null)，setLocale(null)，removeAllIIOWriteWarningListeners()，removeAllIIOWriteProgressListeners()，和clearAbortRequest。
  - dispose
```
public void dispose()
```
    允许此对象所持有的任何资源被释放。调用其他方法的结果（除 finalize）来调用这个方法，随后是未定义的。
    重要的是应用程序调用这个方法，当他们知道他们将不再使用这ImageWriter。否则，作者可能会继续保持对资源的无限期。
    
    在父类的该方法的默认实现不执行任何操作。子类的实现应该确保所有的资源，特别是本地资源被释放。

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 ImageWriter

Field Summary

构造方法摘要

方法摘要

Methods inherited from class java.lang.Object

Field Detail

originatingProvider

output

availableLocales

locale

warningListeners

warningLocales

progressListeners

Constructor Detail

ImageWriter

方法详细信息

getOriginatingProvider

setOutput

getOutput

getAvailableLocales

setLocale

getLocale

getDefaultWriteParam

getDefaultStreamMetadata

getDefaultImageMetadata

convertStreamMetadata

convertImageMetadata

getNumThumbnailsSupported

getPreferredThumbnailSizes

canWriteRasters

write

write

write

canWriteSequence

prepareWriteSequence

writeToSequence

endWriteSequence

canReplaceStreamMetadata

replaceStreamMetadata

canReplaceImageMetadata

replaceImageMetadata

canInsertImage

writeInsert

canRemoveImage

removeImage

canWriteEmpty

prepareWriteEmpty

endWriteEmpty

canInsertEmpty

prepareInsertEmpty

endInsertEmpty

canReplacePixels

prepareReplacePixels

replacePixels

replacePixels

endReplacePixels

abort

abortRequested

clearAbortRequest

addIIOWriteWarningListener

removeIIOWriteWarningListener

removeAllIIOWriteWarningListeners

addIIOWriteProgressListener

removeIIOWriteProgressListener

removeAllIIOWriteProgressListeners

processImageStarted

processImageProgress

processImageComplete

processThumbnailStarted

processThumbnailProgress

processThumbnailComplete

processWriteAborted

processWarningOccurred

processWarningOccurred

reset

dispose