java.awt.image

Class ConvolveOp

java.lang.Object

java.awt.image.ConvolveOp

All Implemented Interfaces:

BufferedImageOp， RasterOp

public class ConvolveOp
extends Object
implements BufferedImageOp, RasterOp

这个类实现从源到目的地的一个卷积。使用卷积核的卷积是一个空间运算，通过将内核与输入像素的环绕相乘来计算输入像素的输出像素。这允许输出像素受直接邻域的影响，用一个内核可以用数学上指定的方式来使用。

这类操作数据中BufferedImage颜色分量的alpha分量进行。如果Source BufferedImage有一个alpha分量，和颜色分量与不进行alpha分量，然后数据进行卷积之前。如果目的地不进行颜色分量，然后α分之前存储到目的地（如α为0，颜色分量设置为0）。如果目的地没有阿尔法组件，则将产生的阿尔法被丢弃后，首先将其划分出来的颜色组件。

光栅作为没有Alpha通道。如果在bufferedimages alpha通道以上的治疗是不需要的，它可以让一个源BufferedImage栅格和利用这类作品的滤波方法，避免与Rasters。

如果一个renderinghints对象在构造函数中指定的颜色，渲染提示和抖动提示时可使用颜色转换是必需的。

请注意，源和目标可能不是同一个对象。

另请参见：

Kernel， RenderingHints.KEY_COLOR_RENDERING， RenderingHints.KEY_DITHERING

Field Summary

Fields

Modifier and Type	Field and Description
static int	EDGE_NO_OP 在源图像的边缘的像素被复制到目标中的相应的像素，而无需修改。
static int	EDGE_ZERO_FILL 在目标图像的边缘的像素被设置为零。

构造方法摘要

构造方法

Constructor and Description
ConvolveOp(Kernel kernel) 构建了一个内核中的ConvolveOp。
ConvolveOp(Kernel kernel, int edgeCondition, RenderingHints hints) 构建中的ConvolveOp给出一个内核，一个边界条件，和renderinghints对象（可能为空）。

方法摘要

Modifier and Type	Method and Description
BufferedImage	createCompatibleDestImage(BufferedImage src, ColorModel destCM) 创建一个锁定目的地形象与正确的大小和数量的频带。
WritableRaster	createCompatibleDestRaster(Raster src) 创建一个锁定目标栅格与正确的尺寸和数量的乐队，这个源。
BufferedImage	filter(BufferedImage src, BufferedImage dst) 对bufferedimages卷积。
WritableRaster	filter(Raster src, WritableRaster dst) 对Rasters卷积。
Rectangle2D	getBounds2D(BufferedImage src) 返回过滤后的目标图像的包围盒。
Rectangle2D	getBounds2D(Raster src) 返回筛选的目标光栅的包围盒。
int	getEdgeCondition() 返回边缘条件。
Kernel	getKernel() 返回内核。
Point2D	getPoint2D(Point2D srcPt, Point2D dstPt) 返回源中给定一个点的目标点的位置。
RenderingHints	getRenderingHints() 返回渲染暗示这个作品。

Methods inherited from class java.lang.Object

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

Field Detail

EDGE_ZERO_FILL

@Native
public static final int EDGE_ZERO_FILL

在目标图像的边缘的像素被设置为零。这是默认值。

另请参见：

Constant Field Values

EDGE_NO_OP

@Native
public static final int EDGE_NO_OP

在源图像的边缘的像素被复制到目标中的相应的像素，而无需修改。

另请参见：

Constant Field Values

Constructor Detail

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

返回内核。

结果

这 ConvolveOp的 Kernel。

filter

public final BufferedImage filter(BufferedImage src,
                                  BufferedImage dst)

对bufferedimages卷积。源图像的每个组件将卷积（包括alpha分量，如果存在的话）。如果源图像中的颜色模型与目标图像中的颜色不相同，则将在目标中转换像素。如果目标图像是空，一BufferedImage将要创建的源。的时可能如果来源是作为目的地相同的投。

Specified by:

filter 接口 BufferedImageOp

参数

src -源 BufferedImage过滤

dst -过滤 src目的 BufferedImage

结果

过滤后的 BufferedImage

异常

如果是 null src NullPointerException

IllegalArgumentException -如果 src等于 dst

ImagingOpException -如果 src不能被过滤

filter

public final WritableRaster filter(Raster src,
                                   WritableRaster dst)

对Rasters卷积。的源栅格每个乐队将卷积。源和目的地必须具有相同的带数。如果目标光栅为空，将创建一个新的光栅。的时可能如果来源是作为目的地相同的投。

Specified by:

filter 接口 RasterOp

参数

src -源 Raster过滤

dst -过滤 src目的 WritableRaster

结果

过滤后的 WritableRaster

异常

如果是 null src NullPointerException

ImagingOpException -如果 src和 dst没有相同数量的频带

ImagingOpException -如果 src不能被过滤

IllegalArgumentException -如果 src等于 dst

createCompatibleDestImage

public BufferedImage createCompatibleDestImage(BufferedImage src,
                                               ColorModel destCM)

创建一个锁定目的地形象与正确的大小和数量的频带。如果destcm是无效的，适当的要会用。

Specified by:

createCompatibleDestImage 接口 BufferedImageOp

参数

src -过滤操作的源图像。

destCM -目的地ColorModel。可以为空。

结果

具有正确的大小和数量的目的 BufferedImage乐队。

createCompatibleDestRaster

public WritableRaster createCompatibleDestRaster(Raster src)

创建一个锁定目标栅格与正确的尺寸和数量的乐队，这个源。

Specified by:

createCompatibleDestRaster 接口 RasterOp

参数

src -源 Raster

结果

一个 WritableRaster是兼容 src

getBounds2D

public final Rectangle2D getBounds2D(BufferedImage src)

返回过滤后的目标图像的包围盒。由于这不是一个几何操作，包围盒不改变。

Specified by:

getBounds2D 接口 BufferedImageOp

参数

src - BufferedImage被过滤

结果

代表目标图像的边界框的 Rectangle2D。

getBounds2D

public final Rectangle2D getBounds2D(Raster src)

返回筛选的目标光栅的包围盒。由于这不是一个几何操作，包围盒不改变。

Specified by:

getBounds2D 接口 RasterOp

参数

src -源 Raster

结果

这是一个 Rectangle2D的 Raster导致从过滤操作的包围盒。

getPoint2D

public final Point2D getPoint2D(Point2D srcPt,
                                Point2D dstPt)

返回源中给定一个点的目标点的位置。如果dstpt是非空的，它会被用来保存返回值。因为这不是一个几何操作的srcpt将等于dstpt。

Specified by:

getPoint2D 接口 BufferedImageOp

Specified by:

getPoint2D 接口 RasterOp

参数

srcPt -代表源图像中的点的 Point2D

dstPt -其中 Point2D存储结果

结果

在对应于源图像中的指定点目标图像的 Point2D。

getRenderingHints

public final RenderingHints getRenderingHints()

返回渲染暗示这个作品。

Specified by:

getRenderingHints 接口 BufferedImageOp

Specified by:

getRenderingHints 接口 RasterOp

结果

这 BufferedImageOp的 RenderingHints对象。如果没有提示已设置返回null。