Spec-Zone.ru › OpenJDK 17

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

clone

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

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

Spec-Zone.ru

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