Class FastBlurFilter

  • All Implemented Interfaces:
    java.awt.image.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 Detail

      • radius

        private final int radius
    • Constructor Detail

      • 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 Detail

      • getRadius

        public int getRadius()

        Returns the radius used by this filter, in pixels.

        Returns:
        the radius of the blur
      • filter

        public java.awt.image.BufferedImage filter​(java.awt.image.BufferedImage src,
                                                   java.awt.image.BufferedImage dst)
        Specified by:
        filter in interface java.awt.image.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