Class FastBlurFilter

All Implemented Interfaces:
BufferedImageOp

public class FastBlurFilter extends AbstractFilter

A fast blur filter can be used to blur pictures quickly. This filter is an implementation of the box blur algorithm. The blurs generated by this algorithm might show square artifacts, especially on pictures containing straight lines (rectangles, text, etc.) On most pictures though, the result will look very good.

The force of the blur can be controlled with a radius and the default radius is 3. Since the blur clamps values on the edges of the source picture, you might need to provide a picture with empty borders to avoid artifacts at the edges. The performance of this filter are independent from the radius.

  • Field Details

    • radius

      private final int radius
  • Constructor Details

    • FastBlurFilter

      public FastBlurFilter()

      Creates a new blur filter with a default radius of 3.

    • FastBlurFilter

      public FastBlurFilter(int radius)

      Creates a new blur filter with the specified radius. If the radius is lower than 1, a radius of 1 will be used automatically.

      Parameters:
      radius - the radius, in pixels, of the blur
  • Method Details

    • getRadius

      public int getRadius()

      Returns the radius used by this filter, in pixels.

      Returns:
      the radius of the blur
    • filter

      public BufferedImage filter(BufferedImage src, BufferedImage dst)
      Specified by:
      filter in interface BufferedImageOp
      Specified by:
      filter in class AbstractFilter
    • blur

      static void blur(int[] srcPixels, int[] dstPixels, int width, int height, int radius)

      Blurs the source pixels into the destination pixels. The force of the blur is specified by the radius which must be greater than 0.

      The source and destination pixels arrays are expected to be in the INT_ARGB format.

      After this method is executed, dstPixels contains a transposed and filtered copy of srcPixels.

      Parameters:
      srcPixels - the source pixels
      dstPixels - the destination pixels
      width - the width of the source picture
      height - the height of the source picture
      radius - the radius of the blur effect