Класс ConvolveOp

public class ConvolveOp
extends Object
implements BufferedImageOp, RasterOp

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

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

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

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

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

Поля

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

См. также:

Kernel, EDGE_NO_OP, EDGE_ZERO_FILL, RenderingHints

ConvolveOp

public ConvolveOp(Kernel kernel)

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

Параметры:

kernel - указанное Kernel

См. также:

Kernel, EDGE_ZERO_FILL

Методы

getEdgeCondition

public int getEdgeCondition()

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

Возвращает:

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

См. также:

EDGE_NO_OP, EDGE_ZERO_FILL

getKernel

public final Kernel getKernel()

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

Возвращает:

ядро этого 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 для фильтрации

Возвращает:

Область, представляющая ограничивающую рамку изображения назначения.

getBounds2D

public final Rectangle2D getBounds2D(Raster src)

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

Задано:

getBounds2D в интерфейсе RasterOp

Параметры:

src - исходный Raster

Возвращает:

область, которая представляет ограничивающую рамку 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, если параметры не были установлены.