Интерфейс IIOWriteProgressListener

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

public interface IIOWriteProgressListener extends EventListener

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

См. также:

Краткое описание методов

Модификатор и тип	Метод	Описание
`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, 2025, 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.
https://download.java.net/java/early_access/jdk24/docs/api/java.desktop/javax/imageio/event/IIOWriteProgressListener.html