Интерфейс IIOWriteProgressListener

Все суперинтерфейсы:: EventListener

public interface IIOWriteProgressListener
extends EventListener

Интерфейс, используемый реализациями ImageWriter для уведомления вызывающих сторон о прогрессе методов записи изображений.

См. также:: ImageWriter.write(javax.imageio.metadata.IIOMetadata, javax.imageio.IIOImage, javax.imageio.ImageWriteParam)

Методы

Модификатор и тип	Метод	Описание
`void`	`imageComplete(ImageWriter source)`	Сообщает, что операция записи изображения завершена.
`void`	`imageProgress(ImageWriter source, float percentageDone)`	Сообщает приблизительную степень завершения текущего вызова `write` в рамках связанного `ImageWriter`.
`void`	`imageStarted(ImageWriter source, int imageIndex)`	Сообщает, что операция записи изображения началась.
`void`	`thumbnailComplete(ImageWriter source)`	Сообщает, что операция записи миниатюры завершена.
`void`	`thumbnailProgress(ImageWriter source, float percentageDone)`	Сообщает приблизительную степень завершения текущей записи миниатюры в рамках связанного `ImageWriter`.
`void`	`thumbnailStarted(ImageWriter source, int imageIndex, int thumbnailIndex)`	Сообщает, что операция записи миниатюры началась.
`void`	`writeAborted(ImageWriter source)`	Сообщает, что запись была прервана через метод `abort` записывателя.

Методы

imageStarted

void imageStarted(ImageWriter source,
                  int imageIndex)

Сообщает, что операция записи изображения началась. Все реализации ImageWriter обязаны вызвать этот метод ровно один раз при начале операции записи изображения.

Параметры:: source - объект ImageWriter, вызывающий этот метод.; imageIndex - индекс изображения, записываемого внутри содержащего его входного файла или потока.

imageProgress

void imageProgress(ImageWriter source,
                   float percentageDone)

Сообщает приблизительную степень завершения текущего вызова write в рамках связанного ImageWriter.

Степень завершения выражается в виде индекса, указывающего, какое изображение записывается, и процента, изменяющегося от 0.0F до 100.0F и указывающего, сколько текущего изображения было выведено. Процент желательно рассчитывать относительно оставшегося времени до завершения, но обычно практичнее использовать более определённый показатель, такой как количество декодированных пикселей или часть потреблённого входного потока. В любом случае, последовательность вызовов этого метода во время данной операции чтения должна давать монотонно возрастающую последовательность значений процентов. Не обязательно предоставлять точные значения 0 и 100, так как они могут быть выведены вызывающей стороной из других методов.

Каждая реализация ImageWriter может вызывать этот метод с любой частотой. Правило большого пальца — вызывать его примерно каждые 5 процентов.

Параметры:: source - объект ImageWriter, вызывающий этот метод.; percentageDone - приблизительный процент завершённого декодирования.

imageComplete

void imageComplete(ImageWriter source)

Сообщает, что операция записи изображения завершена. Все реализации ImageWriter обязаны вызвать этот метод ровно один раз по завершении каждой операции записи изображения.

Параметры:: source - объект ImageWriter, вызывающий этот метод.

thumbnailStarted

void thumbnailStarted(ImageWriter source,
                      int imageIndex,
                      int thumbnailIndex)

Сообщает, что операция записи миниатюры началась. Все реализации ImageWriter обязаны вызвать этот метод ровно один раз при начале операции записи миниатюры.

Параметры:: source - объект ImageWrite, вызывающий этот метод.; imageIndex - индекс изображения, записываемого внутри содержащего его входного файла или потока.; thumbnailIndex - индекс миниатюры, записываемой.

thumbnailProgress

void thumbnailProgress(ImageWriter source,
                       float percentageDone)

Сообщает приблизительную степень завершения текущей записи миниатюры в рамках связанного ImageWriter. Семантика идентична семантике imageProgress.

Параметры:: source - объект ImageWriter, вызывающий этот метод.; percentageDone - приблизительный процент завершённого декодирования.

thumbnailComplete

void thumbnailComplete(ImageWriter source)

Сообщает, что операция записи миниатюры завершена. Все реализации ImageWriter обязаны вызвать этот метод ровно один раз по завершении каждой операции записи миниатюры.

Параметры:: source - объект ImageWriter, вызывающий этот метод.

writeAborted

void writeAborted(ImageWriter source)

Сообщает, что запись была прервана через метод abort записывателя. Дальнейшие уведомления не будут предоставлены.

Параметры:: source - объект ImageWriter, вызывающий этот метод.