Интерфейс 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, 2021, 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://docs.oracle.com/en/java/javase/17/docs/api/java.desktop/javax/imageio/event/IIOWriteProgressListener.html