Класс 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, используя заданное ядро.
`ConvolveOp(Kernel kernel, int edgeCondition, RenderingHints hints)`	Создаёт ConvolveOp, используя заданные ядро, условие обработки краёв и объект 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()`	Возвращает ядро.
`final Point2D`	`getPoint2D(Point2D srcPt, Point2D dstPt)`	Возвращает положение точки назначения, соответствующей точке источника.
`final RenderingHints`	`getRenderingHints()`	Возвращает подсказки рендеринга для этой операции.

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

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

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

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, используя заданные ядро, условие обработки краёв и объект RenderingHints (который может быть null).

Параметры:

kernel — заданное Kernel

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

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

См. также:

ConvolveOp

public ConvolveOp(Kernel kernel)

Создаёт ConvolveOp, используя заданное ядро. Условием обработки краёв будет EDGE_ZERO_FILL.

Параметры:

kernel — заданное Kernel

См. также:

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

getEdgeCondition

public int getEdgeCondition()

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

Возвращает:

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

См. также:

getKernel

public final Kernel getKernel()

Возвращает ядро.

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

filter

public final BufferedImage filter(BufferedImage src, BufferedImage dst)

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

Определено в:: createCompatibleDestImage в интерфейсе BufferedImageOp
Параметры:: src — исходное изображение для операции фильтрации.; destCM — ColorModel изображения назначения. Может быть равен 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.
https://docs.oracle.com/en/java/javase/25/docs/api/java.desktop/java/awt/image/ConvolveOp.html