Spec-Zone .ru
спецификации, руководства, описания, API
|
public abstract class ImageWriter extends Object implements ImageTranscoder
ImageWriter
объекты обычно инстанцирует поставщик услуг class для определенного формата. Классы поставщика услуг регистрируются в 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)
Добавляет единственное изображение и возможно связанные метаданные и миниатюры, к выводу.
|
protected ImageWriterSpi originatingProvider
ImageWriterSpi
это инстанцировало этого объекта, или null
если его идентификационные данные не известны, или ни один не существует. По умолчанию это инициализируется к null
.protected Object output
ImageOutputStream
или другой Object
установленный setOutput
и полученный getOutput
. По умолчанию это инициализируется к null
.protected Locale[] availableLocales
Locale
s, который может использоваться, чтобы локализовать предупреждающие сообщения и значения установки сжатия, или null
если локализация не поддерживается. По умолчанию это инициализируется к null
.protected Locale locale
Locale
использоваться для локализации, или null
если ни один не был установлен. По умолчанию это инициализируется к null
.protected List<IIOWriteWarningListener> warningListeners
List
из в настоящий момент зарегистрированного IIOWriteWarningListener
s, инициализированный по умолчанию к null
, который синонимичен с пустым List
.protected List<Locale> warningLocales
List
из Locale
s, один для каждого элемента warningListeners
, инициализированный по умолчанию null
, который синонимичен с пустым List
.protected List<IIOWriteProgressListener> progressListeners
List
из в настоящий момент зарегистрированного IIOWriteProgressListener
s, инициализированный по умолчанию null
, который синонимичен с пустым List
.protected ImageWriter(ImageWriterSpi originatingProvider)
ImageWriter
и наборы originatingProvider
переменная экземпляра к предоставленному значению. Подклассы, которые используют расширения, должны предоставить конструктору подпись (ImageWriterSpi, Object)
чтобы получить объект расширения. Если объект расширения является неподходящим, IllegalArgumentException
должен быть брошен.
originatingProvider
- ImageWriterSpi
это создает этот объект, или null
.public ImageWriterSpi getOriginatingProvider()
ImageWriterSpi
возразите, что создал это ImageWriter
, или null
если этот объект не создавался через IIORegistry
. Реализация по умолчанию возвращает значение originatingProvider
переменная экземпляра.
ImageWriterSpi
, или null
.ImageWriterSpi
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()
public Object getOutput()
ImageOutputStream
или другой Object
установленный новым звонком setOutput
метод. Если никакое место назначения не было установлено, null
возвращается. Реализация по умолчанию возвращает значение output
переменная экземпляра.
Object
это было определено, используя setOutput
, или null
.setOutput(java.lang.Object)
public Locale[] getAvailableLocales()
Locale
s, который может использоваться, чтобы локализовать предупреждение настройки сжатия и слушатели. Возвращаемое значение null
указывает, что локализация не поддерживается. Реализация по умолчанию возвращает клона availableLocales
переменная экземпляра, если это не -null
, или иначе возвраты null
.
Locale
s, который может использоваться в качестве параметров setLocale
, или null
.public void setLocale(Locale locale)
Locale
из этого ImageWriter
к данному значению. Значение null
удаляет любую предыдущую установку, и указывает, что писатель должен локализовать, как она считает целесообразным. Проверки реализации по умолчанию locale
против значений, возвращенных getAvailableLocales
, и наборы locale
переменная экземпляра, если это находится. Если locale
null
, переменная экземпляра устанавливается в null
без любой проверки.
locale
- требуемый Locale
, или null
.IllegalArgumentException
- если locale
не -null
но не одно из значений, возвращенных getAvailableLocales
.getLocale()
public Locale getLocale()
Locale
, или null
если ни один не был установлен. Реализация по умолчанию возвращает значение locale
переменная экземпляра.
Locale
, или null
.setLocale(java.util.Locale)
public ImageWriteParam getDefaultWriteParam()
ImageWriteParam
объект соответствующего типа для этого формата файла, содержащего значения по умолчанию, то есть, те значения, которые использовались бы если нет ImageWriteParam
объект был определен. Это полезно как начальная точка для того, чтобы настроило только несколько параметров и иначе оставило настройки по умолчанию в покое. Реализация по умолчанию создает и возвращает новое ImageWriteParam
объект, который не позволяет размещать рядом, прогрессивное кодирование, или сжатие, и это будет локализовано для тока Locale
(то есть, что Вы получили бы, вызывая new ImageWriteParam(getLocale())
.
Отдельные плагины могут возвратить экземпляр ImageWriteParam
с дополнительными дополнительными функциями, включенными, или они могут возвратить экземпляр сменного определенного подкласса ImageWriteParam
.
ImageWriteParam
объект, содержащий значения по умолчанию.public abstract IIOMetadata getDefaultStreamMetadata(ImageWriteParam param)
IIOMetadata
объект, содержащий значения по умолчанию для того, чтобы закодировать поток изображений. Содержанием объекта можно управлять, используя любого древовидная структура XML, возвращенная IIOMetadata.getAsTree
метод, IIOMetadataController
объект, или через сменные определенные интерфейсы, и получающиеся данные, снабженные к одному из write
методы, которые берут потоковый параметр метаданных. Дополнительное ImageWriteParam
может быть предоставлен для случаев, где это может влиять на структуру потоковых метаданных.
Если предоставленный ImageWriteParam
содержит дополнительные значения установки, не поддерживаемые этим писателем (например, прогрессивное кодирование или любые специфичные для формата настройки), они будут проигнорированы.
Писатели, которые не используют потоковые метаданные (например, писатели для единственных форматов изображения) должны возвратиться null
.
param
- ImageWriteParam
это будет использоваться, чтобы закодировать изображение, или null
.IIOMetadata
объект.public abstract IIOMetadata getDefaultImageMetadata(ImageTypeSpecifier imageType, ImageWriteParam param)
IIOMetadata
объект, содержащий значения по умолчанию для того, чтобы закодировать изображение данного типа. Содержанием объекта можно управлять, используя любого древовидная структура XML, возвращенная IIOMetadata.getAsTree
метод, IIOMetadataController
объект, или через сменные определенные интерфейсы, и получающиеся данные, снабженные к одному из write
методы, которые берут потоковый параметр метаданных. Дополнительное ImageWriteParam
может быть предоставлен для случаев, где это может влиять на структуру метаданных изображения.
Если предоставленный ImageWriteParam
содержит дополнительные значения установки, не поддерживаемые этим писателем (например, прогрессивное кодирование или любые специфичные для формата настройки), они будут проигнорированы.
imageType
- ImageTypeSpecifier
указание на формат изображения, которое будет записано позже.param
- ImageWriteParam
это будет использоваться, чтобы закодировать изображение, или null
.IIOMetadata
объект.public abstract IIOMetadata convertStreamMetadata(IIOMetadata inData, ImageWriteParam param)
ImageTranscoder
IIOMetadata
объект, который может использоваться для кодирования и дополнительно изменил использование его интерфейсов документа или других интерфейсов, определенных для плагина писателя, который будет использоваться для того, чтобы закодировать. Дополнительное ImageWriteParam
может быть предоставлен для случаев, где это может влиять на структуру потоковых метаданных.
Если предоставленный ImageWriteParam
содержит дополнительные значения установки, не понятые под этим писателем или транскодером, они будут проигнорированы.
convertStreamMetadata
в интерфейсе ImageTranscoder
inData
- IIOMetadata
объект, представляющий потоковые метаданные, используемые, чтобы инициализировать состояние возвращенного объекта.param
- ImageWriteParam
это будет использоваться, чтобы закодировать изображение, или null
.IIOMetadata
объект, или null
если плагин не обеспечивает возможности кодирования метаданных.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
если плагин не обеспечивает возможности кодирования метаданных.public int getNumThumbnailsSupported(ImageTypeSpecifier imageType, ImageWriteParam param, IIOMetadata streamMetadata, IIOMetadata imageMetadata)
-1
указывает, что недостаточная информация доступна. ImageWriteParam
май дополнительно быть предоставленным для случаев, где это может влиять на обработку миниатюры.
Если предоставленный ImageWriteParam
содержит дополнительные значения установки, не поддерживаемые этим писателем (например, прогрессивное кодирование или любые специфичные для формата настройки), они будут проигнорированы.
Реализация по умолчанию возвращается 0.
imageType
- ImageTypeSpecifier
указание на тип изображения, которое будет записано, или null
.param
- ImageWriteParam
это будет использоваться для того, чтобы записать, или null
.streamMetadata
- IIOMetadata
объект, который будет использоваться для того, чтобы записать, или null
.imageMetadata
- IIOMetadata
объект, который будет использоваться для того, чтобы записать, или null
.-1
если недостаточная информация доступна.public Dimension[] getPreferredThumbnailSizes(ImageTypeSpecifier imageType, ImageWriteParam param, IIOMetadata streamMetadata, IIOMetadata imageMetadata)
Dimension
s указание на юридический размер располагается для изображений миниатюры, поскольку они будут закодированы в выходном файле или потоке. Эта информация является просто консультативной; писатель изменит размеры любых предоставленных миниатюр по мере необходимости. Информация возвращается как ряд пар; первый элемент пары содержит (содержащий) минимальный width и height, и второй элемент содержит (содержащий) максимальный width и height. Вместе, каждая пара определяет допустимый диапазон размеров. Чтобы определить фиксированный размер, тот же самый width и height появятся для обоих элементов. Возвращаемое значение null
указывает, что размер произволен или неизвестен.
ImageWriteParam
май дополнительно быть предоставленным для случаев, где это может влиять на обработку миниатюры.
Если предоставленный ImageWriteParam
содержит дополнительные значения установки, не поддерживаемые этим писателем (например, прогрессивное кодирование или любые специфичные для формата настройки), они будут проигнорированы.
Возвраты реализации по умолчанию null
.
imageType
- ImageTypeSpecifier
указание на тип изображения, которое будет записано, или null
.param
- ImageWriteParam
это будет использоваться для того, чтобы записать, или null
.streamMetadata
- IIOMetadata
объект, который будет использоваться для того, чтобы записать, или null
.imageMetadata
- IIOMetadata
объект, который будет использоваться для того, чтобы записать, или null
.Dimension
s с даже длиной по крайней мере двух, или null
.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
- если ошибка происходит во время записи.public boolean canWriteSequence()
true
если писатель в состоянии добавить изображение к потоку изображения, который уже содержит информацию о заголовке и возможно предшествующие изображения. Если canWriteSequence
возвраты false
, writeToSequence
и endWriteSequence
бросит UnsupportedOperationException
.
Возвраты реализации по умолчанию false
.
true
если изображения могут быть добавлены последовательно.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
- если ошибка происходит, пишущий потоковые метаданные.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
- если ошибка происходит во время записи.public void endWriteSequence() throws IOException
prepareWriteSequence
. Любые потоковые метаданные, которые должны прибыть в конце последовательности изображений, выписываются, и любая информация о заголовке в начале последовательности исправляется в случае необходимости. Если вывод ImageOutputStream
, данные через потоковые метаданные в конце последовательности сбрасываются и не должны быть читаемыми или перезаписываемыми. Если canWriteSequence
возвраты false
, этот метод бросит UnsupportedOperationException
.
Реализация по умолчанию бросает IllegalStateException
если вывод null
, и иначе броски UnsupportedOperationException
.
IllegalStateException
- если вывод не был установлен, или prepareWriteSequence
не был вызван.UnsupportedOperationException
- если canWriteSequence
возвраты false
.IOException
- если ошибка происходит во время записи.public boolean canReplaceStreamMetadata() throws IOException
true
если возможно заменить потоковые метаданные, уже существующие в выводе. Реализация по умолчанию бросает IllegalStateException
если вывод null
, и иначе возвраты false
.
true
если замена потоковых метаданных позволяется.IllegalStateException
- если вывод не был установлен.IOException
- если ошибка ввода-вывода происходит во время запроса.public void replaceStreamMetadata(IIOMetadata streamMetadata) throws IOException
ImageOutputStream
, предшествующее содержание потока исследуется и возможно редактируется, чтобы создать место для новых данных. Все предшествующее содержание вывода должно быть доступным для чтения и записи. Если canReplaceStreamMetadata
возвраты false
, UnsupportedOperationException
будет брошен.
Реализация по умолчанию бросает IllegalStateException
если вывод null
, и иначе броски UnsupportedOperationException
.
streamMetadata
- IIOMetadata
объект, представляющий потоковые метаданные, или null
использовать значения по умолчанию.IllegalStateException
- если вывод не был установлен.UnsupportedOperationException
- если canReplaceStreamMetadata
возвраты false
. режимы не включаютIOException
- если ошибка происходит во время записи.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
- если ошибка ввода-вывода происходит во время запроса.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
- если ошибка происходит во время записи.public boolean canInsertImage(int imageIndex) throws IOException
true
если писатель поддерживает вставку нового изображения в данном, индексируют. Существующие изображения с индексами, больше чем или равный вставке, индексируют, увеличат их индексы 1. Значение для imageIndex
из -1
может использоваться, чтобы показать индексирование одного большего, чем самый большой ток индексирует. Писатель, который не поддерживает вставки изображения, может возвратиться false
не выполняя границы, проверяющие индексирование.
Реализация по умолчанию бросает IllegalStateException
если вывод null
, и иначе возвраты false
withour проверка значения imageIndex
.
imageIndex
- индексирование, при котором должно быть вставлено изображение.true
если изображение может быть вставлено в данном, индексируют.IllegalStateException
- если вывод не был установлен.IndexOutOfBoundsException
- если писатель поддерживает вставку изображения вообще, но imageIndex
меньше чем-1 или больше, чем самые большие доступные индексируют.IOException
- если ошибка ввода-вывода происходит во время запроса.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
- если ошибка происходит во время записи.public boolean canRemoveImage(int imageIndex) throws IOException
true
если писатель поддерживает удаление существующего изображения в данном, индексируют. Существующие изображения с индексами, больше чем вставка, индексируют, уменьшат их индексы 1. Писатель, который не поддерживает удаления изображения, может возвратиться false
не выполняя границы, проверяющие индексирование.
Реализация по умолчанию бросает IllegalStateException
если вывод null
, и иначе возвраты false
не проверяя значение imageIndex
.
imageIndex
- индексирование изображения, которое будет удалено.true
если возможно удалить данное изображение.IllegalStateException
- если вывод не был установлен.IndexOutOfBoundsException
- если писатель поддерживает удаление изображения вообще, но imageIndex
меньше чем 0 или больше, чем самые большие доступные индексируют.IOException
- если ошибка ввода-вывода происходит во время запроса.public void removeImage(int imageIndex) throws IOException
Если canRemoveImage(imageIndex)
возвращает false, UnsupportedOperationException
будет брошен.
Удаление может или, возможно, не вызывает сокращение фактического размера файла.
Реализация по умолчанию бросает IllegalStateException
если вывод null
, и иначе броски UnsupportedOperationException
.
imageIndex
- индексирование изображения, которое будет удалено.IllegalStateException
- если вывод не был установлен.UnsupportedOperationException
- если canRemoveImage(imageIndex)
возвраты false
.IndexOutOfBoundsException
- если imageIndex
меньше чем 0 или больше, чем самые большие доступные индексируют.IOException
- если ошибка ввода-вывода происходит во время удаления.public boolean canWriteEmpty() throws IOException
true
если писатель поддерживает запись полного потока изображения, состоящего из единственного изображения с неопределенными пиксельными значениями и связанными метаданными и миниатюрами к выводу. Пиксельные значения могут быть определены будущим, призывает replacePixels
методы. Если вывод ImageOutputStream
, его существующее содержание до тока ищет, позиция не влияются, и не должен быть читаемым или перезаписываемым. Реализация по умолчанию бросает IllegalStateException
если вывод null
, и иначе возвраты false
.
true
если запись полного потока изображения с содержанием, которое будет определено позже, поддерживается.IllegalStateException
- если вывод не был установлен.IOException
- если ошибка ввода-вывода происходит во время запроса.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
- width изображения.height
- 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
ссылки или объекты кроме BufferedImage
s.IllegalArgumentException
- если width или height - меньше чем 1.IOException
- если ошибка ввода-вывода происходит во время записи.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
- если ошибка ввода-вывода происходит во время записи.public boolean canInsertEmpty(int imageIndex) throws IOException
true
если писатель поддерживает вставку нового, пустого изображения в данном, индексируют. Пиксельные значения изображения неопределены, и могут быть определены в частях, используя replacePixels
методы. Существующие изображения с индексами, больше чем или равный вставке, индексируют, увеличат их индексы 1. Значение для imageIndex
из -1
может использоваться, чтобы показать индексирование одного большего, чем самый большой ток индексирует. Писатель, который не поддерживает вставку пустых изображений, может возвратиться false
не выполняя границы, проверяющие индексирование.
Реализация по умолчанию бросает IllegalStateException
если вывод null
, и иначе возвраты false
не проверяя значение imageIndex
.
imageIndex
- индексирование, при котором должно быть вставлено изображение.true
если пустое изображение может быть вставлено в данном, индексируют.IllegalStateException
- если вывод не был установлен.IndexOutOfBoundsException
- если писатель поддерживает пустую вставку изображения вообще, но imageIndex
меньше чем-1 или больше, чем самые большие доступные индексируют.IOException
- если ошибка ввода-вывода происходит во время запроса.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
- width изображения.height
- 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
ссылки или объекты кроме BufferedImage
s.IllegalArgumentException
- если width или height - меньше чем 1.IOException
- если ошибка ввода-вывода происходит во время записи.public void endInsertEmpty() throws IOException
prepareInsertEmpty
. Реализация по умолчанию бросает IllegalStateException
если вывод null
, и иначе броски UnsupportedOperationException
.
IllegalStateException
- если вывод не был установлен.UnsupportedOperationException
- если canInsertEmpty(imageIndex)
возвраты false
.IllegalStateException
- если предыдущий звонок prepareInsertEmpty
без соответствующего звонка endInsertEmpty
не был сделан.IllegalStateException
- если предыдущий звонок prepareWriteEmpty
без соответствующего звонка endWriteEmpty
был сделан.IllegalStateException
- если звонок prepareReplacePixels
был сделан без соответствующего звонка endReplacePixels
.IOException
- если ошибка ввода-вывода происходит во время записи.public boolean canReplacePixels(int imageIndex) throws IOException
true
если писатель позволяет пикселям данного изображения быть замененными, используя replacePixels
методы. Писатель, который не поддерживает пиксельной замены, может возвратиться false
не выполняя границы, проверяющие индексирование.
Реализация по умолчанию бросает IllegalStateException
если вывод null
, и иначе возвраты false
не проверяя значение imageIndex
.
imageIndex
- индексирование изображения, пиксели которого должны быть заменены.true
если пиксели данного изображения могут быть заменены.IllegalStateException
- если вывод не был установлен.IndexOutOfBoundsException
- если писатель поддерживает пиксельную замену вообще, но imageIndex
меньше чем 0 или больше, чем самые большие доступные индексируют.IOException
- если ошибка ввода-вывода происходит во время запроса.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
или имеет width или height меньше чем 1.IOException
- если ошибка ввода-вывода происходит во время подготовки.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
- если ошибка ввода-вывода происходит во время записи.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
- если ошибка ввода-вывода происходит во время записи.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
регулярно во время записи.
protected boolean abortRequested()
true
если с просьбой, чтобы прервать текущую операцию записи обратились, так как писатель инстанцировали или clearAbortRequest
был вызван.true
если текущая операция записи должна быть прервана.abort()
, clearAbortRequest()
protected void clearAbortRequest()
abortRequested
возвратится false
.abort()
, abortRequested()
public void addIIOWriteWarningListener(IIOWriteWarningListener listener)
IIOWriteWarningListener
к списку зарегистрированных слушателей предупреждения. Если listener
null
, никакое исключение не будет выдано, и никакие меры не будут предприняты. Сообщения, отправленные данному слушателю, будут локализованы, если возможный, чтобы соответствовать ток Locale
. Если нет Locale
был установлен, предупреждающие сообщения могут быть локализованы, поскольку писатель считает целесообразным.listener
- IIOWriteWarningListener
быть зарегистрированным.removeIIOWriteWarningListener(javax.imageio.event.IIOWriteWarningListener)
public void removeIIOWriteWarningListener(IIOWriteWarningListener listener)
IIOWriteWarningListener
от списка зарегистрированных слушателей предупреждения. Если слушатель не был ранее зарегистрирован, или если listener
null
, никакое исключение не будет выдано, и никакие меры не будут предприняты.listener
- IIOWriteWarningListener
быть вычеркнутым из списка.addIIOWriteWarningListener(javax.imageio.event.IIOWriteWarningListener)
public void removeAllIIOWriteWarningListeners()
IIOWriteWarningListener
объекты. Реализация по умолчанию устанавливает warningListeners
и warningLocales
переменные экземпляра к null
.
public void addIIOWriteProgressListener(IIOWriteProgressListener listener)
IIOWriteProgressListener
к списку зарегистрированных слушателей продвижения. Если listener
null
, никакое исключение не будет выдано, и никакие меры не будут предприняты.listener
- IIOWriteProgressListener
быть зарегистрированным.removeIIOWriteProgressListener(javax.imageio.event.IIOWriteProgressListener)
public void removeIIOWriteProgressListener(IIOWriteProgressListener listener)
IIOWriteProgressListener
от списка зарегистрированных слушателей продвижения. Если слушатель не был ранее зарегистрирован, или если listener
null
, никакое исключение не будет выдано, и никакие меры не будут предприняты.listener
- IIOWriteProgressListener
быть вычеркнутым из списка.addIIOWriteProgressListener(javax.imageio.event.IIOWriteProgressListener)
public void removeAllIIOWriteProgressListeners()
IIOWriteProgressListener
объекты. Реализация по умолчанию устанавливает progressListeners
переменная экземпляра к null
.
protected void processImageStarted(int imageIndex)
IIOWriteProgressListener
s, вызывая их imageStarted
метод. Подклассы могут использовать этот метод в качестве удобства.imageIndex
- индексирование изображения, собирающегося быть записанным.protected void processImageProgress(float percentageDone)
IIOWriteProgressListener
s, вызывая их imageProgress
метод. Подклассы могут использовать этот метод в качестве удобства.percentageDone
- текущий процент завершения, как a float
.protected void processImageComplete()
IIOWriteProgressListener
s, вызывая их imageComplete
метод. Подклассы могут использовать этот метод в качестве удобства.protected void processThumbnailStarted(int imageIndex, int thumbnailIndex)
IIOWriteProgressListener
s, вызывая их thumbnailStarted
метод. Подклассы могут использовать этот метод в качестве удобства.imageIndex
- индексирование изображения связалось с миниатюрой.thumbnailIndex
- индексирование миниатюры.protected void processThumbnailProgress(float percentageDone)
IIOWriteProgressListener
s, вызывая их thumbnailProgress
метод. Подклассы могут использовать этот метод в качестве удобства.percentageDone
- текущий процент завершения, как a float
.protected void processThumbnailComplete()
IIOWriteProgressListener
s, вызывая их thumbnailComplete
метод. Подклассы могут использовать этот метод в качестве удобства.protected void processWriteAborted()
IIOWriteProgressListener
s, вызывая их writeAborted
метод. Подклассы могут использовать этот метод в качестве удобства.protected void processWarningOccurred(int imageIndex, String warning)
IIOWriteWarningListener
s, вызывая их warningOccurred
метод. Подклассы могут использовать этот метод в качестве удобства.imageIndex
- индексирование изображения, на котором произошло предупреждение.warning
- предупреждающее сообщение.IllegalArgumentException
- если warning
null
.protected void processWarningOccurred(int imageIndex, String baseName, String keyword)
IIOWriteWarningListener
s, вызывая их warningOccurred
метод со строкой, взятой от a ResourceBundle
. Подклассы могут использовать этот метод в качестве удобства.imageIndex
- индексирование изображения, на котором произошло предупреждение.baseName
- базовое имя ряда ResourceBundle
s содержащий локализованные предупреждающие сообщения.keyword
- ключевое слово, используемое, чтобы индексировать предупреждающее сообщение в пределах набора ResourceBundle
s.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, 2013, Oracle и/или его филиалы. Все права защищены.
Проект сборка-b92