Trail: 2D Graphics
Lesson: Manipulating and Displaying Images
Filtering a BufferedImage
Filtering a BufferedImage
The Java 2D API defines several filtering operations for BufferedImage objects. Each image-processing operation is embodied in a class that implements the BufferedImageOp interface. The image manipulation is performed in the image operation's filter method. The BufferedImageOp classes in the Java 2D API support

To filter a BufferedImage using one of the image operation classes, you

  1. Construct an instance of one of the BufferedImageOp classes: AffineTransformOp, BandCombineOp, ColorConvertOp, ConvolveOp, LookupOp, or RescaleOp.
  2. Call the image operation's filter method, passing in the BufferedImage that you want to filter and the BufferedImage where you want to store the results.

Example: ImageOps

The following applet illustrates the use of four image-filter operations: low-pass, sharpen, lookup, and rescale.

Click this figure to run the applet.
This is a picture of the applet's GUI. To run the applet, click the picture. The applet will appear in a new browser window.

You can see the complete code for this applet in ImageOps.java. The applet uses these two image files: bld.jpg and boat.gif.

The sharpen filter is performed by using a ConvolveOp. Convolution is the process of weighting or averaging the value of each pixel in an image with the values of neighboring pixels. Most spatial-filtering algorithms are based on convolution operations.

To construct and apply the sharpen filter to the BufferedImage, this sample uses code similar to the following snippet.

public static final float[] SHARPEN3x3 = {
                            0.f, -1.f, 0.f,
                            -1.f, 5.0f, -1.f,
                            0.f, -1.f, 0.f};
BufferedImage dstbimg = new 
              BufferedImage(iw,ih,BufferedImage.TYPE_INT_RGB);
Kernel kernel = new Kernel(3,3,SHARPEN3x3);
ConvolveOp cop = new ConvolveOp(kernel,
                                ConvolveOp.EDGE_NO_OP,
                                null);
cop.filter(srcbimg,dstbimg);

The Kernel object mathematically defines how each output pixel is affected by pixels in its immediate area.The definition of the Kernel determines the results of the filter. For more information about how kernels work with ConvolveOp , see the Image Processing and Enhancement section in the Java 2D Programmer's Guide .

Previous page: Immediate-Mode Imaging with BufferedImage
Next page: Using a BufferedImage for Double Buffering