Класс ImageFilter

java.lang.Object
- java.awt.image.ImageFilter

Все реализованные интерфейсы:: ImageConsumer, Cloneable

Прямые известные подклассы:: BufferedImageFilter, CropImageFilter, ReplicateScaleFilter, RGBImageFilter

public class ImageFilter
extends Object
implements ImageConsumer, Cloneable

Этот класс реализует фильтр для набора методов интерфейса, которые используются для передачи данных от ImageProducer к ImageConsumer. Он предназначен для использования совместно с объектом FilteredImageSource для получения отфильтрованных версий существующих изображений. Это базовый класс, предоставляющий вызовы, необходимые для реализации «нулевого фильтра», который не оказывает никакого влияния на передаваемые данные. Фильтры должны быть подклассами этого класса и переопределять методы, которые обрабатывают данные, которые необходимо отфильтровать, и модифицировать их по мере необходимости.

См. также:: FilteredImageSource, ImageConsumer

Поля

Модификатор и тип	Поле и описание
`protected ImageConsumer`	`consumer` Потребитель конкретного потока данных изображения, для которого этот экземпляр ImageFilter фильтрует данные.

Поля, унаследованные от интерфейса java.awt.image.ImageConsumer

COMPLETESCANLINES, IMAGEABORTED, IMAGEERROR, RANDOMPIXELORDER, SINGLEFRAME, SINGLEFRAMEDONE, SINGLEPASS, STATICIMAGEDONE, TOPDOWNLEFTRIGHT

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

Конструктор и описание
`ImageFilter()`

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

Модификатор и тип	Метод и описание
`Object`	`clone()` Клонирует этот объект.
`ImageFilter`	`getFilterInstance(ImageConsumer ic)` Возвращает уникальный экземпляр объекта ImageFilter, который фактически выполнит фильтрацию для указанного ImageConsumer.
`void`	`imageComplete(int status)` Фильтрует информацию, предоставляемую методом imageComplete интерфейса ImageConsumer.
`void`	`resendTopDownLeftRight(ImageProducer ip)` Реагирует на запрос о повторной передаче пиксельных данных в порядке TopDownLeftRight (TDLR) от `ImageConsumer`.
`void`	`setColorModel(ColorModel model)` Фильтрует информацию, предоставляемую методом setColorModel интерфейса ImageConsumer.
`void`	`setDimensions(int width, int height)` Фильтрует информацию, предоставляемую методом setDimensions интерфейса ImageConsumer.
`void`	`setHints(int hints)` Фильтрует информацию, предоставляемую методом setHints интерфейса ImageConsumer.
`void`	`setPixels(int x, int y, int w, int h, ColorModel model, byte[] pixels, int off, int scansize)` Фильтрует информацию, предоставляемую методом setPixels интерфейса ImageConsumer, который принимает массив байтов.
`void`	`setPixels(int x, int y, int w, int h, ColorModel model, int[] pixels, int off, int scansize)` Фильтрует информацию, предоставляемую методом setPixels интерфейса ImageConsumer, который принимает массив целых чисел.
`void`	`setProperties(Hashtable<?,?> props)` Передает свойства из исходного объекта после добавления свойства, указывающего поток фильтров, через который он был пропущен.

Методы, унаследованные от класса java.lang.Object

equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Поля

consumer

protected ImageConsumer consumer

Потребитель потока данных конкретного изображения, для которого этот экземпляр ImageFilter фильтрует данные. Он не инициализируется во время конструктора, а во время вызова метода getFilterInstance(), когда FilteredImageSource создает уникальный экземпляр этого объекта для конкретного потока данных изображения.

См. также:: getFilterInstance(java.awt.image.ImageConsumer), ImageConsumer

Конструкторы

ImageFilter

public ImageFilter()

Методы

getFilterInstance

public ImageFilter getFilterInstance(ImageConsumer ic)

Возвращает уникальный экземпляр объекта ImageFilter, который фактически будет выполнять фильтрацию для указанного ImageConsumer. Реализация по умолчанию просто клонирует этот объект.

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

Параметры:: ic - указанный ImageConsumer
Возвращает:: объект ImageFilter, используемый для выполнения фильтрации для указанного ImageConsumer.

setDimensions

public void setDimensions(int width,
                          int height)

Фильтры информации, предоставленной в методе setDimensions интерфейса ImageConsumer.

Указано в:: setDimensions в интерфейсе ImageConsumer
Параметры:: width - ширина исходного изображения; height - высота исходного изображения
См. также:: ImageConsumer.setDimensions(int, int)

setProperties

public void setProperties(Hashtable<?,?> props)

Передает свойства из исходного объекта после добавления свойства, указывающего поток фильтров, через которые он был запущен.

Указано в:: setProperties в интерфейсе ImageConsumer
Параметры:: props - свойства из исходного объекта
Исключения:: NullPointerException - если props является null

setColorModel

public void setColorModel(ColorModel model)

Фильтрует информацию, предоставленную в методе setColorModel интерфейса ImageConsumer.

Указано в:: setColorModel в интерфейсе ImageConsumer
Параметры:: model - указанный ColorModel
См. также:: ImageConsumer.setColorModel(java.awt.image.ColorModel)

setHints

public void setHints(int hints)

Фильтры информации, предоставленной в методе setHints интерфейса ImageConsumer.

Указано в:: setHints в интерфейсе ImageConsumer
Параметры:: hints - набор подсказок, которые ImageConsumer использует для обработки пикселей
См. также:: ImageConsumer.setHints(int)

setPixels

public void setPixels(int x,
                      int y,
                      int w,
                      int h,
                      ColorModel model,
                      byte[] pixels,
                      int off,
                      int scansize)

Фильтры информации, предоставленной в методе setPixels интерфейса ImageConsumer, который принимает массив байтов.

Указано в:: setPixels в интерфейсе ImageConsumer
Параметры:: x - координата X левого верхнего угла области пикселей, которые нужно установить; y - координата Y левого верхнего угла области пикселей, которые нужно установить; w - ширина области пикселей; h - высота области пикселей; model - указанный ColorModel; pixels - массив пикселей; off - смещение в массиве pixels; scansize - расстояние от одной строки пикселей до следующей в массиве pixels
См. также:: ImageConsumer.setPixels(int, int, int, int, java.awt.image.ColorModel, byte[], int, int)

setPixels

public void setPixels(int x,
                      int y,
                      int w,
                      int h,
                      ColorModel model,
                      int[] pixels,
                      int off,
                      int scansize)

Фильтры информации, предоставленной в методе setPixels интерфейса ImageConsumer, который принимает массив целых чисел.

Указано в:: setPixels в интерфейсе ImageConsumer
Параметры:: x - координата X левого верхнего угла области пикселей, которые нужно установить; y - координата Y левого верхнего угла области пикселей, которые нужно установить; w - ширина области пикселей; h - высота области пикселей; model - указанный ColorModel; pixels - массив пикселей; off - смещение в массиве pixels; scansize - расстояние от одной строки пикселей до следующей в массиве pixels
См. также:: ImageConsumer.setPixels(int, int, int, int, java.awt.image.ColorModel, byte[], int, int)

imageComplete

public void imageComplete(int status)

Фильтры информации, предоставленной в методе imageComplete интерфейса ImageConsumer.

Указано в:: imageComplete в интерфейсе ImageConsumer
Параметры:: status - статус загрузки изображения
См. также:: ImageConsumer.imageComplete(int)

resendTopDownLeftRight

public void resendTopDownLeftRight(ImageProducer ip)

Отвечает на запрос на повторную отправку данных пикселей в порядке TopDownLeftRight (TDLR) от ImageConsumer. Когда ImageConsumer, получающий данные от экземпляра этого ImageFilter, запрашивает повторную отправку данных в порядке TDLR, FilteredImageSource вызывает этот метод ImageFilter.

Подкласс ImageFilter может переопределить этот метод или нет, в зависимости от того, может ли он отправлять данные в порядке TDLR. Существуют три возможности:

Не переопределяйте этот метод. Это заставляет подкласс использовать реализацию по умолчанию, которая заключается в переадресации запроса указанному ImageProducer с использованием этого фильтра в качестве запрашивающего ImageConsumer. Это поведение подходит, если фильтр может определить, что он будет пересылать пиксели в порядке TDLR, если его объект-производитель вышестоящего уровня отправляет их в порядке TDLR.
Переопределите метод, чтобы просто отправить данные. Это подходит, если фильтр может сам обработать запрос — например, если сгенерированные пиксели были сохранены в некотором буфере.
Переопределите метод, чтобы ничего не делать. Это подходит, если фильтр не может генерировать отфильтрованные данные в порядке TDLR.

Параметры:: ip - ImageProducer, который питает этот экземпляр фильтра — также ImageProducer, которому следует переадресовать запрос, если это необходимо
Исключения:: NullPointerException - если ip является null
См. также:: ImageProducer.requestTopDownLeftRightResend(java.awt.image.ImageConsumer)

clone

public Object clone()

Клонирует этот объект.

Переопределяет:: clone в классе Object
Возвращает:: клон этого экземпляра.
См. также:: Cloneable

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