ImageWriter (Java Platform SE 8 )

java.lang.Object
- javax.imageio.ImageWriter

All Implemented Interfaces:

ImageTranscoder
```
public abstract class ImageWriter
extends Object
implements ImageTranscoder
```
用于编码和写入图像的抽象超类。该类必须由在Java Image 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`如果其身份不知道或不存在， `null` 。
`protected Object`	`output` `ImageOutputStream`或其他 `Object`由 `Object`设定， `setOutput` getOutput `getOutput` 。
`protected List<IIOWriteProgressListener>`	`progressListeners` A `List`当前注册的 `IIOWriteProgressListener` s，默认 `null` ，这是一个空的 `List` 。
`protected List<IIOWriteWarningListener>`	`warningListeners` A `List`当前注册的 `IIOWriteWarningListener` s，默认 `null`为 `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`是否已经作出中止当前写入操作的请求自从writer被实例化或 `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)` 如果作者允许使用 `replacePixels`方法替换给定图像的像素，则返回 `true` 。
`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`对象，并可使用其文档接口或特定于将用于编码的writer插件的其他接口进行可选修改。
`abstract IIOMetadata`	`convertStreamMetadata(IIOMetadata inData, ImageWriteParam param)` 返回可用于编码的 `IIOMetadata`对象，并可使用文档接口或特定于编写器插件的其他接口进行修改，该接口将用于编码。
`void`	`dispose()` 允许释放此对象持有的任何资源。
`void`	`endInsertEmpty()` 完成插入一个以前调用 `prepareInsertEmpty`开始的新映像。
`void`	`endReplacePixels()` 终止调用序列 `replacePixels` 。
`void`	`endWriteEmpty()` 完成了以前调用 `prepareWriteEmpty`开始的新图像的写入。
`void`	`endWriteSequence()` 完成了以prepareWriteSequence开头的一系列图像的 `prepareWriteSequence` 。
`Locale[]`	`getAvailableLocales()` 返回的数组 `Locale` ，其可以被用于警告侦听器和压缩设置秒。
`abstract IIOMetadata`	`getDefaultImageMetadata(ImageTypeSpecifier imageType, ImageWriteParam param)` 返回一个 `IIOMetadata`用于对给定类型的图像进行编码的默认值的 `IIOMetadata`对象。
`abstract IIOMetadata`	`getDefaultStreamMetadata(ImageWriteParam param)` 返回一个 `IIOMetadata`用于编码图像流的默认值的 `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的数组， `Dimension`缩略图的合法大小范围，因为它们将被编码在输出文件或流中。
`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()` 通过调用他们的 `imageComplete`方法来广播对所有注册的 `IIOWriteProgressListener`的图像写入的 `imageComplete` 。
`protected void`	`processImageProgress(float percentageDone)` 通过调用他们的 `imageProgress`方法，将目前的图像完成百分比广播到所有注册的 `IIOWriteProgressListener` 。
`protected void`	`processImageStarted(int imageIndex)` 通过调用他们的 `imageStarted`方法，将所有注册的 `IIOWriteProgressListener`的图像写入的开始 `imageStarted` 。
`protected void`	`processThumbnailComplete()` 通过调用他们的 `thumbnailComplete`方法广播完成对所有注册的 `IIOWriteProgressListener`的缩略图写入。
`protected void`	`processThumbnailProgress(float percentageDone)` 通过调用他们的 `thumbnailProgress`方法，将目前的缩略图完成百分比广播到所有已 `IIOWriteProgressListener`的 `thumbnailProgress` 。
`protected void`	`processThumbnailStarted(int imageIndex, int thumbnailIndex)` 通过调用他们的 `thumbnailStarted`方法，将所有注册的 `IIOWriteProgressListener` s的缩略图写入的开始 `thumbnailStarted` 。
`protected void`	`processWarningOccurred(int imageIndex, String warning)` 通过调用他们的 `warningOccurred`方法向所有注册的 `IIOWriteWarningListener`发送一条警告消息。
`protected void`	`processWarningOccurred(int imageIndex, String baseName, String keyword)` 通过使用从 `ResourceBundle`的字符串调用其 `warningOccurred`方法，向所有注册的 `IIOWriteWarningListener`广播本地化警告消息。
`protected void`	`processWriteAborted()` 通过调用他们的 `writeAborted`方法来广播写入已被中止到所有注册的 `IIOWriteProgressListener` 。
`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)` 将此 `Locale`的当前 `ImageWriter`设置为给定值。
`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

- 字段详细信息
  - originatingProvider
```
protected ImageWriterSpi originatingProvider
```
    该ImageWriterSpi认为这个实例化对象，或null如果其身份未知或不存在。默认情况下，它被初始化为null 。
  - output
```
protected Object output
```
    ImageOutputStream或其他Object由Object设置并由setOutput getOutput 。默认情况下，它被初始化为null 。
  - availableLocales
```
protected Locale[] availableLocales
```
    的阵列Locale可用于本地化警告消息和压缩设置值，或S null如果不支持定位。默认情况下，它被初始化为null 。
  - locale
```
protected Locale locale
```
    目前Locale用于定位，或null如果没有设置。默认情况下，它被初始化为null 。
  - warningListeners
```
protected List<IIOWriteWarningListener> warningListeners
```
    A List当前注册的 IIOWriteWarningListener s，默认 null为 null ，这是一个空的 List 。
  - warningLocales
```
protected List<Locale> warningLocales
```
    甲 List的 Locale S，一个用于的每个元素 warningListeners ，默认情况下初始化 null ，其与空同义 List 。
  - progressListeners
```
protected List<IIOWriteProgressListener> progressListeners
```
    A List当前注册的 IIOWriteProgressListener s，默认 null ，这是一个空的 List 。
- 构造方法详细信息
  - 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的值。
    
    参数
    
    output - ImageOutputStream或其他 Object用于将来的写作。
    
    异常
    
    IllegalArgumentException - 如果 output不是始发服务提供商的 getOutputTypes方法返回的一个类的实例。
    
    另请参见：
    
    getOutput()
  - getOutput
```
public Object getOutput()
```
    返回ImageOutputStream或其他Object由最近调用的setOutput方法设置。如果没有设置null则返回null 。
    默认实现返回output实例变量的值。
    
    结果
    
    所述 Object最近使用指定 setOutput ，或 null 。
    
    另请参见：
    
    setOutput(java.lang.Object)
  - getAvailableLocales
```
public Locale[] getAvailableLocales()
```
    返回可用于本地化警告侦听器和压缩设置的Locale s数组。返回值为null表示不支持本地化。
    如果availableLocales实例变量非null ，默认实现将返回一个克隆，否则返回null 。
    
    结果
    
    的阵列 Locale s表示可被用作参数 setLocale ，或 null 。
  - setLocale
```
public void setLocale(Locale locale)
```
    将此Locale的当前ImageWriter设置为给定值。值为null将删除任何以前的设置，并指示作者应将其视为合适的本地化。
    默认实现检查locale对返回的值getAvailableLocales ，并设置locale如果发现实例变量。如果locale为null ，则实例变量设置为null而不进行任何检查。
    
    参数
    
    locale - 所需的 Locale或 null 。
    
    异常
    
    IllegalArgumentException - 如果 locale是非 null但不是由 getAvailableLocales返回的值 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())获得的new ImageWriteParam(getLocale()) 。
    
    单独的插件可能返回一个ImageWriteParam的实例，并启用了附加的可选功能，或者它们可能会返回ImageWriteParam的插件特定子类的ImageWriteParam 。
    
    结果
    
    一个新的 ImageWriteParam对象包含默认值。
  - getDefaultStreamMetadata
```
public abstract IIOMetadata getDefaultStreamMetadata(ImageWriteParam param)
```
    返回一个IIOMetadata用于编码图像流的默认值的IIOMetadata对象。可以使用由IIOMetadata.getAsTree方法返回的XML树结构， IIOMetadataController对象或通过插件特定接口来IIOMetadataController对象的内容，并将得到的数据提供给采用流元数据参数的write方法之一。
    可能会为可能影响流元数据结构的情况提供可选的ImageWriteParam 。
    
    如果提供的ImageWriteParam包含此写入程序不支持的可选设置值（例如逐行编码或任何特定于格式的设置），它们将被忽略。
    
    不使用流元数据的作者（例如，单图像格式的作者）应返回null 。
    
    参数
    
    param -一个 ImageWriteParam将被用于对图像，或编码 null 。
    
    结果
    
    一个 IIOMetadata对象。
  - getDefaultImageMetadata
```
public abstract IIOMetadata getDefaultImageMetadata(ImageTypeSpecifier imageType,
                                                    ImageWriteParam param)
```
    返回一个IIOMetadata给定类型图像的默认值的IIOMetadata对象。可以使用由IIOMetadata.getAsTree方法返回的XML树结构， IIOMetadataController对象或通过插件特定接口来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对象，并可以使用其文档接口或特定于将用于编码的writer插件的其他接口进行修改。
    可能会为可能影响图像元数据结构的情况提供可选的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 ，或 null 。
    
    param -该 ImageWriteParam将被用于书写，或 null 。
    
    streamMetadata - 将用于写入的 IIOMetadata对象，或 null 。
    
    imageMetadata - 将用于写入的 IIOMetadata对象，或 null 。
    
    结果
    
    其可以被写入给定所提供的参数，或缩略图的数目 -1如果信息不足是可用的。
  - getPreferredThumbnailSizes
```
public Dimension[] getPreferredThumbnailSizes(ImageTypeSpecifier imageType,
                                              ImageWriteParam param,
                                              IIOMetadata streamMetadata,
                                              IIOMetadata imageMetadata)
```
    返回一个Dimension s的数组， Dimension像的合法大小范围，因为它们将被编码在输出文件或流中。这些信息只是咨询; 作者将根据需要调整所提供的缩略图大小。
    该信息作为一组对返回; 一对的第一个元素包含（包括）最小宽度和高度，第二个元素包含（包含）最大宽度和高度。在一起，每对都定义了一个有效的大小范围。要指定一个固定的大小，两个元素都会出现相同的宽度和高度。返回值为null指示大小是任意的或未知的。
    
    一个ImageWriteParam可任选地被用于在那里它可以影响缩略图办案提供。
    
    如果提供的ImageWriteParam包含此写入程序不支持的可选设置值（例如逐行编码或任何特定于格式的设置），它们将被忽略。
    
    默认实现返回null 。
    
    参数
    
    imageType - ImageTypeSpecifier要写入的图像的类型的 null ，或 null 。
    
    param -该 ImageWriteParam将被用于书写，或 null 。
    
    streamMetadata - 将用于写入的 IIOMetadata对象，或 null 。
    
    imageMetadata - 将用于写入的 IIOMetadata对象，或 null 。
    
    结果
    
    一个 Dimension的数组，其长度至少为2或 null 。
  - canWriteRasters
```
public boolean canWriteRasters()
```
    返回true如果采取方法IIOImage参数能够与处理的Raster （相对于RenderedImage ）源图像。如果此方法返回false ，那么这些方法将抛出一个UnsupportedOperationException如果附带一个IIOImage Raster的Raster 。
    默认实现返回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 。
    
    IllegalArgumentException - 如果 image是 null 。
    
    IOException - 写入时是否发生错误。
  - write
```
public void write(IIOImage image)
           throws IOException
```
    将含有默认元数据和缩略图的单个图像的完整图像流附加到输出。这个方法是write(null, image, null)的write(null, image, null) 。
    
    参数
    
    image - 一个 IIOImage要写入的图像，缩略图和元数据的 IIOImage对象。
    
    异常
    
    IllegalStateException - 如果输出未设置。
    
    IllegalArgumentException - 如果 image是 null 。
    
    UnsupportedOperationException - 如果 image包含一个 Raster和 canWriteRasters返回 false 。
    
    IOException - 写入时是否发生错误。
  - write
```
public void write(RenderedImage image)
           throws IOException
```
    将包含单个图像的完整图像流附加到输出的默认元数据和缩略图。这个方法是write(null, new IIOImage(image, null, null), null)的write(null, new IIOImage(image, null, null), null) 。
    
    参数
    
    image - a RenderedImage待写。
    
    异常
    
    IllegalStateException - 如果输出未设置。
    
    IllegalArgumentException - 如果 image是 null 。
    
    IOException - 写入时是否发生错误。
  - canWriteSequence
```
public boolean canWriteSequence()
```
    如果作者能够将图像附加到已经包含标题信息和可能的先前图像的图像流中，则返回true 。
    如果canWriteSequence返回false ， writeToSequence和endWriteSequence将抛出UnsupportedOperationException 。
    
    默认实现返回false 。
    
    结果
    
    true如果可以顺序附加图像。
  - prepareWriteSequence
```
public void prepareWriteSequence(IIOMetadata streamMetadata)
                          throws IOException
```
    使用提供的流元数据对象准备流以接受一系列后续的writeToSequence调用。如果元数据应该在图像数据之前，则会将元数据写入流中。如果参数为null ，则使用默认流元数据。
    如果输出为ImageOutputStream ，则刷新当前查找位置之前的输出的现有内容，并且不需要可读写。如果格式要求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时endWriteSequence进行补丁（例如 TIFF）。
    如果canWriteSequence返回false ，这个方法会抛出一个UnsupportedOperationException 。
    
    必须使用setOutput方法预先设置输出。
    
    prepareWriteSequence必须事先调用，或抛出IllegalStateException 。
    
    如果canWriteRasters返回true ，则IIOImage可能包含一个Raster源。否则，它必须包含一个RenderedImage源。
    
    如果需要，提供的缩略图将被调整大小，超过支持的数字的任何缩略图将被忽略。如果格式需要未提供的附加缩略图，写入程序将在内部生成它们。
    
    一个ImageWriteParam可任选地提供给控制写入过程。如果param为null ，则将使用默认的写参数。
    
    如果提供的ImageWriteParam包含此写入程序不支持的可选设置值（例如逐行编码或任何特定于格式的设置），它们将被忽略。
    
    默认的实现抛出IllegalStateException如果输出为null ，否则会引发UnsupportedOperationException 。
    
    参数
    
    image - 一个 IIOImage要写入的图像，缩略图和元数据的 IIOImage对象。
    
    param - 一个 ImageWriteParam或 null使用默认的 ImageWriteParam 。
    
    异常
    
    IllegalStateException - 如果输出未设置，或 prepareWriteSequence尚未被调用。
    
    UnsupportedOperationException - 如果 canWriteSequence返回 false 。
    
    IllegalArgumentException - 如果 image是 null 。
    
    UnsupportedOperationException - 如果 image包含一个 Raster和 canWriteRasters返回 false 。
    
    IOException - 写入时是否发生错误。
  - endWriteSequence
```
public void endWriteSequence()
                      throws IOException
```
    完成以prepareWriteSequence开始的一系列图像的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 ， ImageOutputStream检查并可能编辑流的先前内容，为新数据腾出空间。输出的所有先前内容必须可用于阅读和写入。
    如果canReplaceStreamMetadata返回false ，将抛出一个UnsupportedOperationException 。
    
    如果输出为null ，默认实现会抛出一个IllegalStateException ，否则会抛出一个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要写入的图像，缩略图和元数据的 IIOImage对象。
    
    param - 一个 ImageWriteParam或 null使用默认的 ImageWriteParam 。
    
    异常
    
    IllegalStateException - 如果输出未设置。
    
    UnsupportedOperationException - 如果 canInsertImage(imageIndex)返回 false 。
    
    IllegalArgumentException - 如果 image是 null 。
    
    IndexOutOfBoundsException - 如果 imageIndex小于-1或大于最大可用索引。
    
    UnsupportedOperationException - 如果 image包含一个 Raster和 canWriteRasters返回 false 。
    
    IOException - 写入时是否发生错误。
  - canRemoveImage
```
public boolean canRemoveImage(int imageIndex)
                       throws IOException
```
    如果作者支持删除给定索引中的现有图像，则返回true 。索引大于插入索引的现有图像的索引将减少1。
    不支持任何图像删除的作者可能会返回false而不对索引执行边界检查。
    
    默认的实现抛出IllegalStateException如果输出为null ，否则返回false不检查的值imageIndex 。
    
    参数
    
    imageIndex - 要删除的图像的索引。
    
    结果
    
    true如果可以删除给定的图像。
    
    异常
    
    IllegalStateException - 如果输出未设置。
    
    IndexOutOfBoundsException - 如果作者一般支持图像删除，但 imageIndex小于0或大于最大可用索引。
    
    IOException - 查询期间是否发生I / O错误。
  - removeImage
```
public void removeImage(int imageIndex)
                 throws IOException
```
    从流中删除图像。
    如果canRemoveImage(imageIndex)返回false，将抛出一个UnsupportedOperationException 。
    
    删除可能会导致或可能不会导致实际文件大小的减少。
    
    如果输出为null ，默认实现会抛出一个IllegalStateException ，否则会抛出一个UnsupportedOperationException 。
    
    参数
    
    imageIndex - 要删除的图像的索引。
    
    异常
    
    IllegalStateException - 如果输出未设置。
    
    UnsupportedOperationException - 如果 canRemoveImage(imageIndex)返回 false 。
    
    IndexOutOfBoundsException - 如果 imageIndex小于0或大于最大可用索引。
    
    IOException - 如果在删除期间发生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和endReplacePixels可调用之间发生prepareWriteEmpty和endWriteEmpty 。但是，调用prepareWriteEmpty无法嵌套，并且调用prepareWriteEmpty和prepareInsertEmpty可能不会散置。
    
    如果canWriteEmpty返回false ，将抛出一个UnsupportedOperationException 。
    
    一个ImageWriteParam可任选地提供给控制写入过程。如果param是null ，将使用默认的写参数。
    
    如果提供的ImageWriteParam包含此写入程序不支持的可选设置值（例如逐行编码或任何特定于格式的设置），它们将被忽略。
    
    如果输出为null ，默认实现会抛出一个IllegalStateException ，否则会抛出一个UnsupportedOperationException 。
    
    参数
    
    streamMetadata - 表示流元数据的 IIOMetadata对象，或使用默认值的 null 。
    
    imageType - ImageTypeSpecifier图像布局的ImageTypeSpecifier。
    
    width - 图像的宽度。
    
    height - 图像的高度。
    
    imageMetadata - 表示图像元数据的 IIOMetadata对象，或 null 。
    
    thumbnails - a List的 BufferedImage此图片的 BufferedImage ，或 null 。
    
    param - 一个 ImageWriteParam或 null使用默认的 ImageWriteParam 。
    
    异常
    
    IllegalStateException - 如果输出未设置。
    
    UnsupportedOperationException - 如果 canWriteEmpty返回 false 。
    
    IllegalStateException - 如果先前致电 prepareWriteEmpty已经进行了没有相应的调用 endWriteEmpty 。
    
    IllegalStateException - 如果先前致电 prepareInsertEmpty已经进行了没有相应的调用 endInsertEmpty 。
    
    IllegalArgumentException - 如果 imageType是 null或 thumbnails包含 null引用或除 BufferedImage的对象。
    
    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调用 endReplacePixels 。
    
    IOException - 写入时是否发生I / O错误。
  - canInsertEmpty
```
public boolean canInsertEmpty(int imageIndex)
                       throws IOException
```
    如果作者支持在给定索引处插入新的空图像，则返回true 。图像的像素值未定义，可以使用replacePixels方法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.可以使用-1的imageIndex的值来表示比先前最大索引大的索引; 也就是说，它将使图像逻辑地附加到序列的末尾。如果输出是ImageOutputStream ，则整个流都必须是可读写的。
    以后可以使用replacePixels方法提供图像内容。调用endInsertEmpty之前插入不完整。拨打prepareReplacePixels ， replacePixels和endReplacePixels可调用之间发生prepareInsertEmpty和endInsertEmpty 。但是，拨打prepareInsertEmpty不能嵌套，并且调用prepareWriteEmpty和prepareInsertEmpty可能不会散布。
    
    如果canInsertEmpty(imageIndex)返回false ，则会抛出一个UnsupportedOperationException 。
    
    一个ImageWriteParam可任选地提供给控制写入过程。如果param是null ，将使用默认的写参数。
    
    如果提供的ImageWriteParam包含此写入程序不支持的可选设置值（例如逐行编码或任何特定于格式的设置），它们将被忽略。
    
    如果输出为null ，默认实现会抛出一个IllegalStateException ，否则会抛出一个UnsupportedOperationException 。
    
    参数
    
    imageIndex - 写入图像的索引。
    
    imageType - ImageTypeSpecifier图像布局的ImageTypeSpecifier。
    
    width - 图像的宽度。
    
    height - 图像的高度。
    
    imageMetadata - 表示图像元数据的 IIOMetadata对象，或 null 。
    
    thumbnails - a List的 BufferedImage该图像的 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引用或除 BufferedImage的对象。
    
    IllegalArgumentException - 如果宽度或高度小于1。
    
    IOException - 写入时是否发生I / O错误。
  - endInsertEmpty
```
public void endInsertEmpty()
                    throws IOException
```
    完成插入一个以前调用prepareInsertEmpty开始的新映像。
    默认的实现抛出IllegalStateException如果输出为null ，否则会引发UnsupportedOperationException 。
    
    异常
    
    IllegalStateException - 如果输出未设置。
    
    UnsupportedOperationException - 如果 canInsertEmpty(imageIndex)返回 false 。
    
    IllegalStateException如果以前调用- prepareInsertEmpty没有相应的调用 endInsertEmpty尚未作出。
    
    IllegalStateException - 如果以前致电 prepareWriteEmpty没有对应的调用 endWriteEmpty已经做出了。
    
    IllegalStateException - 如果没有对 prepareReplacePixels的匹配呼叫进行 endReplacePixels呼叫。
    
    IOException - 写入时是否发生I / O错误。
  - canReplacePixels
```
public boolean canReplacePixels(int imageIndex)
                         throws IOException
```
    如果作者允许使用replacePixels方法替换给定图像的像素，则返回true 。
    不支持任何像素替换的作者可能会返回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 。
    
    如果输出为null ，默认实现会抛出一个IllegalStateException ，否则会抛出一个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的值。
  - abortRequested
```
protected boolean abortRequested()
```
    返回 true是否已经作出中止当前写入操作的请求自从writer被实例化或 clearAbortRequest被调用。
    
    结果
    
    true如果当前写操作应该中止。
    
    另请参见：
    
    abort() ， clearAbortRequest()
  - clearAbortRequest
```
protected void clearAbortRequest()
```
    清除任何先前的中止请求。此方法被调用后， abortRequested将返回false 。
    
    另请参见：
    
    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)
```
    通过调用他们的imageStarted方法，将所有注册的IIOWriteProgressListener s的图像写入的开始imageStarted 。子类可以方便地使用这种方法。
    
    参数
    
    imageIndex - 要写入的图像的索引。
  - processImageProgress
```
protected void processImageProgress(float percentageDone)
```
    通过调用他们的imageProgress方法，将目前的图像完成百分比广播到所有注册的IIOWriteProgressListener 。子类可以方便地使用这种方法。
    
    参数
    
    percentageDone - 目前的完成百分比，作为 float 。
  - processImageComplete
```
protected void processImageComplete()
```
    通过调用他们的imageComplete方法来广播对所有注册的IIOWriteProgressListener的图像写入的imageComplete 。子类可以方便地使用这种方法。
  - processThumbnailStarted
```
protected void processThumbnailStarted(int imageIndex,
                                       int thumbnailIndex)
```
    通过调用他们的thumbnailStarted方法，将所有注册的IIOWriteProgressListener s的缩略图写入的开始thumbnailStarted 。子类可以方便地使用这种方法。
    
    参数
    
    imageIndex - 与 imageIndex的图像的索引。
    
    thumbnailIndex - thumbnailIndex的索引。
  - processThumbnailProgress
```
protected void processThumbnailProgress(float percentageDone)
```
    通过调用他们的thumbnailProgress方法，将目前的缩略图完成百分比广播到所有注册的IIOWriteProgressListener 。子类可以方便地使用这种方法。
    
    参数
    
    percentageDone - 目前的完成百分比，为 float 。
  - processThumbnailComplete
```
protected void processThumbnailComplete()
```
    通过调用他们的thumbnailComplete方法广播完成对所有注册的IIOWriteProgressListener的缩略图写入。子类可以方便地使用这种方法。
  - processWriteAborted
```
protected void processWriteAborted()
```
    通过调用他们的writeAborted方法IIOWriteProgressListener已经中止所有注册的所有注册的IIOWriteProgressListener 。子类可以方便地使用这种方法。
  - processWarningOccurred
```
protected void processWarningOccurred(int imageIndex,
                                      String warning)
```
    通过调用他们的warningOccurred方法向所有注册的IIOWriteWarningListener发送一条警告消息。子类可以方便地使用这种方法。
    
    参数
    
    imageIndex - 发生警告的图像的索引。
    
    warning - 警告信息。
    
    异常
    
    IllegalArgumentException - 如果 warning是 null 。
  - processWarningOccurred
```
protected void processWarningOccurred(int imageIndex,
                                      String baseName,
                                      String keyword)
```
    广播本地化警告消息给所有注册IIOWriteWarningListener通过调用它们的S warningOccurred法从拍摄字符串ResourceBundle 。子类可以方便地使用这种方法。
    
    参数
    
    imageIndex - 发生警告的图像的索引。
    
    baseName -一组的基本名称 ResourceBundle包含本地化警告消息秒。
    
    keyword - 用于索引 ResourceBundle的集合内的警告消息的关键字。
    
    异常
    
    IllegalArgumentException - 如果 baseName是 null 。
    
    IllegalArgumentException - 如果 keyword是 null 。
    
    IllegalArgumentException - 如果不能找到 ResourceBundle 。
    
    IllegalArgumentException - 如果找不到位于 ResourceBundle的命名资源。
    
    IllegalArgumentException - 如果从 ResourceBundle的对象不是 String 。
  - reset
```
public void reset()
```
    将ImageWriter恢复到初始状态。
    默认实现调用setOutput(null) ， setLocale(null) ， removeAllIIOWriteWarningListeners() ， removeAllIIOWriteProgressListeners()和clearAbortRequest 。
  - dispose
```
public void dispose()
```
    允许释放此对象持有的任何资源。在调用此方法之后调用其他方法（ finalize之外的其他方法）的结果未定义。
    当应用程序知道他们将不再使用此方法时，调用此方法很ImageWriter 。否则，作者可以继续无限期地持有资源。
    
    超类中的这个方法的默认实现什么都不做。子类实现应确保释放所有资源，特别是本地资源。

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

字段详细信息

originatingProvider

output

availableLocales

locale

warningListeners

warningLocales

progressListeners

构造方法详细信息

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