ConvolveOp

目录搜索

文字

概述

软件包

类

使用

树

已过时

索引

帮助

Java^TM 2 Platform
Standard Ed. 6

上一个类 下一个类

框架 无框架

摘要：嵌套 | 字段 | 构造方法 | 方法

详细信息：字段 | 构造方法 | 方法

java.awt.image
类 ConvolveOp

java.lang.Object
  java.awt.image.ConvolveOp

所有已实现的接口：: BufferedImageOp, RasterOp

public class ConvolveOp
extends Object
implements BufferedImageOp, RasterOp

此类实现从源到目标的卷积。使用卷积核的卷积是一种通过输入像素来计算输出像素的空间运算，方法是将核与输入像素邻域相乘。这种运算使得直接邻域可按核数学指定的方式影响输出像素。

此类可对颜色分量预乘 alpha 分量的 BufferedImage 数据进行运算。如果源 BufferedImage 有 alpha 分量，并且颜色分量没有预乘 alpha 分量，则在卷积运算前要先预乘该数据。如果 Destination 有未进行预乘的颜色分量，则在存入到 Destination 之前除以 alpha 分量（如果 alpha 为 0，则颜色分量被设置为 0）。如果 Destination 没有 alpha 分量，则在颜色分量除以 alpha 分量之从后即丢弃 alpha 分量。

Raster 被看作是没有 alpha 通道的。如果不希望对 BufferedImage 中的 alpha 通道进行上述处理，则可以通过获取源 BufferedImage 的 Raster 和使用与 Raster 一起工作的此类的 filter 方法予以避免。

如果 RenderingHints 对象是在构造方法中指定的，则在需要进行颜色变换时使用颜色呈现提示和抖动提示。

注意，Source 和 Destination 可能不是同一个对象。

另请参见：: Kernel, RenderingHints.KEY_COLOR_RENDERING, RenderingHints.KEY_DITHERING

字段摘要
`static int`	`EDGE_NO_OP` 将位于源图像边缘的像素复制为目标中相应的像素，不加修改。
`static int`	`EDGE_ZERO_FILL` 位于目标图像边缘的像素被设置为 0。

构造方法摘要
`ConvolveOp(Kernel kernel)` 构造给定了 Kernel 的 ConvolveOp。
`ConvolveOp(Kernel kernel, int edgeCondition, RenderingHints hints)` 构造给定 Kernel、边缘条件和 RenderingHint 对象（可以为 null）的 ConvolveOp。

方法摘要
`BufferedImage`	`createCompatibleDestImage(BufferedImage src, ColorModel destCM)` 创建具有正确 band 大小和数量的归零目标图像。
`WritableRaster`	`createCompatibleDestRaster(Raster src)` 创建给定源且具有正确 band 大小和数量的归零目标 Raster。
`BufferedImage`	`filter(BufferedImage src, BufferedImage dst)` 对 BufferedImage 执行卷积运算。
`WritableRaster`	`filter(Raster src, WritableRaster dst)` 对 Raster 执行卷积运算。
`Rectangle2D`	`getBounds2D(BufferedImage src)` 返回已过滤目标图像的边界框。
`Rectangle2D`	`getBounds2D(Raster src)` 返回已过滤目标 Raster 的边界框。
`int`	`getEdgeCondition()` 返回边缘条件。
`Kernel`	`getKernel()` 返回 Kernel。
`Point2D`	`getPoint2D(Point2D srcPt, Point2D dstPt)` 返回源中给定点的目标点位置。
`RenderingHints`	`getRenderingHints()` 返回此 op 的呈现提示。

从类 java.lang.Object 继承的方法
`clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait`

字段详细信息

EDGE_ZERO_FILL

public static final int EDGE_ZERO_FILL

位于目标图像边缘的像素被设置为 0。这是默认设置。

另请参见：: 常量字段值

EDGE_NO_OP

public static final int EDGE_NO_OP

将位于源图像边缘的像素复制为目标中相应的像素，不加修改。

另请参见：: 常量字段值

构造方法详细信息

public ConvolveOp(Kernel kernel,
                  int edgeCondition,
                  RenderingHints hints)

构造给定 Kernel、边缘条件和 RenderingHint 对象（可以为 null）的 ConvolveOp。

参数：: kernel - 指定的 Kernel; edgeCondition - 指定的边缘条件; hints - 指定的 RenderingHints 对象

另请参见：

Kernel, EDGE_NO_OP, EDGE_ZERO_FILL, RenderingHints

ConvolveOp

public ConvolveOp(Kernel 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 的 Kernel。

filter

public final BufferedImage filter(BufferedImage src,
                                  BufferedImage dst)

对 BufferedImage 执行卷积运算。源图像的每个分量都将被卷积处理（包括 alpha 分量，如果存在）。如果源图像中的颜色模型与目标图像中的不相同，则像素将按目标中像素转换。如果目标图像为 null，则使用源 ColorModel 创建 BufferedImage。如果源与目标相同，则可能抛出 IllegalArgumentException。

指定者：: 接口 BufferedImageOp 中的 filter

参数：: src - 要过滤的源 BufferedImage; dst - 已过滤的 src 的目标 BufferedImage

返回：

已过滤的 BufferedImage

抛出：

NullPointerException - 如果 src 为 null

IllegalArgumentException - 如果 src 等于 dst

ImagingOpException - 如果 src 不能过滤

filter

public final WritableRaster filter(Raster src,
                                   WritableRaster dst)

对 Raster 执行卷积运算。源 Raster 的每个 band 都将被卷积处理。源和目标必须有相同数量的 band。如果目标 Raster 为 null，则创建新 Raster。如果源与目标相同，则可能抛出 IllegalArgumentException。

指定者：: 接口 RasterOp 中的 filter

参数：: src - 要过滤的源 Raster; dst - 已过滤的 src 的目标 WritableRaster

返回：

已过滤的 WritableRaster

抛出：

NullPointerException - 如果 src 为 null

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

ImagingOpException - 如果 src 不能过滤

IllegalArgumentException - 如果 src 等于 dst

createCompatibleDestImage

public BufferedImage createCompatibleDestImage(BufferedImage src,
                                               ColorModel destCM)

创建具有正确 band 大小和数量的归零目标图像。如果 destCM 为 null，则使用适当的 ColorModel。

指定者：: 接口 BufferedImageOp 中的 createCompatibleDestImage

参数：: src - 进行过滤操作的源图像。; destCM - 目标的 ColorModel。可以为 null。

返回：

具有正确 band 大小和数量的 BufferedImage。

createCompatibleDestRaster

public WritableRaster createCompatibleDestRaster(Raster src)

创建给定源且具有正确 band 大小和数量的归零目标 Raster。

指定者：: 接口 RasterOp 中的 createCompatibleDestRaster

参数：: src - 源 Raster
返回：: 与 src 兼容的 WritableRaster

getBounds2D

public final Rectangle2D getBounds2D(BufferedImage src)

返回已过滤目标图像的边界框。因为这不是几何操作，所以边界框不变。

指定者：: 接口 BufferedImageOp 中的 getBounds2D

参数：: src - 要过滤的 BufferedImage
返回：: 表示目标图像边界框的 Rectangle2D。

getBounds2D

public final Rectangle2D getBounds2D(Raster src)

返回已过滤目标 Raster 的边界框。因为这不是几何操作，所以边界框不变。

指定者：: 接口 RasterOp 中的 getBounds2D

参数：: src - 源 Raster
返回：: 一个 Rectangle2D，它是从过滤操作得到的 Raster 的边界框。

getPoint2D

public final Point2D getPoint2D(Point2D srcPt,
                                Point2D dstPt)

返回源中给定点的目标点位置。如果 dstPt 为非 null，则该位置将用来存储返回值。因为这不是几何操作，所以 srcPt 将等于 dstPt。

指定者：: 接口 BufferedImageOp 中的 getPoint2D
指定者：: 接口 RasterOp 中的 getPoint2D

参数：: srcPt - 表示源图像中点的 Point2D; dstPt - 用于存储结果的 Point2D

返回：

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

getRenderingHints

public final RenderingHints getRenderingHints()

返回此 op 的呈现提示。

指定者：: 接口 BufferedImageOp 中的 getRenderingHints
指定者：: 接口 RasterOp 中的 getRenderingHints

返回：: 针对此 BufferedImageOp 的 RenderingHints 对象。如果没有设置提示，则返回 null。

概述

软件包

类

使用

树

已过时

索引

帮助

Java^TM 2 Platform
Standard Ed. 6

上一个类 下一个类

框架 无框架

摘要：嵌套 | 字段 | 构造方法 | 方法

详细信息：字段 | 构造方法 | 方法

提交错误或意见
有关更多的 API 参考资料和开发人员文档，请参阅 Java 2 SDK SE 开发人员文档。该文档包含更详细的、面向开发人员的描述，以及总体概述、术语定义、使用技巧和工作代码示例。

java.awt.image 类 ConvolveOp

EDGE_ZERO_FILL

EDGE_NO_OP

ConvolveOp

ConvolveOp

getEdgeCondition

getKernel

filter

filter

createCompatibleDestImage

createCompatibleDestRaster

getBounds2D

getBounds2D

getPoint2D

getRenderingHints

java.awt.image
类 ConvolveOp