Класс ConvolveOp

java.lang.Object

java.awt.image.ConvolveOp

Все реализованные интерфейсы:: BufferedImageOp, RasterOp

public class ConvolveOp extends Object implements BufferedImageOp, RasterOp

Этот класс выполняет свёртку данных из источника в приёмник. Свёртка с использованием ядра свёртки — это пространственная операция, вычисляющая выходной пиксель из входного путём умножения ядра на окрестность входного пикселя. Благодаря этому выходной пиксель может зависеть от ближайших соседних пикселей в соответствии с математически заданным ядром.

Этот класс работает с данными BufferedImage, в которых компоненты цвета предварительно умножены на компонент альфа-канала. Если исходный BufferedImage содержит компонент альфа-канала, а компоненты цвета не предварительно умножены на него, данные предварительно умножаются перед свёрткой. Если компоненты цвета целевого изображения не предварительно умножены на альфа-канал, перед сохранением в целевое изображение значение альфа-канала делится на компоненты цвета (если значение альфа-канала равно 0, компоненты цвета устанавливаются в 0). Если целевое изображение не содержит компонента альфа-канала, результирующий альфа-канал отбрасывается после деления на него компонентов цвета.

Считается, что растры не содержат канала альфа-канала. Если описанная выше обработка альфа-канала в BufferedImage нежелательна, её можно избежать, получив растр исходного BufferedImage и используя метод filter этого класса, работающий с растрами.

Если в конструкторе задан объект RenderingHints, при преобразовании цвета могут использоваться подсказки рендеринга цвета и дизеринга.

Обратите внимание, что источник и целевое изображение не могут быть одним и тем же объектом.

См. также:

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

Модификатор и тип	Поле	Описание
`static final int`	`EDGE_NO_OP`	Пиксели на краю исходного изображения копируются в соответствующие пиксели целевого изображения без изменений.
`static final int`	`EDGE_ZERO_FILL`	Пиксели на краю целевого изображения устанавливаются в ноль.

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

Конструктор	Описание
`ConvolveOp(Kernel kernel)`	Создаёт ConvolveOp с заданным Kernel.
`ConvolveOp(Kernel kernel, int edgeCondition, RenderingHints hints)`	Создаёт ConvolveOp с заданными Kernel, условием обработки краёв и объектом RenderingHints (который может быть null).

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

Модификатор и тип	Метод	Описание
`BufferedImage`	`createCompatibleDestImage(BufferedImage src, ColorModel destCM)`	Создаёт заполненное нулями целевое изображение с правильным размером и числом полос.
`WritableRaster`	`createCompatibleDestRaster(Raster src)`	Создаёт заполненный нулями целевой растр с правильным размером и числом полос на основе данного источника.
`final BufferedImage`	`filter(BufferedImage src, BufferedImage dst)`	Выполняет свёртку изображений BufferedImage.
`final WritableRaster`	`filter(Raster src, WritableRaster dst)`	Выполняет свёртку растров.
`final Rectangle2D`	`getBounds2D(BufferedImage src)`	Возвращает ограничивающий прямоугольник отфильтрованного целевого изображения.
`final Rectangle2D`	`getBounds2D(Raster src)`	Возвращает ограничивающий прямоугольник отфильтрованного целевого растра.
`int`	`getEdgeCondition()`	Возвращает условие обработки краёв.
`final Kernel`	`getKernel()`	Возвращает Kernel.
`final Point2D`	`getPoint2D(Point2D srcPt, Point2D dstPt)`	Возвращает положение целевой точки, соответствующей заданной точке источника.
`final RenderingHints`	`getRenderingHints()`	Возвращает подсказки рендеринга для этой операции.

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

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

Модификатор и тип	Метод	Описание
`protected Object`	`clone()`	Создаёт и возвращает копию этого объекта.
`boolean`	`equals(Object obj)`	Указывает, равен ли какой-либо другой объект этому объекту.
`protected void`	`finalize()`	Устарел, подлежит удалению: этот элемент API подлежит удалению в будущей версии. Финализация устарела и подлежит удалению в одном из будущих выпусков.
`final Class<?>`	`getClass()`	Возвращает класс времени выполнения этого `Object`.
`int`	`hashCode()`	Возвращает значение хеш-кода этого объекта.
`final void`	`notify()`	Пробуждает один поток, ожидающий на мониторе этого объекта.
`final void`	`notifyAll()`	Пробуждает все потоки, ожидающие на мониторе этого объекта.
`String`	`toString()`	Возвращает строковое представление объекта.
`final void`	`wait()`	Заставляет текущий поток ожидать пробуждения, обычно вследствие вызова notify или interrupt.
`final void`	`wait(long timeoutMillis)`	Заставляет текущий поток ожидать пробуждения, обычно вследствие вызова notify или interrupt, либо до истечения заданного промежутка реального времени.
`final void`	`wait(long timeoutMillis, int nanos)`	Заставляет текущий поток ожидать пробуждения, обычно вследствие вызова notify или interrupt, либо до истечения заданного промежутка реального времени.

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

EDGE_ZERO_FILL

@Native public static final int EDGE_ZERO_FILL

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

См. также:

EDGE_NO_OP

@Native public static final int EDGE_NO_OP

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

См. также:

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

ConvolveOp

public ConvolveOp(Kernel kernel, int edgeCondition, RenderingHints hints)

Создаёт ConvolveOp с заданными Kernel, условием обработки краёв и объектом RenderingHints (который может быть null).

Параметры:

kernel — заданный Kernel

edgeCondition — заданное условие обработки краёв

hints — заданный объект RenderingHints

См. также:

ConvolveOp

public ConvolveOp(Kernel kernel)

Создаёт ConvolveOp с заданным Kernel. Условием обработки краёв будет EDGE_ZERO_FILL.

Параметры:

kernel — заданный Kernel

См. также:

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

getEdgeCondition

public int getEdgeCondition()

Возвращает условие обработки краёв.

Возвращает:

условие обработки краёв для этой ConvolveOp.

См. также:

getKernel

public final Kernel getKernel()

Возвращает Kernel.

Возвращает:: Kernel этой ConvolveOp.

filter

public final BufferedImage filter(BufferedImage src, BufferedImage dst)

Выполняет свёртку изображений BufferedImage. Свёртке подвергается каждый компонент исходного изображения (включая компонент альфа-канала, если он присутствует). Если цветовая модель исходного изображения отличается от цветовой модели целевого изображения, пиксели будут преобразованы при записи в целевое изображение. Если целевое изображение равно null, будет создан BufferedImage с цветовой моделью исходного изображения. Может быть выброшено исключение IllegalArgumentException, если источник и целевое изображение совпадают.

Определён в:: filter в интерфейсе BufferedImageOp
Параметры:: src — исходный BufferedImage для фильтрации; dst — целевой BufferedImage для отфильтрованного src
Возвращает:: отфильтрованный BufferedImage
Выбрасывает:: NullPointerException — если src равен null; IllegalArgumentException — если src совпадает с dst; ImagingOpException — если src невозможно отфильтровать

filter

public final WritableRaster filter(Raster src, WritableRaster dst)

Выполняет свёртку растров. Свёртке подвергается каждая полоса исходного растра. Исходный и целевой растры должны иметь одинаковое число полос. Если целевой растр равен null, будет создан новый растр. Может быть выброшено исключение IllegalArgumentException, если источник и целевой растр совпадают.

Определён в:: filter в интерфейсе RasterOp
Параметры:: src — исходный Raster для фильтрации; dst — целевой WritableRaster для отфильтрованного src
Возвращает:: отфильтрованный WritableRaster
Выбрасывает:: NullPointerException — если src равен null; ImagingOpException — если src и dst имеют разное число полос; ImagingOpException — если src невозможно отфильтровать; IllegalArgumentException — если src совпадает с dst

createCompatibleDestImage

public BufferedImage createCompatibleDestImage(BufferedImage src, ColorModel destCM)

Создаёт заполненное нулями целевое изображение с правильным размером и числом полос. Если destCM равен null, будет использована подходящая цветовая модель.

Определён в:: createCompatibleDestImage в интерфейсе BufferedImageOp
Параметры:: src — исходное изображение для операции фильтрации.; destCM — цветовая модель целевого изображения. Может быть null.
Возвращает:: целевое BufferedImage с правильным размером и числом полос.

createCompatibleDestRaster

public WritableRaster createCompatibleDestRaster(Raster src)

Создаёт заполненный нулями целевой растр с правильным размером и числом полос на основе данного источника.

Определён в:: createCompatibleDestRaster в интерфейсе RasterOp
Параметры:: src — исходный Raster
Возвращает:: WritableRaster, совместимый с src

getBounds2D

public final Rectangle2D getBounds2D(BufferedImage src)

Возвращает ограничивающий прямоугольник отфильтрованного целевого изображения. Поскольку это не геометрическая операция, ограничивающий прямоугольник не изменяется.

Определён в:: getBounds2D в интерфейсе BufferedImageOp
Параметры:: src — BufferedImage для фильтрации
Возвращает:: Rectangle2D, представляющий ограничивающий прямоугольник целевого изображения.

getBounds2D

public final Rectangle2D getBounds2D(Raster src)

Возвращает ограничивающий прямоугольник отфильтрованного целевого растра. Поскольку это не геометрическая операция, ограничивающий прямоугольник не изменяется.

Определён в:: getBounds2D в интерфейсе RasterOp
Параметры:: src — исходный Raster
Возвращает:: Rectangle2D, являющийся ограничивающим прямоугольником Raster, полученного в результате фильтрации.

getPoint2D

public final Point2D getPoint2D(Point2D srcPt, Point2D dstPt)

Возвращает положение целевой точки, соответствующей заданной точке источника. Если dstPt не равен null, он будет использован для хранения возвращаемого значения. Поскольку это не геометрическая операция, srcPt будет равен dstPt.

Определён в:: getPoint2D в интерфейсе BufferedImageOp
Определён в:: getPoint2D в интерфейсе RasterOp
Параметры:: srcPt — Point2D, представляющий точку в исходном изображении; dstPt — Point2D, в котором нужно сохранить результат
Возвращает:: Point2D в целевом изображении, соответствующую указанной точке в исходном изображении.

getRenderingHints

public final RenderingHints getRenderingHints()

Возвращает подсказки рендеринга для этой операции.

Определён в:: getRenderingHints в интерфейсе BufferedImageOp
Определён в:: getRenderingHints в интерфейсе RasterOp
Возвращает:: Объект RenderingHints для этой BufferedImageOp. Возвращает null, если подсказки не заданы.

© 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.