com.github.sarxos.webcam.util.jh

Class JHBlurFilter

java.lang.Object

com.github.sarxos.webcam.util.jh.JHFilter

com.github.sarxos.webcam.util.jh.JHBlurFilter

All Implemented Interfaces:

java.awt.image.BufferedImageOp

public class JHBlurFilter
extends JHFilter

A filter which performs a box blur on an image. The horizontal and vertical blurs can be specified separately and a number of iterations can be given which allows an approximation to Gaussian blur.

Constructor Summary

Constructors

Constructor and Description
JHBlurFilter() Construct a default BoxBlurFilter.
JHBlurFilter(float hRadius, float vRadius, int iterations) Construct a BoxBlurFilter.

Method Summary

Modifier and Type	Method and Description
static void	blur(int[] in, int[] out, int width, int height, float radius) Blur and transpose a block of ARGB pixels.
static void	blurFractional(int[] in, int[] out, int width, int height, float radius)
static int	clamp(int x, int a, int b) Clamp a value to an interval.
java.awt.image.BufferedImage	filter(java.awt.image.BufferedImage src, java.awt.image.BufferedImage dst)
float	getHRadius() Get the horizontal size of the blur.
int	getIterations() Get the number of iterations the blur is performed.
boolean	getPremultiplyAlpha() Get whether to premultiply the alpha channel.
float	getRadius() Get the size of the blur.
float	getVRadius() Get the vertical size of the blur.
static void	premultiply(int[] p, int offset, int length) Premultiply a block of pixels
void	setHRadius(float hRadius) Set the horizontal size of the blur.
void	setIterations(int iterations) Set the number of iterations the blur is performed.
void	setPremultiplyAlpha(boolean premultiplyAlpha) Set whether to premultiply the alpha channel.
void	setRadius(float radius) Set both the horizontal and vertical sizes of the blur.
void	setVRadius(float vRadius) Set the vertical size of the blur.
java.lang.String	toString()
static void	unpremultiply(int[] p, int offset, int length) Premultiply a block of pixels

Methods inherited from class com.github.sarxos.webcam.util.jh.JHFilter

createCompatibleDestImage, getBounds2D, getPoint2D, getRenderingHints, getRGB, setRGB

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

JHBlurFilter

public JHBlurFilter()

Construct a default BoxBlurFilter.

JHBlurFilter

public JHBlurFilter(float hRadius,
                    float vRadius,
                    int iterations)

Construct a BoxBlurFilter.

Parameters:

hRadius - the horizontal radius of blur

vRadius - the vertical radius of blur

iterations - the number of time to iterate the blur

Method Detail

setPremultiplyAlpha

public void setPremultiplyAlpha(boolean premultiplyAlpha)

Set whether to premultiply the alpha channel.

Parameters:

premultiplyAlpha - true to premultiply the alpha

See Also:

getPremultiplyAlpha()

getPremultiplyAlpha

public boolean getPremultiplyAlpha()

Get whether to premultiply the alpha channel.

Returns:

true to premultiply the alpha

See Also:

setPremultiplyAlpha(boolean)

filter

public java.awt.image.BufferedImage filter(java.awt.image.BufferedImage src,
                                           java.awt.image.BufferedImage dst)

blur

public static void blur(int[] in,
                        int[] out,
                        int width,
                        int height,
                        float radius)

Blur and transpose a block of ARGB pixels.

Parameters:

in - the input pixels

out - the output pixels

width - the width of the pixel array

height - the height of the pixel array

radius - the radius of blur

blurFractional

public static void blurFractional(int[] in,
                                  int[] out,
                                  int width,
                                  int height,
                                  float radius)

setHRadius

public void setHRadius(float hRadius)

Set the horizontal size of the blur. Minimum hRadius value is 0.

Parameters:

hRadius - the radius of the blur in the horizontal direction

See Also:

getHRadius()

getHRadius

public float getHRadius()

Get the horizontal size of the blur.

Returns:

the radius of the blur in the horizontal direction

See Also:

setHRadius(float)

setVRadius

public void setVRadius(float vRadius)

Set the vertical size of the blur. Minimal vRadius value is 0.

Parameters:

vRadius - the radius of the blur in the vertical direction

See Also:

getVRadius()

getVRadius

public float getVRadius()

Get the vertical size of the blur.

Returns:

the radius of the blur in the vertical direction

See Also:

setVRadius(float)

setRadius

public void setRadius(float radius)

Set both the horizontal and vertical sizes of the blur. Minimum value is 0.

Parameters:

radius - the radius of the blur in both directions

See Also:

getRadius()

getRadius

public float getRadius()

Get the size of the blur.

Returns:

the radius of the blur in the horizontal direction

See Also:

setRadius(float)

setIterations

public void setIterations(int iterations)

Set the number of iterations the blur is performed. Minimum value is 0.

Parameters:

iterations - the number of iterations

See Also:

getIterations()

getIterations

public int getIterations()

Get the number of iterations the blur is performed.

Returns:

the number of iterations

See Also:

setIterations(int)

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object

premultiply

public static void premultiply(int[] p,
                               int offset,
                               int length)

Premultiply a block of pixels

Parameters:

p - pixels

offset - the offset

length - the length

unpremultiply

public static void unpremultiply(int[] p,
                                 int offset,
                                 int length)

Premultiply a block of pixels

Parameters:

p - the pixels

offset - the offset

length - the length

clamp

public static int clamp(int x,
                        int a,
                        int b)

Clamp a value to an interval.

Parameters:

a - the lower clamp threshold

b - the upper clamp threshold

x - the input parameter

Returns:

the clamped value