java.awt.image

Класс ConvolveOp

java.lang. Объект

java.awt.image. ConvolveOp

Все Реализованные Интерфейсы:

BufferedImageOp, RasterOp

public class ConvolveOp
extends Object
implements BufferedImageOp, RasterOp

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

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

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

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

Отметьте, что Источник и Место назначения, возможно, не тот же самый объект.

См. Также:

Kernel, RenderingHints.KEY_COLOR_RENDERING, RenderingHints.KEY_DITHERING

Полевая Сводка

Поля

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

Сводка конструктора

Конструкторы

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

Сводка метода

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

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

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 (который может быть нулем).

Параметры:

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()

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

Возвраты:

Kernel из этого ConvolveOp.

фильтр

public final BufferedImage filter(BufferedImage src,
                                  BufferedImage dst)

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

Определенный:

filter в интерфейсе BufferedImageOp

Параметры:

src - источник BufferedImage фильтровать

dst - место назначения BufferedImage для фильтруемого src

Возвраты:

фильтруемый BufferedImage

Броски:

NullPointerException - если src null

IllegalArgumentException - если src равняется dst

ImagingOpException - если src не может фильтроваться

фильтр

public final WritableRaster filter(Raster src,
                                   WritableRaster dst)

Выполняет свертку на Растрах. Каждая полоса исходного Растра будет скручена. У источника и места назначения должно быть то же самое число полос. Если целевой Растр будет нулем, то новый Растр будет создаваться. 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 будет нулем, то соответствующий ColorModel будет использоваться.

Определенный:

createCompatibleDestImage в интерфейсе BufferedImageOp

Параметры:

src - Исходное изображение для работы фильтра.

destCM - ColorModel места назначения. Может быть нуль.

Возвраты:

место назначения BufferedImage с корректным размером и числом полос.

createCompatibleDestRaster

public WritableRaster createCompatibleDestRaster(Raster src)

Создает обнуленный целевой Растр с корректным размером и числом полос, учитывая этот источник.

Определенный:

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

Параметры:

src - источник Raster

Возвраты:

a 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

Возвраты:

a Rectangle2D это - ограничивающий прямоугольник Raster следуя из работы фильтрации.

getPoint2D

public final Point2D getPoint2D(Point2D srcPt,
                                Point2D dstPt)

Возвращает расположение пункта назначения, данного точку в источнике. Если dstPt будет ненулем, то он будет использоваться, чтобы содержать возвращаемое значение. Так как это не геометрическая работа, srcPt будет равняться dstPt.

Определенный:

getPoint2D в интерфейсе BufferedImageOp

Определенный:

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

Параметры:

srcPt - Point2D это представляет точку в исходном изображении

dstPt - Point2D в котором можно сохранить результат

Возвраты:

Point2D в целевом изображении, которое соответствует указанной точке в исходном изображении.

getRenderingHints

public final RenderingHints getRenderingHints()

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

Определенный:

getRenderingHints в интерфейсе BufferedImageOp

Определенный:

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

Возвраты:

RenderingHints объект для этого BufferedImageOp. Нуль возвратов, если никакие подсказки не были установлены.