Kernel (Java 2 Platform SE 5.0) (original) (raw)

java.awt.image

Class Kernel

java.lang.Object extended by java.awt.image.Kernel

All Implemented Interfaces:

public class Kernel

The Kernel class defines a matrix that describes how a specified pixel and its surrounding pixels affect the value computed for the pixel's position in the output image of a filtering operation. The X origin and Y origin indicate the kernel matrix element that corresponds to the pixel position for which an output value is being computed.

See Also:

ConvolveOp

Constructor Summary
[Kernel](../../../java/awt/image/Kernel.html#Kernel%28int, int, float[]%29)(int width, int height, float[] data) Constructs a Kernel object from an array of floats.

Method Summary
Object	clone() Clones this object.
int	getHeight() Returns the height of this Kernel.
float[]	getKernelData(float[] data) Returns the kernel data in row major order.
int	getWidth() Returns the width of this Kernel.
int	getXOrigin() Returns the X origin of this Kernel.
int	getYOrigin() Returns the Y origin of this Kernel.

Methods inherited from class java.lang.Object
equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, [wait](../../../java/lang/Object.html#wait%28long, int%29)

Constructor Detail

Kernel

public Kernel(int width, int height, float[] data)

Constructs a Kernel object from an array of floats. The first width*height elements of the data array are copied. If the length of the data array is less than width*height, an IllegalArgumentException is thrown. The X origin is (width-1)/2 and the Y origin is (height-1)/2.

Parameters:

width - width of the kernel

height - height of the kernel

data - kernel data in row major order

Throws:

[IllegalArgumentException](../../../java/lang/IllegalArgumentException.html "class in java.lang") - if the length of data is less than the product of width and height

Method Detail

getXOrigin

public final int getXOrigin()

Returns the X origin of this Kernel.

Returns:

the X origin.

getYOrigin

public final int getYOrigin()

Returns the Y origin of this Kernel.

Returns:

the Y origin.

getWidth

public final int getWidth()

Returns the width of this Kernel.

Returns:

the width of this Kernel.

getHeight

public final int getHeight()

Returns the height of this Kernel.

Returns:

the height of this Kernel.

getKernelData

public final float[] getKernelData(float[] data)

Returns the kernel data in row major order. The data array is returned. If data is null, a new array is allocated.

Parameters:

data - if non-null, contains the returned kernel data

Returns:

the data array containing the kernel data in row major order or, if data is null, a newly allocated array containing the kernel data in row major order

Throws:

[IllegalArgumentException](../../../java/lang/IllegalArgumentException.html "class in java.lang") - if data is less than the size of this Kernel

clone

public Object clone()

Clones this object.

Overrides:

[clone](../../../java/lang/Object.html#clone%28%29) in class [Object](../../../java/lang/Object.html "class in java.lang")

Returns:

a clone of this object.

See Also:

Cloneable

Submit a bug or feature
For further API reference and developer documentation, see Java 2 SDK SE Developer Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.