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