Интерфейс IIOReadProgressListener

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

public interface IIOReadProgressListener
extends EventListener

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

Этот интерфейс получает общие указания о прогрессе декодирования (через методы imageProgress и thumbnailProgress) и события, указывающие, когда всё изображение обновлено (через методы imageStarted, imageComplete, thumbnailStarted и thumbnailComplete). Приложения, которые хотят получать информацию об обновлениях пикселей по мере их появления (например, во время поэтапного декодирования), должны предоставить IIOReadUpdateListener.

См. также:: IIOReadUpdateListener, ImageReader.addIIOReadProgressListener(javax.imageio.event.IIOReadProgressListener), ImageReader.removeIIOReadProgressListener(javax.imageio.event.IIOReadProgressListener)

Методы

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

Методы

sequenceStarted

void sequenceStarted(ImageReader source,
                     int minIndex)

Сообщает, что последовательность операций чтения началась. Реализации ImageReader обязаны вызвать этот метод ровно один раз из своего метода readAll(Iterator).

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

sequenceComplete

void sequenceComplete(ImageReader source)

Сообщает, что последовательность операций чтения завершена. Реализации ImageReader обязаны вызвать этот метод ровно один раз из своего метода readAll(Iterator).

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

imageStarted

void imageStarted(ImageReader source,
                  int imageIndex)

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

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

imageProgress

void imageProgress(ImageReader source,
                   float percentageDone)

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

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

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

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

imageComplete

void imageComplete(ImageReader source)

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

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

thumbnailStarted

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

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

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

thumbnailProgress

void thumbnailProgress(ImageReader source,
                       float percentageDone)

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

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

thumbnailComplete

void thumbnailComplete(ImageReader source)

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

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

readAborted

void readAborted(ImageReader source)

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

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

© 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.