Интерфейс 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, вызывающий этот метод.

© 1993, 2020, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.