Класс 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, мы заменим здесь и везде, где появляется исходный объект 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

Модель цвета, которую нужно заменить newmodel, когда пользователь вызывает substituteColorModel.

newmodel

protected ColorModel newmodel

Модель цвета, которой заменяется origmodel, когда пользователь вызывает substituteColorModel.

canFilterIndexColorModel

protected boolean canFilterIndexColorModel

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

См. также:

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

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 тот же, который уже был преобразован, то просто пропускает пиксели с преобразованной моделью цвета. В противном случае преобразует буфер байтовых пикселей в модель цвета RGB по умолчанию и передает преобразованный буфер методу filterRGBPixels для преобразования по одному.

Указано в:

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

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

setPixels в классе ImageFilter

Параметры:

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)

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

Указано в:

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

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

setPixels в классе ImageFilter

Параметры:

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

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

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

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

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

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

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

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

См. также:

filterRGB

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

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

Параметры:

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

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

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

Возвращает:

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

См. также:

© 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.
https://download.java.net/java/early_access/jdk24/docs/api/java.desktop/java/awt/image/RGBImageFilter.html