Класс RGBImageFilter

java.lang.Object

java.awt.image.ImageFilter

java.awt.image.RGBImageFilter

Все реализуемые интерфейсы:: ImageConsumer, Cloneable

Прямые известные подклассы:: GrayFilter

public abstract class RGBImageFilter extends ImageFilter

Этот класс предоставляет простой способ создания ImageFilter, который изменяет пиксели изображения в стандартной цветовой модели RGB. Он предназначен для использования совместно с объектом FilteredImageSource для получения отфильтрованных версий существующих изображений. Это абстрактный класс, который предоставляет вызовы для обработки всех данных пикселей через один метод, преобразующий пиксели по одному в стандартной цветовой модели RGB независимо от цветовой модели, используемой ImageProducer. Единственный метод, который необходимо определить для создания полезного фильтра изображения, — это метод filterRGB. Вот пример определения фильтра, который меняет местами красный и синий компоненты изображения:



      class RedBlueSwapFilter extends RGBImageFilter {
          public RedBlueSwapFilter() {
              // The filter's operation does not depend on the
              // pixel's location, so IndexColorModels can be
              // filtered directly.
              canFilterIndexColorModel = true;
          }

          public int filterRGB(int x, int y, int rgb) {
              return ((rgb & 0xff00ff00)
                      | ((rgb & 0xff0000) >> 16)
                      | ((rgb & 0xff) << 16));
          }
      }

См. также:

Краткое описание полей

Модификатор и тип	Поле	Описание
`protected boolean`	`canFilterIndexColorModel`	Этот флаг указывает, можно ли применять цветовое фильтрование метода filterRGB к записям цветовой таблицы объекта IndexColorModel вместо фильтрования пикселя за пикселем.
`protected ColorModel`	`newmodel`	`ColorModel` для замены `origmodel` при вызове `substituteColorModel`.
`protected ColorModel`	`origmodel`	`ColorModel` для замены `newmodel` при вызове `substituteColorModel`.

Поля, объявленные в классе java.awt.image.ImageFilter

consumer

Поля, объявленные в интерфейсе java.awt.image.ImageConsumer

COMPLETESCANLINES, IMAGEABORTED, IMAGEERROR, RANDOMPIXELORDER, SINGLEFRAME, SINGLEFRAMEDONE, SINGLEPASS, STATICIMAGEDONE, TOPDOWNLEFTRIGHT

Краткое описание конструкторов

RGBImageFilter()

Модификатор	Конструктор	Описание
`protected`	Конструктор для вызова подклассами.

Краткое описание методов

Модификатор и тип	Метод	Описание
`IndexColorModel`	`filterIndexColorModel(IndexColorModel icm)`	Фильтрование объекта IndexColorModel путем обработки каждой записи в его цветовых таблицах с помощью функции filterRGB, которую должны предоставить подклассы RGBImageFilter.
`abstract int`	`filterRGB(int x, int y, int rgb)`	Подклассы должны указать метод преобразования одного входного пикселя в стандартной цветовой модели RGB в один выходной пиксель.
`void`	`filterRGBPixels(int x, int y, int w, int h, int[] pixels, int off, int scansize)`	Фильтрование буфера пикселей в стандартной цветовой модели RGB путем их обработки по одному с помощью метода filterRGB.
`void`	`setColorModel(ColorModel model)`	Если ColorModel является IndexColorModel, и подкласс установил флаг canFilterIndexColorModel в значение true, здесь и везде, где в методах setPixels появляется исходный объект ColorModel, мы заменяем его отфильтрованной версией цветовой модели.
`void`	`setPixels(int x, int y, int w, int h, ColorModel model, byte[] pixels, int off, int scansize)`	Если объект ColorModel — тот же, который уже был преобразован, он просто пропускает пиксели с преобразованной цветовой моделью.
`void`	`setPixels(int x, int y, int w, int h, ColorModel model, int[] pixels, int off, int scansize)`	Если объект ColorModel — тот же, который уже был преобразован, он просто пропускает пиксели с преобразованной цветовой моделью. В противном случае преобразует буфер целочисленных пикселей в стандартную цветовую модель RGB и передает преобразованный буфер методу filterRGBPixels для преобразования по одному.
`void`	`substituteColorModel(ColorModel oldcm, ColorModel newcm)`	Регистрирует два объекта ColorModel для замены.

Методы, объявленные в классе java.awt.image.ImageFilter

clone, getFilterInstance, imageComplete, resendTopDownLeftRight, setDimensions, setHints, setProperties

Методы, объявленные в классе java.lang.Object

equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

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

origmodel

protected ColorModel origmodel

Модель цвета ColorModel должна быть заменена моделью newmodel при вызове пользователем метода substituteColorModel.

newmodel

protected ColorModel newmodel

Модель цвета ColorModel для замены origmodel при вызове пользователем метода substituteColorModel.

canFilterIndexColorModel

protected boolean canFilterIndexColorModel

Этот булевый флаг указывает, допустимо ли применять фильтрацию цветов метода filterRGB к записям цветовой таблицы объекта IndexColorModel вместо пиксельной фильтрации. Подклассы должны установить эту переменную в значение true в своём конструкторе, если их метод filterRGB не зависит от координат фильтруемого пикселя.

См. также:

substituteColorModel(java.awt.image.ColorModel, java.awt.image.ColorModel)
filterRGB(int, int, int)
IndexColorModel

Подробное описание конструкторов

RGBImageFilter

protected RGBImageFilter()

Конструктор для вызова подклассами.

Подробное описание методов

setColorModel

public void setColorModel(ColorModel model)

Если ColorModel является IndexColorModel, и подкласс установил флаг canFilterIndexColorModel в значение true, то здесь и там, где в методах setPixels встречается исходный объект ColorModel, мы подставляем отфильтрованную версию модели цвета. Если ColorModel не является IndexColorModel или равен null, этот метод переопределяет используемую по умолчанию модель цвета ImageProducer и вместо неё устанавливает стандартную RGB-модель цвета.

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

Определено в:

setColorModel в интерфейсе ImageConsumer

Переопределяет:

setColorModel в классе ImageFilter

Параметры:

model - указанная ColorModel

См. также:

substituteColorModel

public void substituteColorModel(ColorModel oldcm, ColorModel newcm)

Регистрирует два объекта ColorModel для замены. Если oldcm встречается во время любого из методов setPixels, newcm подставляется, и пиксели передаются без изменений (но с новым объектом ColorModel).

Параметры:: oldcm - объект ColorModel, который необходимо заменить на лету; newcm - объект ColorModel, которым нужно заменить oldcm на лету

filterIndexColorModel

public IndexColorModel filterIndexColorModel(IndexColorModel icm)

Фильтрация объекта IndexColorModel путём прогона каждой записи в его цветовых таблицах через функцию filterRGB, которую должны предоставить подклассы RGBImageFilter. Использует координаты -1 для обозначения того, что фильтруется запись цветовой таблицы, а не фактическое значение пикселя.

Параметры:: icm - объект IndexColorModel, который необходимо отфильтровать
Возвращает:: новый IndexColorModel, представляющий отфильтрованные цвета
Исключения:: NullPointerException - если icm равен null

filterRGBPixels

public void filterRGBPixels(int x, int y, int w, int h, int[] pixels, int off, int scansize)

Фильтрует буфер пикселей в стандартной RGB-модели цвета, передавая их по одному через метод filterRGB.

Параметры:

x - координата X верхнего левого угла области пикселей

y - координата Y верхнего левого угла области пикселей

w - ширина области пикселей

h - высота области пикселей

pixels - массив пикселей

off - смещение в массиве pixels

scansize - расстояние между строками пикселей в массиве

См. также:

setPixels

public void setPixels(int x, int y, int w, int h, ColorModel model, byte[] pixels, int off, int scansize)

Если объект ColorModel — тот, который уже был преобразован, то просто пропускает пиксели через преобразованную ColorModel. В противном случае преобразует буфер байтовых пикселей в стандартную RGB-модель цвета и передает преобразованный буфер методу filterRGBPixels для преобразования по одному.

Определено в:

setPixels в интерфейсе ImageConsumer

Переопределяет:

setPixels в классе ImageFilter

Параметры:

x - координата X верхнего левого угла области пикселей

y - координата Y верхнего левого угла области пикселей

w - ширина области пикселей

h - высота области пикселей

model - заданная ColorModel

pixels - массив пикселей

off - смещение в массиве pixels

scansize - расстояние между строками пикселей в массиве pixels

См. также:

ColorModel.getRGBdefault()
filterRGBPixels(int, int, int, int, int[], int, int)

setPixels

public void setPixels(int x, int y, int w, int h, ColorModel model, int[] pixels, int off, int scansize)

Если объект ColorModel — тот, который уже был преобразован, то просто пропускает пиксели через преобразованную ColorModel, в противном случае преобразует буфер целочисленных пикселей в стандартную RGB-модель цвета и передает преобразованный буфер методу filterRGBPixels для преобразования по одному. Преобразует буфер целочисленных пикселей в стандартную RGB-модель цвета и передает преобразованный буфер методу filterRGBPixels.

Определено в:

setPixels в интерфейсе ImageConsumer

Переопределяет:

setPixels в классе ImageFilter

Параметры:

x - координата X верхнего левого угла области пикселей

y - координата Y верхнего левого угла области пикселей

w - ширина области пикселей

h - высота области пикселей

model - указанный ColorModel

pixels - массив пикселей

off - смещение в массиве pixels

scansize - расстояние между строками пикселей в массиве pixels

См. также:

ColorModel.getRGBdefault()
filterRGBPixels(int, int, int, int, int[], int, int)

filterRGB

public abstract int filterRGB(int x, int y, int rgb)

Подклассы должны указать метод для преобразования одного входного пикселя в стандартной RGB-модели цвета в один выходной пиксель.

Параметры:

x - координата X пикселя

y - координата Y пикселя

rgb - целочисленное представление пикселя в стандартной RGB-модели цвета

Возвращает:

отфильтрованный пиксель в стандартной RGB-модели цвета.

См. также:

ColorModel.getRGBdefault()
filterRGBPixels(int, int, int, int, int[], int, int)

© 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/RGBImageFilter.html