Интерфейс IIOReadUpdateListener

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

public interface IIOReadUpdateListener
extends EventListener

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

См. также:: ImageReader.addIIOReadUpdateListener(javax.imageio.event.IIOReadUpdateListener), ImageReader.removeIIOReadUpdateListener(javax.imageio.event.IIOReadUpdateListener)

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

Модификатор и тип	Метод и описание
`void`	`imageUpdate(ImageReader source, BufferedImage theImage, int minX, int minY, int width, int height, int periodX, int periodY, int[] bands)` Сообщает, что заданный регион изображения был обновлен.
`void`	`passComplete(ImageReader source, BufferedImage theImage)` Сообщает, что текущая операция чтения завершила поэтапную обработку.
`void`	`passStarted(ImageReader source, BufferedImage theImage, int pass, int minPass, int maxPass, int minX, int minY, int periodX, int periodY, int[] bands)` Сообщает, что текущая операция чтения собирается начать поэтапную обработку.
`void`	`thumbnailPassComplete(ImageReader source, BufferedImage theThumbnail)` Сообщает, что текущая операция чтения эскиза завершила поэтапную обработку.
`void`	`thumbnailPassStarted(ImageReader source, BufferedImage theThumbnail, int pass, int minPass, int maxPass, int minX, int minY, int periodX, int periodY, int[] bands)` Сообщает, что текущая операция чтения эскиза собирается начать поэтапную обработку.
`void`	`thumbnailUpdate(ImageReader source, BufferedImage theThumbnail, int minX, int minY, int width, int height, int periodX, int periodY, int[] bands)` Сообщает, что заданный регион изображения эскиза был обновлен.

Подробное описание методов

passStarted

void passStarted(ImageReader source,
                 BufferedImage theImage,
                 int pass,
                 int minPass,
                 int maxPass,
                 int minX,
                 int minY,
                 int periodX,
                 int periodY,
                 int[] bands)

Сообщает, что текущая операция чтения собирается начать поэтапную обработку. Читатели форматов, поддерживающих поэтапное кодирование, должны использовать этот метод для уведомления клиентов о завершении каждого этапа при чтении поэтапно закодированного изображения.

Приблизительная область, которая будет обновлена на этом этапе, указывается параметрами minX, minY, width и height. Если этап является чересстрочным, то есть он обновляет только выбранные строки или столбцы, параметры periodX и periodY будут указывать степень субдискретизации. Набор полос, которые могут быть затронуты, указывается значением bands.

Параметры:: source - объект ImageReader, вызывающий этот метод.; theImage - обновляемое BufferedImage.; pass - номер этапа, который собирается начаться, начиная с 0.; minPass - индекс первого этапа, который будет декодирован.; maxPass - индекс последнего этапа, который будет декодирован.; minX - координата X крайнего левого обновленного столбца пикселей.; minY - координата Y крайнего верхнего обновленного ряда пикселей.; periodX - горизонтальное расстояние между обновленными пикселями; значение 1 означает отсутствие пробелов.; periodY - вертикальное расстояние между обновленными пикселями; значение 1 означает отсутствие пробелов.; bands - массив ints, указывающих набор полос, которые могут быть обновлены.

imageUpdate

void imageUpdate(ImageReader source,
                 BufferedImage theImage,
                 int minX,
                 int minY,
                 int width,
                 int height,
                 int periodX,
                 int periodY,
                 int[] bands)

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

Обратите внимание, что разные средства чтения форматов изображений могут создавать декодированные пиксели в различных порядках. Многие средства чтения будут создавать пиксели в простом порядке сверху вниз, слева направо, но другие могут использовать несколько проходов чересстрочной развертки, мозаики и т. д. Последовательность обновлений может даже отличаться от вызова к вызову в зависимости от скорости сети, например. Вызов этого метода не гарантирует, что все указанные пиксели были фактически обновлены, а только то, что произошла некоторая активность в некоторой подобласти указанной области.

Конкретная реализация ImageReader может выбирать, как часто предоставлять обновления. Каждое обновление указывает, что заданный регион изображения был обновлен с момента последнего обновления. Область описывается ее пространственной ограничительной рамкой (minX, minY, width и height); факторами субдискретизации X и Y (periodX и periodY); и набором обновленных полос (bands). Например, обновление:

minX = 10
 minY = 20
 width = 3
 height = 4
 periodX = 2
 periodY = 3
 bands = { 1, 3 }

будет указывать, что полосы 1 и 3 следующих пикселей были обновлены:

(10, 20) (12, 20) (14, 20)
 (10, 23) (12, 23) (14, 23)
 (10, 26) (12, 26) (14, 26)
 (10, 29) (12, 29) (14, 29)

Параметры:: source - объект ImageReader, вызывающий этот метод.; theImage - обновляемое BufferedImage.; minX - координата X крайнего левого обновленного столбца пикселей.; minY - координата Y крайнего верхнего обновленного ряда пикселей.; width - количество обновленных пикселей по горизонтали.; height - количество обновленных пикселей по вертикали.; periodX - горизонтальное расстояние между обновленными пикселями; значение 1 означает отсутствие пробелов.; periodY - вертикальное расстояние между обновленными пикселями; значение 1 означает отсутствие пробелов.; bands - массив ints, указывающих, какие полосы обновляются.

passComplete

void passComplete(ImageReader source,
                  BufferedImage theImage)

Сообщает, что текущая операция чтения завершила поэтапную обработку. Читатели форматов, поддерживающих поэтапное кодирование, должны использовать этот метод для уведомления клиентов о завершении каждого этапа при чтении поэтапно закодированного изображения.

Параметры:: source - объект ImageReader, вызывающий этот метод.; theImage - обновляемое BufferedImage.
См. также:: ImageReadParam.setSourceProgressivePasses(int, int)

thumbnailPassStarted

void thumbnailPassStarted(ImageReader source,
                          BufferedImage theThumbnail,
                          int pass,
                          int minPass,
                          int maxPass,
                          int minX,
                          int minY,
                          int periodX,
                          int periodY,
                          int[] bands)

Сообщает, что текущая операция чтения эскиза собирается начать поэтапную обработку. Читатели форматов, поддерживающих поэтапное кодирование, должны использовать этот метод для уведомления клиентов о завершении каждого этапа при чтении поэтапно закодированного изображения эскиза.

Параметры:: source - объект ImageReader, вызывающий этот метод.; theThumbnail - обновляемый эскиз BufferedImage.; pass - номер этапа, который собирается начаться, начиная с 0.; minPass - индекс первого этапа, который будет декодирован.; maxPass - индекс последнего этапа, который будет декодирован.; minX - координата X крайнего левого обновленного столбца пикселей.; minY - координата Y крайнего верхнего обновленного ряда пикселей.; periodX - горизонтальное расстояние между обновленными пикселями; значение 1 означает отсутствие пробелов.; periodY - вертикальное расстояние между обновленными пикселями; значение 1 означает отсутствие пробелов.; bands - массив ints, указывающих набор полос, которые могут быть обновлены.
См. также:: passStarted(javax.imageio.ImageReader, java.awt.image.BufferedImage, int, int, int, int, int, int, int, int[])

thumbnailUpdate

void thumbnailUpdate(ImageReader source,
                     BufferedImage theThumbnail,
                     int minX,
                     int minY,
                     int width,
                     int height,
                     int periodX,
                     int periodY,
                     int[] bands)

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

Параметры:: source - объект ImageReader, вызывающий этот метод.; theThumbnail - обновляемый эскиз BufferedImage.; minX - координата X крайнего левого обновленного столбца пикселей.; minY - координата Y крайнего верхнего обновленного ряда пикселей.; width - количество обновленных пикселей по горизонтали.; height - количество обновленных пикселей по вертикали.; periodX - горизонтальное расстояние между обновленными пикселями; значение 1 означает отсутствие пробелов.; periodY - вертикальное расстояние между обновленными пикселями; значение 1 означает отсутствие пробелов.; bands - массив ints, указывающих, какие полосы обновляются.
См. также:: imageUpdate(javax.imageio.ImageReader, java.awt.image.BufferedImage, int, int, int, int, int, int, int[])

thumbnailPassComplete

void thumbnailPassComplete(ImageReader source,
                           BufferedImage theThumbnail)

Сообщает, что текущая операция чтения эскиза завершила поэтапную обработку. Читатели форматов, поддерживающих поэтапное кодирование, должны использовать этот метод для уведомления клиентов о завершении каждого этапа при чтении поэтапно закодированного изображения эскиза.

Параметры:: source - объект ImageReader, вызывающий этот метод.; theThumbnail - обновляемый эскиз BufferedImage.
См. также:: passComplete(javax.imageio.ImageReader, java.awt.image.BufferedImage)

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