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

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

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

setProperties

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

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

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

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

setColorModel

public void setColorModel(ColorModel model)

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

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

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

setHints

public void setHints(int hints)

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

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

Указано в:
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, который принимает массив байтов.

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

Указано в:
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, который принимает массив целых чисел.

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

Указано в:
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.

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

Указано в:
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.
https://docs.oracle.com/en/java/javase/11/docs/api/java.desktop/java/awt/image/ImageFilter.html

Spec-Zone .ru
спецификации, руководства, описания, API