Класс 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 фильтрует данные.

Поля, объявленные в интерфейсе 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)`	Обрабатывает запрос на повторную отправку данных пикселей от `ImageConsumer` в порядке TopDownLeftRight (TDLR).
`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)`	Передает свойства исходного объекта, добавив свойство, указывающее цепочку фильтров, через которую он прошел.

Методы, объявленные в классе 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)

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

Подкласс ImageFilter может переопределить этот метод или оставить его без изменений — в зависимости от того, может ли он отправлять данные в порядке TDLR и каким образом. Возможны три варианта:

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

Параметры:

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

Вызывает исключение:

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://docs.oracle.com/en/java/javase/25/docs/api/java.desktop/java/awt/image/ImageFilter.html