Spec-Zone.ru › OpenJDK 17

Класс ConvolveOp

java.lang.Object
java.awt.image.ConvolveOp
Все реализуемые интерфейсы:
BufferedImageOp, RasterOp 
public class ConvolveOp extends Object implements BufferedImageOp, RasterOp
Этот класс реализует свертку от источника к пункту назначения. Свертка, использующая ядро свертки, — это пространственная операция, которая вычисляет выходной пиксель из входного пикселя путём умножения ядра на окружение входного пикселя. Это позволяет выходному пикселю быть подверженным влиянию ближайшего окружения таким образом, который может быть математически задан ядром.

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

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

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

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

См. также:
  • Kernel
  • RenderingHints.KEY_COLOR_RENDERING
  • RenderingHints.KEY_DITHERING

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

Модификатор и тип Поле Описание
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)
Выполняет свертку над BufferedImages.
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()
Возвращает параметры рендеринга для этой операции.

Методы, объявленные в классе java.lang.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
См. также:
  • 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)
Выполняет свёртку над BufferedImages. Каждый компонент исходного изображения будет подвергнут свёртке (включая альфа-компонент, если он присутствует). Если цветовой профиль в исходном изображении не совпадает с тем в изображении назначения, пиксели будут преобразованы в изображении назначения. Если изображение назначения равно 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)
Выполняет свёртку над Rasters. Каждый канал исходного Raster будет подвергнут свёртке. Исходный и конечный Raster должны иметь одинаковое количество каналов. Если конечный Raster равен null, новый Raster будет создан. IllegalArgumentException может быть выброшен, если исходный и конечный Raster совпадают.
Установлено в:
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)
Создаёт конечный Raster с нулевыми значениями, соответствующего размера и количества каналов, исходя из исходного.
Установлено в:
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)
Возвращает прямоугольник, содержащий отфильтрованный конечный Raster. Поскольку это не геометрическая операция, прямоугольник не изменяется.
Установлено в:
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, 2021, 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/17/docs/api/java.desktop/java/awt/image/ConvolveOp.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API