|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectjava.awt.image.ConvolveOp
public class ConvolveOp
Convolution filter. ConvolveOp convolves the source image with a Kernel to generate a destination image. This involves multiplying each pixel and its neighbors with elements in the kernel to compute a new pixel. Each band in a Raster is convolved and copied to the destination Raster. For BufferedImages, convolution is applied to all components. Color conversion will be applied if needed. Note that this filter ignores whether the source or destination is alpha premultiplied. The reference spec states that data will be premultiplied prior to convolving and divided back out afterwards (if needed), but testing has shown that this is not the case with their implementation.
Field Summary | |
---|---|
static int |
EDGE_NO_OP
Edge pixels are copied from the source. |
static int |
EDGE_ZERO_FILL
Edge pixels are set to 0. |
Constructor Summary | |
---|---|
ConvolveOp(Kernel kernel)
Construct a ConvolveOp. |
|
ConvolveOp(Kernel kernel,
int edgeCondition,
RenderingHints hints)
Construct a ConvolveOp. |
Method Summary | |
---|---|
BufferedImage |
createCompatibleDestImage(BufferedImage src,
ColorModel dstCM)
Creates an empty BufferedImage with the size equal to the source and the correct number of bands. |
WritableRaster |
createCompatibleDestRaster(Raster src)
Returns a raster that can be used by this RasterOp as the
destination raster when operating on the specified source raster. |
BufferedImage |
filter(BufferedImage src,
BufferedImage dst)
Converts the source image using the kernel specified in the constructor. |
WritableRaster |
filter(Raster src,
WritableRaster dest)
Converts the source raster using the kernel specified in the constructor. |
Rectangle2D |
getBounds2D(BufferedImage src)
Returns the bounds of the destination image on the basis of this BufferedImageOp being applied to the specified source image. |
Rectangle2D |
getBounds2D(Raster src)
Returns the bounds of the destination raster on the basis of this RasterOp being applied to the specified source raster. |
int |
getEdgeCondition()
Get the edge condition for this Op. |
Kernel |
getKernel()
Returns (a clone of) the convolution kernel. |
Point2D |
getPoint2D(Point2D src,
Point2D dst)
Returns the corresponding destination point for a source point. |
RenderingHints |
getRenderingHints()
Returns the rendering hints for this operation. |
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Field Detail |
---|
public static final int EDGE_ZERO_FILL
public static final int EDGE_NO_OP
Constructor Detail |
---|
public ConvolveOp(Kernel kernel, int edgeCondition, RenderingHints hints)
kernel
- The kernel to convolve with.edgeCondition
- Either EDGE_ZERO_FILL or EDGE_NO_OP.hints
- Rendering hints for color conversion, or null.public ConvolveOp(Kernel kernel)
kernel
- The kernel to convolve with.Method Detail |
---|
public final BufferedImage filter(BufferedImage src, BufferedImage dst)
filter
in interface BufferedImageOp
src
- The source image.dst
- The destination image.
IllegalArgumentException
- if the rasters and/or color spaces are
incompatible.public BufferedImage createCompatibleDestImage(BufferedImage src, ColorModel dstCM)
createCompatibleDestImage
in interface BufferedImageOp
src
- The source image.dstCM
- A color model for the destination image (may be null).
public final RenderingHints getRenderingHints()
BufferedImageOp
getRenderingHints
in interface BufferedImageOp
getRenderingHints
in interface RasterOp
public int getEdgeCondition()
public final Kernel getKernel()
public final WritableRaster filter(Raster src, WritableRaster dest)
filter
in interface RasterOp
src
- The source raster.dest
- The destination raster.
IllegalArgumentException
- if the rasters identical.
ImagingOpException
- if the convolution is not possible.public WritableRaster createCompatibleDestRaster(Raster src)
RasterOp
RasterOp
as the
destination raster when operating on the specified source raster.
createCompatibleDestRaster
in interface RasterOp
src
- the source raster.
public final Rectangle2D getBounds2D(BufferedImage src)
BufferedImageOp
BufferedImageOp
being applied to the specified source image.
getBounds2D
in interface BufferedImageOp
src
- the source image.
public final Rectangle2D getBounds2D(Raster src)
RasterOp
RasterOp
being applied to the specified source raster.
getBounds2D
in interface RasterOp
src
- the source raster.
public final Point2D getPoint2D(Point2D src, Point2D dst)
getPoint2D
in interface BufferedImageOp
getPoint2D
in interface RasterOp
src
- The source point.dst
- The transformed destination point.
|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |