Класс 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 для создания отфильтрованных версий существующих изображений. Это базовый класс, предоставляющий вызовы, необходимые для реализации «нулевого фильтра», который не оказывает влияния на передаваемые данные. Фильтры должны быть подклассами этого класса и переопределять методы, которые обрабатывают данные, которые необходимо отфильтровать, и изменять их по мере необходимости.

См. также:

Краткое описание полей

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

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

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

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

Конструктор	Описание
`ImageFilter()`	Создаёт `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 создаёт уникальный экземпляр этого объекта для конкретного потока данных изображения.

См. также:

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

ImageFilter

public ImageFilter()

Создаёт 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 - высота исходного изображения

См. также:

setProperties

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

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

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

setColorModel

public void setColorModel(ColorModel model)

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

Определено в:

setColorModel в интерфейсе ImageConsumer

Параметры:

model - указанный ColorModel

См. также:

setHints

public void setHints(int hints)

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

Определено в:

setHints в интерфейсе ImageConsumer

Параметры:

hints - набор подсказок, используемых ImageConsumer для обработки пикселей

См. также:

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

См. также:

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

См. также:

imageComplete

public void imageComplete(int status)

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

Определено в:

imageComplete в интерфейсе ImageConsumer

Параметры:

status - статус загрузки изображения

См. также:

resendTopDownLeftRight

public void resendTopDownLeftRight(ImageProducer ip)

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

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

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

Параметры:

ip - ip, питающий этот экземпляр фильтра — также ip, которому необходимо переслать запрос при необходимости

Исключения:

NullPointerException - если ip равно null

См. также:

clone

public Object clone()

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

Переопределяет:

clone в классе Object

Возвращает:

клонированный экземпляр.

См. также:

© 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://download.java.net/java/early_access/jdk24/docs/api/java.desktop/java/awt/image/ImageFilter.html