ImageWriter (Платформа Java SE 7)

java.lang. Объект
- javax.imageio. ImageWriter

Все Реализованные Интерфейсы:

ImageTranscoder
```
public abstract class ImageWriter
extends Object
implements ImageTranscoder
```
Абстрактный суперкласс для кодирования и записи изображений. Этот класс должен быть разделен на подклассы классами, которые выписывают изображения в контексте платформы ввода-вывода Изображения Java.
ImageWriter объекты обычно инстанцирует класс поставщика услуг для определенного формата. Классы поставщика услуг регистрируются в IIORegistry, который использует их для распознавания формата и представления читателей доступного формата и писателей.

См. Также:
ImageReader, ImageWriteParam, IIORegistry, ImageWriterSpi

Полевая Сводка

Поля
Модификатор и Тип	Поле и Описание
`protected Locale[]`	`availableLocales` Массив `Locale`s, который может использоваться, чтобы локализовать предупреждающие сообщения и значения установки сжатия, или `null` если локализация не поддерживается.
`protected Locale`	`локаль` Ток `Locale` использоваться для локализации, или `null` если ни один не был установлен.
`protected ImageWriterSpi`	`originatingProvider` `ImageWriterSpi` это инстанцировало этого объекта, или `null` если его идентификационные данные не известны, или ни один не существует.
`protected Object`	`вывод` `ImageOutputStream` или другой `Object` установленный `setOutput` и полученный `getOutput`.
`protected List<IIOWriteProgressListener>`	`progressListeners` A `List` из в настоящий момент зарегистрированного `IIOWriteProgressListener`s, инициализированный по умолчанию `null`, который синонимичен с пустым `List`.
`protected List<IIOWriteWarningListener>`	`warningListeners` A `List` из в настоящий момент зарегистрированного `IIOWriteWarningListener`s, инициализированный по умолчанию к `null`, который синонимичен с пустым `List`.
`protected List<Locale>`	`warningLocales` A `List` из `Locale`s, один для каждого элемента `warningListeners`, инициализированный по умолчанию `null`, который синонимичен с пустым `List`.

Сводка конструктора

Конструкторы
Модификатор	Конструктор и Описание
`protected`	`ImageWriter(ImageWriterSpi originatingProvider)` Конструкции `ImageWriter` и наборы `originatingProvider` переменная экземпляра к предоставленному значению.

Сводка метода

Методы
Модификатор и Тип	Метод и Описание
`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` параметр способен к контакту с a `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`.
`Локаль[]`	`getAvailableLocales()` Возвращает массив `Locale`s, который может использоваться, чтобы локализовать предупреждение настройки сжатия и слушатели.
`abstract IIOMetadata`	`getDefaultImageMetadata(ImageTypeSpecifier imageType, ImageWriteParam param)` Возвраты `IIOMetadata` объект, содержащий значения по умолчанию для того, чтобы закодировать изображение данного типа.
`abstract IIOMetadata`	`getDefaultStreamMetadata(ImageWriteParam param)` Возвраты `IIOMetadata` объект, содержащий значения по умолчанию для того, чтобы закодировать поток изображений.
`ImageWriteParam`	`getDefaultWriteParam()` Возвращает новое `ImageWriteParam` объект соответствующего типа для этого формата файла, содержащего значения по умолчанию, то есть, те значения, которые использовались бы если нет `ImageWriteParam` объект был определен.
`Локаль`	`getLocale()` Возвращается в настоящий момент набор `Locale`, или `null` если ни один не был установлен.
`int`	`getNumThumbnailsSupported(ImageTypeSpecifier imageType, ImageWriteParam param, IIOMetadata streamMetadata, IIOMetadata imageMetadata)` Возвращает число миниатюр suported записанным форматом, учитывая тип изображения и любые дополнительные параметры записи и объекты метаданных, которые будут использоваться во время кодирования.
`ImageWriterSpi`	`getOriginatingProvider()` Возвраты `ImageWriterSpi` возразите, что создал это `ImageWriter`, или `null` если этот объект не создавался через `IIORegistry`.
`Объект`	`getOutput()` Возвраты `ImageOutputStream` или другой `Object` установленный новым звонком `setOutput` метод.
`Размерность[]`	`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, вызывая их `warningOccurred` метод со строкой, взятой от a `ResourceBundle`.
`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)` Устанавливает ток `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)` Добавляет единственное изображение и возможно связанные метаданные и миниатюры, к выводу.

Методы java.lang унаследованный от класса. Объект
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Полевая Деталь
  - originatingProvider
```
protected ImageWriterSpi originatingProvider
```
    ImageWriterSpi это инстанцировало этого объекта, или null если его идентификационные данные не известны, или ни один не существует. По умолчанию это инициализируется к null.
  - вывод
```
protected Object output
```
    ImageOutputStream или другой Object установленный setOutput и полученный getOutput. По умолчанию это инициализируется к null.
  - availableLocales
```
protected Locale[] availableLocales
```
    Массив Locales, который может использоваться, чтобы локализовать предупреждающие сообщения и значения установки сжатия, или null если локализация не поддерживается. По умолчанию это инициализируется к null.
  - локаль
```
protected Locale locale
```
    Ток Locale использоваться для локализации, или null если ни один не был установлен. По умолчанию это инициализируется к null.
  - warningListeners
```
protected List<IIOWriteWarningListener> warningListeners
```
    A List из в настоящий момент зарегистрированного IIOWriteWarningListeners, инициализированный по умолчанию к null, который синонимичен с пустым List.
  - warningLocales
```
protected List<Locale> warningLocales
```
    A List из Locales, один для каждого элемента warningListeners, инициализированный по умолчанию null, который синонимичен с пустым List.
  - progressListeners
```
protected List<IIOWriteProgressListener> progressListeners
```
    A List из в настоящий момент зарегистрированного IIOWriteProgressListeners, инициализированный по умолчанию 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 - 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 указывает, что локализация не поддерживается.
    Реализация по умолчанию возвращает клона availableLocales переменная экземпляра, если это не -null, или иначе возвраты null.
    
    Возвраты:
    массив Locales, который может использоваться в качестве параметров setLocale, или null.
  - setLocale
```
public void setLocale(Locale locale)
```
    Устанавливает ток Locale из этого ImageWriter к данному значению. Значение 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 содержит дополнительные значения установки, не понятые под этим писателем или транскодером, они будут проигнорированы.
    
    Определенный:
    
    convertStreamMetadata в интерфейсе ImageTranscoder
    
    Параметры:
    inData - IIOMetadata объект, представляющий потоковые метаданные, используемые, чтобы инициализировать состояние возвращенного объекта.
    param - ImageWriteParam это будет использоваться, чтобы закодировать изображение, или null.
    
    Возвраты:
    IIOMetadata объект, или null если плагин не обеспечивает возможности кодирования метаданных.
  - convertImageMetadata
```
public abstract IIOMetadata convertImageMetadata(IIOMetadata inData,
                               ImageTypeSpecifier imageType,
                               ImageWriteParam param)
```
    Описание скопировало с интерфейса: ImageTranscoder
    
    Возвраты IIOMetadata объект, который может использоваться для кодирования и дополнительно изменил использование его интерфейсов документа или других интерфейсов, определенных для плагина писателя, который будет использоваться для того, чтобы закодировать.
    Дополнительное ImageWriteParam может быть предоставлен для случаев, где это может влиять на структуру метаданных изображения.
    Если предоставленный ImageWriteParam содержит дополнительные значения установки, не понятые под этим писателем или транскодером, они будут проигнорированы.
    
    Определенный:
    
    convertImageMetadata в интерфейсе ImageTranscoder
    
    Параметры:
    inData - IIOMetadata объект, представляющий метаданные изображения, используемые, чтобы инициализировать состояние возвращенного объекта.
    imageType - ImageTypeSpecifier указание на расположение и информацию о цвете изображения, с которым будут связаны метаданные.
    param - ImageWriteParam это будет использоваться, чтобы закодировать изображение, или null.
    
    Возвраты:
    IIOMetadata объект, или null если плагин не обеспечивает возможности кодирования метаданных.
  - getNumThumbnailsSupported
```
public int getNumThumbnailsSupported(ImageTypeSpecifier imageType,
                            ImageWriteParam param,
                            IIOMetadata streamMetadata,
                            IIOMetadata imageMetadata)
```
    Возвращает число миниатюр suported записанным форматом, учитывая тип изображения и любые дополнительные параметры записи и объекты метаданных, которые будут использоваться во время кодирования. Возвращаемое значение -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 параметр способен к контакту с a Raster (в противоположность RenderedImage) исходное изображение. Если этот метод возвращается false, тогда те методы бросят UnsupportedOperationException если предоставлено IIOImage содержа a Raster.
    Возвраты реализации по умолчанию false.
    
    Возвраты:
    true если Raster источники поддерживаются.
  - записать
```
public abstract void write(IIOMetadata streamMetadata,
         IIOImage image,
         ImageWriteParam param)
                    throws IOException
```
    Добавляет полный поток изображения, содержащий единственное изображение и связанный поток и метаданные изображения и миниатюры к выводу. Любая необходимая информация о заголовке включается. Если вывод ImageOutputStream, его существующее содержание до тока ищет, позиция не влияются, и не должен быть читаемым или перезаписываемым.
    Вывод, должно быть, был установлен, заранее используя setOutput метод.
    Потоковые метаданные могут дополнительно быть предоставлены; если это null, потоковые метаданные по умолчанию будут использоваться.
    Если canWriteRasters возвраты true, IIOImage может содержать a Raster источник. Иначе, это должно содержать a RenderedImage источник.
    Предоставленные миниатюры будут изменены если нужно, и любые миниатюры сверх поддерживаемого числа будут проигнорированы. Если формат требует дополнительных миниатюр, которые не обеспечиваются, писатель должен генерировать их внутренне.
    ImageWriteParam май дополнительно быть предоставленным, чтобы управлять записью. Если param null, запись по умолчанию param будет использоваться.
    Если предоставленный ImageWriteParam содержит дополнительные значения установки, не поддерживаемые этим писателем (например, прогрессивное кодирование или любые специфичные для формата настройки), они будут проигнорированы.
    
    Параметры:
    streamMetadata - IIOMetadata объект, представляющий потоковые метаданные, или null использовать значения по умолчанию.
    image - IIOImage объект, содержащий изображение, миниатюры, и метаданные, которые будут записаны.
    param - ImageWriteParam, или null использовать значение по умолчанию ImageWriteParam.
    
    Броски:
    
    IllegalStateException - если вывод не был установлен.
    
    UnsupportedOperationException - если image содержит a Raster и canWriteRasters возвраты false.
    
    IllegalArgumentException - если image null.
    
    IOException - если ошибка происходит во время записи.
  - записать
```
public void write(IIOImage image)
           throws IOException
```
    Добавляет полный поток изображения, содержащий единственное изображение с метаданными по умолчанию и миниатюрами к выводу. Этот метод является сокращением для write(null, image, null).
    
    Параметры:
    image - IIOImage объект, содержащий изображение, миниатюры, и метаданные, которые будут записаны.
    
    Броски:
    
    IllegalStateException - если вывод не был установлен.
    
    IllegalArgumentException - если image null.
    
    UnsupportedOperationException - если image содержит a Raster и canWriteRasters возвраты false.
    
    IOException - если ошибка происходит во время записи.
  - записать
```
public void write(RenderedImage image)
           throws IOException
```
    Добавляет полный поток изображения, состоящий из единственного изображения с метаданными по умолчанию и миниатюрами к выводу. Этот метод является сокращением для 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 будьте в состоянии перемотаться, чтобы исправить информацию о заголовке, такой что касается последовательности изображений в единственном файле РАЗМОЛВКИ, тогда метаданные, записанные этим методом, должны остаться в перезаписываемой части потока. Другие форматы могут сбросить поток после этого метода и после каждого изображения.
    Если 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 вызывается (например, Размолвка).
    Если canWriteSequence возвраты false, этот метод бросит UnsupportedOperationException.
    Вывод, должно быть, был установлен, заранее используя setOutput метод.
    prepareWriteSequence должно быть, был вызван заранее, или IllegalStateException бросается.
    Если canWriteRasters возвраты true, IIOImage может содержать a Raster источник. Иначе, это должно содержать a RenderedImage источник.
    Предоставленные миниатюры будут изменены если нужно, и любые миниатюры сверх поддерживаемого числа будут проигнорированы. Если формат потребует дополнительных миниатюр, которые не обеспечиваются, то писатель генерирует их внутренне.
    ImageWriteParam май дополнительно быть предоставленным, чтобы управлять записью. Если param null, запись по умолчанию param будет использоваться.
    Если предоставленный ImageWriteParam содержит дополнительные значения установки, не поддерживаемые этим писателем (например, прогрессивное кодирование или любые специфичные для формата настройки), они будут проигнорированы.
    Реализация по умолчанию бросает IllegalStateException если вывод null, и иначе броски UnsupportedOperationException.
    
    Параметры:
    image - IIOImage объект, содержащий изображение, миниатюры, и метаданные, которые будут записаны.
    param - ImageWriteParam, или null использовать значение по умолчанию ImageWriteParam.
    
    Броски:
    
    IllegalStateException - если вывод не был установлен, или prepareWriteSequence не был вызван.
    
    UnsupportedOperationException - если canWriteSequence возвраты false.
    
    IllegalArgumentException - если image null.
    
    UnsupportedOperationException - если image содержит a 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 - если ошибка ввода-вывода происходит во время запроса.
  - 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 - если ошибка ввода-вывода происходит во время запроса.
  - 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 withour проверка значения imageIndex.
    
    Параметры:
    imageIndex - индекс, по которому должно быть вставлено изображение.
    
    Возвраты:
    true если изображение может быть вставлено по данному индексу.
    
    Броски:
    
    IllegalStateException - если вывод не был установлен.
    
    IndexOutOfBoundsException - если писатель поддерживает вставку изображения вообще, но imageIndex меньше чем-1 или больше чем самый большой доступный индекс.
    
    IOException - если ошибка ввода-вывода происходит во время запроса.
  - writeInsert
```
public void writeInsert(int imageIndex,
               IIOImage image,
               ImageWriteParam param)
                 throws IOException
```
    Вставляет новое изображение в существующий поток изображения. Существующие изображения с индексом, больше чем imageIndex сохраняются, и их индексы каждый увеличиваются на 1. Значение для imageIndex из-1 может использоваться, чтобы показать индекс одно большее чем предыдущий самый большой индекс; то есть, это заставит изображение быть логически добавленным до конца последовательности. Если вывод ImageOutputStream, полнота потока должна быть и читаемой и writeable.
    Если canInsertImage(imageIndex) возвраты false, UnsupportedOperationException будет брошен.
    ImageWriteParam май дополнительно быть предоставленным, чтобы управлять записью. Если param null, запись по умолчанию param будет использоваться.
    Если предоставленный ImageWriteParam содержит дополнительные значения установки, не поддерживаемые этим писателем (например, прогрессивное кодирование или любые специфичные для формата настройки), они будут проигнорированы.
    Реализация по умолчанию бросает IllegalStateException если вывод null, и иначе броски UnsupportedOperationException.
    
    Параметры:
    imageIndex - индекс, по которому можно записать изображение.
    image - IIOImage объект, содержащий изображение, миниатюры, и метаданные, которые будут записаны.
    param - ImageWriteParam, или null использовать значение по умолчанию ImageWriteParam.
    
    Броски:
    
    IllegalStateException - если вывод не был установлен.
    
    UnsupportedOperationException - если canInsertImage(imageIndex) возвраты false.
    
    IllegalArgumentException - если image null.
    
    IndexOutOfBoundsException - если imageIndex меньше чем-1 или больше чем самый большой доступный индекс.
    
    UnsupportedOperationException - если image содержит a 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 - если ошибка ввода-вывода происходит во время запроса.
  - removeImage
```
public void removeImage(int imageIndex)
                 throws IOException
```
    Удаляет изображение из потока.
    Если canRemoveImage(imageIndex) возвращает false, UnsupportedOperationExceptionбудет брошен.
    Удаление может или, возможно, не вызывает сокращение фактического размера файла.
    Реализация по умолчанию бросает IllegalStateException если вывод null, и иначе броски UnsupportedOperationException.
    
    Параметры:
    imageIndex - индекс изображения, которое будет удалено.
    
    Броски:
    
    IllegalStateException - если вывод не был установлен.
    
    UnsupportedOperationException - если canRemoveImage(imageIndex) возвраты false.
    
    IndexOutOfBoundsException - если imageIndex меньше чем 0 или больше чем самый большой доступный индекс.
    
    IOException - если ошибка ввода-вывода происходит во время удаления.
  - canWriteEmpty
```
public boolean canWriteEmpty()
                      throws IOException
```
    Возвраты true если писатель поддерживает запись полного потока изображения, состоящего из единственного изображения с неопределенными пиксельными значениями и связанными метаданными и миниатюрами к выводу. Пиксельные значения могут быть определены будущим, призывает replacePixels методы. Если вывод ImageOutputStream, его существующее содержание до тока ищет, позиция не влияются, и не должен быть читаемым или перезаписываемым.
    Реализация по умолчанию бросает IllegalStateException если вывод null, и иначе возвраты false.
    
    Возвраты:
    true если запись полного потока изображения с содержанием, которое будет определено позже, поддерживается.
    
    Броски:
    
    IllegalStateException - если вывод не был установлен.
    
    IOException - если ошибка ввода-вывода происходит во время запроса.
  - prepareWriteEmpty
```
public void prepareWriteEmpty(IIOMetadata streamMetadata,
                     ImageTypeSpecifier imageType,
                     int width,
                     int height,
                     IIOMetadata imageMetadata,
                     List<? extends BufferedImage> thumbnails,
                     ImageWriteParam param)
                       throws IOException
```
    Начинает запись полного потока изображения, состоя из единственного изображения с неопределенными пиксельными значениями и связанными метаданными и миниатюрами, к выводу. Пиксельные значения будут определены будущим, призывает replacePixels методы. Если вывод ImageOutputStream, его существующее содержание до тока ищет, позиция не влияются, и не должен быть читаемым или перезаписываемым.
    Запись не полна до звонка endWriteEmpty происходит. Звонки prepareReplacePixels, replacePixels, и endReplacePixels может произойти между звонками prepareWriteEmpty и endWriteEmpty. Однако, звонки prepareWriteEmpty не может быть вложен, и призывает prepareWriteEmpty и prepareInsertEmpty возможно, не вкрапляется.
    Если canWriteEmpty возвраты false, UnsupportedOperationException будет брошен.
    ImageWriteParam май дополнительно быть предоставленным, чтобы управлять записью. Если param null, запись по умолчанию param будет использоваться.
    Если предоставленный ImageWriteParam содержит дополнительные значения установки, не поддерживаемые этим писателем (например, прогрессивное кодирование или любые специфичные для формата настройки), они будут проигнорированы.
    Реализация по умолчанию бросает IllegalStateException если вывод null, и иначе броски UnsupportedOperationException.
    
    Параметры:
    streamMetadata - IIOMetadata объект, представляющий потоковые метаданные, или null использовать значения по умолчанию.
    imageType - ImageTypeSpecifier описание расположения изображения.
    width - ширина изображения.
    height - высота изображения.
    imageMetadata - IIOMetadata объект, представляющий метаданные изображения, или null.
    thumbnails - a 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 - если ошибка ввода-вывода происходит во время записи.
  - 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 - если ошибка ввода-вывода происходит во время записи.
  - 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 - если ошибка ввода-вывода происходит во время запроса.
  - 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, полнота потока должна быть и читаемой и writeable.
    Содержание изображения может быть предоставлено более позднее использование replacePixels метод. Вставка не полна до звонка endInsertEmpty происходит. Звонки prepareReplacePixels, replacePixels, и endReplacePixels может произойти между звонками prepareInsertEmpty и endInsertEmpty. Однако, звонки prepareInsertEmpty не может быть вложен, и призывает prepareWriteEmpty и prepareInsertEmpty возможно, не вкрапляется.
    Если canInsertEmpty(imageIndex) возвраты false, UnsupportedOperationException будет брошен.
    ImageWriteParam май дополнительно быть предоставленным, чтобы управлять записью. Если param null, запись по умолчанию param будет использоваться.
    Если предоставленный ImageWriteParam содержит дополнительные значения установки, не поддерживаемые этим писателем (например, прогрессивное кодирование или любые специфичные для формата настройки), они будут проигнорированы.
    Реализация по умолчанию бросает IllegalStateException если вывод null, и иначе броски UnsupportedOperationException.
    
    Параметры:
    imageIndex - индекс, по которому можно записать изображение.
    imageType - ImageTypeSpecifier описание расположения изображения.
    width - ширина изображения.
    height - высота изображения.
    imageMetadata - IIOMetadata объект, представляющий метаданные изображения, или null.
    thumbnails - a 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 - если ошибка ввода-вывода происходит во время записи.
  - 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 - если ошибка ввода-вывода происходит во время записи.
  - canReplacePixels
```
public boolean canReplacePixels(int imageIndex)
                         throws IOException
```
    Возвраты true если писатель позволяет пикселям данного изображения быть замененными, используя replacePixels методы.
    Писатель, который не поддерживает пиксельной замены, может возвратиться false не выполняя границы, проверяющие индекс.
    Реализация по умолчанию бросает IllegalStateException если вывод null, и иначе возвраты false не проверяя значение imageIndex.
    
    Параметры:
    imageIndex - индекс изображения, пиксели которого должны быть заменены.
    
    Возвраты:
    true если пиксели данного изображения могут быть заменены.
    
    Броски:
    
    IllegalStateException - если вывод не был установлен.
    
    IndexOutOfBoundsException - если писатель поддерживает пиксельную замену вообще, но imageIndex меньше чем 0 или больше чем самый большой доступный индекс.
    
    IOException - если ошибка ввода-вывода происходит во время запроса.
  - prepareReplacePixels
```
public void prepareReplacePixels(int imageIndex,
                        Rectangle region)
                          throws IOException
```
    Готовит писателя, чтобы обработать ряд звонков replacePixels методы. Пиксельная область, на которую влияют, будет отсечена против предоставленного
    Если canReplacePixels возвраты false, и UnsupportedOperationException будет брошен.
    Реализация по умолчанию бросает IllegalStateException если вывод null, и иначе броски UnsupportedOperationException.
    
    Параметры:
    imageIndex - индекс изображения, пиксели которого должны быть заменены.
    region - a Rectangle это будет использоваться, чтобы отсечь будущие пиксельные области.
    
    Броски:
    
    IllegalStateException - если вывод не был установлен.
    
    UnsupportedOperationException - если canReplacePixels(imageIndex) возвраты false.
    
    IndexOutOfBoundsException - если imageIndex меньше чем 0 или больше чем самый большой доступный индекс.
    
    IllegalStateException - если есть предыдущий звонок prepareReplacePixels без соответствующего звонка endReplacePixels (то есть, вложение не позволяется).
    
    IllegalArgumentException - если region null или имеет ширину или высоту меньше чем 1.
    
    IOException - если ошибка ввода-вывода происходит во время подготовки.
  - replacePixels
```
public void replacePixels(RenderedImage image,
                 ImageWriteParam param)
                   throws IOException
```
    Заменяет часть изображения, уже существующего в выводе с частью данного изображения. Данные изображения должны соответствовать, или быть конвертируемыми к, расположение изображения существующего изображения.
    Целевая область определяется в param параметр, и будет отсечен к границам изображения и области, предоставленной prepareReplacePixels. По крайней мере один пиксель источника не должен быть отсечен, или исключение выдается.
    ImageWriteParam май дополнительно быть предоставленным, чтобы управлять записью. Если param null, запись по умолчанию param будет использоваться.
    Если предоставленный ImageWriteParam содержит дополнительные значения установки, не поддерживаемые этим писателем (например, прогрессивное кодирование или любые специфичные для формата настройки), они будут проигнорированы.
    Этот метод можно только вызвать после звонка prepareReplacePixels, или иначе IllegalStateException будет брошен.
    Реализация по умолчанию бросает IllegalStateException если вывод null, и иначе броски UnsupportedOperationException.
    Параметры:
    image - a RenderedImage содержа исходные пиксели.
    param - ImageWriteParam, или null использовать значение по умолчанию ImageWriteParam.
    
    Броски:
    
    IllegalStateException - если вывод не был установлен.
    
    UnsupportedOperationException - если canReplacePixels(imageIndex) возвраты false.
    
    IllegalStateException - если нет никакого предыдущего звонка prepareReplacePixels без соответствующего звонка endReplacePixels.
    IllegalArgumentException - если какое-либо следующее является истиной:
    
    image null.
    param null.
    пересеченная область не содержит по крайней мере один пиксель.
    расположение image не соответствует, или этот писатель не может преобразовать это в, существующее расположение изображения.
    IOException - если ошибка ввода-вывода происходит во время записи.
  - replacePixels
```
public void replacePixels(Raster raster,
                 ImageWriteParam param)
                   throws IOException
```
    Заменяет часть изображения, уже существующего в выводе с частью данного Raster. Данные изображения должны соответствовать, или быть конвертируемыми к, расположение изображения существующего изображения.
    ImageWriteParam май дополнительно быть предоставленным, чтобы управлять записью. Если param null, запись по умолчанию param будет использоваться.
    Целевая область определяется в param параметр, и будет отсечен к границам изображения и области, предоставленной prepareReplacePixels. По крайней мере один пиксель источника не должен быть отсечен, или исключение выдается.
    Если предоставленный ImageWriteParam содержит дополнительные значения установки, не поддерживаемые этим писателем (например, прогрессивное кодирование или любые специфичные для формата настройки), они будут проигнорированы.
    Этот метод можно только вызвать после звонка prepareReplacePixels, или иначе IllegalStateException будет брошен.
    Реализация по умолчанию бросает IllegalStateException если вывод null, и иначе броски UnsupportedOperationException.
    Параметры:
    raster - a Raster содержа исходные пиксели.
    param - ImageWriteParam, или null использовать значение по умолчанию ImageWriteParam.
    
    Броски:
    
    IllegalStateException - если вывод не был установлен.
    
    UnsupportedOperationException - если canReplacePixels(imageIndex) возвраты false.
    
    IllegalStateException - если нет никакого предыдущего звонка prepareReplacePixels без соответствующего звонка endReplacePixels.
    
    UnsupportedOperationException - если canWriteRasters возвраты false.
    IllegalArgumentException - если какое-либо следующее является истиной:
    
    raster null.
    param null.
    пересеченная область не содержит по крайней мере один пиксель.
    расположение raster не соответствует, или этот писатель не может преобразовать это в, существующее расположение изображения.
    IOException - если ошибка ввода-вывода происходит во время записи.
  - endReplacePixels
```
public void endReplacePixels()
                      throws IOException
```
    Завершает последовательность звонков replacePixels.
    Если canReplacePixels возвраты false, и UnsupportedOperationException будет брошен.
    Реализация по умолчанию бросает IllegalStateException если вывод null, и иначе броски UnsupportedOperationException.
    
    Броски:
    
    IllegalStateException - если вывод не был установлен.
    
    UnsupportedOperationException - если canReplacePixels(imageIndex) возвраты false.
    
    IllegalStateException - если нет никакого предыдущего звонка prepareReplacePixels без соответствующего звонка endReplacePixels.
    
    IOException - если ошибка ввода-вывода происходит во время записи.
  - аварийное прекращение работы
```
public void abort()
```
    Запросы, что любая текущая операция записи быть прерванным. Содержание вывода после аварийного прекращения работы будет неопределено.
    Писатели должны вызвать clearAbortRequest в начале каждой операции записи, и опроса значение abortRequested регулярно во время записи.
  - abortRequested
```
protected boolean abortRequested()
```
    Возвраты true если с просьбой, чтобы прервать текущую операцию записи обратились, так как писатель инстанцировали или 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)
```
    Широковещательно передает запуск изображения, пишут во все зарегистрированные IIOWriteProgressListeners, вызывая их imageStarted метод. Подклассы могут использовать этот метод в качестве удобства.
    
    Параметры:
    imageIndex - индекс изображения, собирающегося быть записанным.
  - processImageProgress
```
protected void processImageProgress(float percentageDone)
```
    Широковещательно передает текущий процент завершения изображения ко всем зарегистрированным IIOWriteProgressListeners, вызывая их imageProgress метод. Подклассы могут использовать этот метод в качестве удобства.
    
    Параметры:
    percentageDone - текущий процент завершения, как a 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 - текущий процент завершения, как a 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 - предупреждающее сообщение.
    
    Броски:
    
    IllegalArgumentException - если warning null.
  - processWarningOccurred
```
protected void processWarningOccurred(int imageIndex,
                          String baseName,
                          String keyword)
```
    Широковещательно передает локализованное предупреждающее сообщение ко всем зарегистрированным IIOWriteWarningListeners, вызывая их warningOccurred метод со строкой, взятой от a ResourceBundle. Подклассы могут использовать этот метод в качестве удобства.
    
    Параметры:
    imageIndex - индекс изображения, на котором произошло предупреждение.
    baseName - базовое имя ряда ResourceBundles содержащий локализованные предупреждающие сообщения.
    keyword - ключевое слово, используемое, чтобы индексировать предупреждающее сообщение в пределах набора ResourceBundles.
    
    Броски:
    
    IllegalArgumentException - если baseName null.
    
    IllegalArgumentException - если keyword null.
    
    IllegalArgumentException - если не приспосабливают ResourceBundle может быть расположен.
    
    IllegalArgumentException - если именованный ресурс не находится в расположенном ResourceBundle.
    
    IllegalArgumentException - если объект, полученный от ResourceBundle не a String.
  - сброс
```
public void reset()
```
    Восстановления ImageWriter к его начальному состоянию.
    Вызовы реализации по умолчанию setOutput(null), setLocale(null), removeAllIIOWriteWarningListeners(), removeAllIIOWriteProgressListeners(), и clearAbortRequest.
  - расположить
```
public void dispose()
```
    Позволяет любые ресурсы, которые, как сохранил этот объект, были выпущены. Результат вызова любого другого метода (кроме finalize) последующий за звонком в этот метод неопределено.
    Для приложений важно вызвать этот метод, когда они будут знать, что больше не будут использовать это ImageWriter. Иначе, писатель может продолжать держаться за ресурсы неопределенно.
    Реализация по умолчанию этого метода в суперклассе ничего не делает. Реализации подкласса должны гарантировать, что все средства, особенно собственные ресурсы, высвобождаются.

Представьте ошибку или функцию
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2011, Oracle и/или его филиалы. Все права защищены.

Класс ImageWriter

Полевая Сводка

Сводка конструктора

Сводка метода

Методы java.lang унаследованный от класса. Объект

Полевая Деталь

originatingProvider

вывод

availableLocales

локаль

warningListeners

warningLocales

progressListeners

Деталь конструктора

ImageWriter

Деталь метода

getOriginatingProvider

setOutput

getOutput

getAvailableLocales

setLocale

getLocale

getDefaultWriteParam

getDefaultStreamMetadata

getDefaultImageMetadata

convertStreamMetadata

convertImageMetadata

getNumThumbnailsSupported

getPreferredThumbnailSizes

canWriteRasters

записать

записать

записать

canWriteSequence

prepareWriteSequence

writeToSequence

endWriteSequence

canReplaceStreamMetadata

replaceStreamMetadata

canReplaceImageMetadata

replaceImageMetadata

canInsertImage

writeInsert

canRemoveImage

removeImage

canWriteEmpty

prepareWriteEmpty

endWriteEmpty

canInsertEmpty

prepareInsertEmpty

endInsertEmpty

canReplacePixels

prepareReplacePixels

replacePixels

replacePixels

endReplacePixels

аварийное прекращение работы

abortRequested

clearAbortRequest

addIIOWriteWarningListener

removeIIOWriteWarningListener

removeAllIIOWriteWarningListeners

addIIOWriteProgressListener

removeIIOWriteProgressListener

removeAllIIOWriteProgressListeners

processImageStarted

processImageProgress

processImageComplete

processThumbnailStarted

processThumbnailProgress

processThumbnailComplete

processWriteAborted

processWarningOccurred

processWarningOccurred

сброс

расположить