Класс 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

Модификатор и тип	Поле	Описание
`static final int`	`COMPLETESCANLINES`	Пиксели будут передаваться полными строками сканирования (или их кратными) за один раз.
`static final int`	`IMAGEABORTED`	Создание изображения было намеренно прервано.
`static final int`	`IMAGEERROR`	При создании изображения произошла ошибка.
`static final int`	`RANDOMPIXELORDER`	Пиксели будут передаваться в случайном порядке.
`static final int`	`SINGLEFRAME`	Изображение содержит один статичный кадр.
`static final int`	`SINGLEFRAMEDONE`	Один кадр изображения готов, но будут переданы и другие кадры.
`static final int`	`SINGLEPASS`	Пиксели будут переданы за один проход.
`static final int`	`STATICIMAGEDONE`	Изображение готово, и больше не будет передано ни пикселей, ни кадров.
`static final int`	`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

Модификатор и тип	Метод	Описание
`boolean`	`equals(Object obj)`	Указывает, равен ли этот объект другому объекту.
`protected void`	`finalize()`	Устарело, будет удалено: этот элемент API подлежит удалению в будущей версии. Финализация объявлена устаревшей и подлежит удалению в одном из следующих выпусков.
`final Class<?>`	`getClass()`	Возвращает класс времени выполнения этого `Object`.
`int`	`hashCode()`	Возвращает хеш-код этого объекта.
`final void`	`notify()`	Пробуждает один поток, ожидающий на мониторе этого объекта.
`final void`	`notifyAll()`	Пробуждает все потоки, ожидающие на мониторе этого объекта.
`String`	`toString()`	Возвращает строковое представление объекта.
`final void`	`wait()`	Заставляет текущий поток ожидать пробуждения, обычно посредством уведомления или прерывания.
`final void`	`wait(long timeoutMillis)`	Заставляет текущий поток ожидать пробуждения, обычно посредством уведомления или прерывания, либо истечения заданного промежутка реального времени.
`final void`	`wait(long timeoutMillis, int nanos)`	Заставляет текущий поток ожидать пробуждения, обычно посредством уведомления или прерывания, либо истечения заданного промежутка реального времени.

Подробное описание полей

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.