Spec-Zone.ru › OpenJDK 21

Класс 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()
Создаёт 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()
Конструирует 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, если его объект-производитель upstream отправит их в порядке TDLR.
  • Переопределить метод, чтобы просто отправить данные. Это уместно, если фильтр может сам обработать запрос — например, если сгенерированные пиксели были сохранены в каком-то буфере.
  • Переопределить метод, чтобы ничего не делать. Это уместно, если фильтр не может производить отфильтрованные данные в порядке TDLR.
Параметры:
ip - ImageProducer, который питает этот экземпляр фильтра — также ImageProducer, которому необходимо перенаправить запрос при необходимости
Исключения:
NullPointerException - если ip равно null
См. также:
  • ImageProducer.requestTopDownLeftRightResend(java.awt.image.ImageConsumer)

clone

public Object clone()
Клонирует этот объект.
Overrides:
clone в классе Object
Возвращает:
клонированный экземпляр.
См. также:
  • Cloneable

© 1993, 2023, 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/21/docs/api/java.desktop/java/awt/image/ImageFilter.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API