Class Kernel

java.lang.Object
java.awt.image.Kernel
All Implemented Interfaces:
Cloneable
public class Kernel extends Object implements Cloneable
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:

  • Constructor Summary

    Constructors
    Constructor
    Description
    Kernel(int width, int height, float[] data)
    Constructs a Kernel object from an array of floats.

  • Method Summary

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

    Methods declared in class Object

    equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
    Modifier and Type
    Method
    Description
    boolean
    equals(Object o)
    Compares the argument to the receiver, and answers true if they represent the same object using a class specific comparison.
    protected void
    finalize()
    Deprecated, for removal: This API element is subject to removal in a future version.
    May cause performance issues, deadlocks and hangs.
    final Class<? extends Object>
    getClass()
    Answers the unique instance of java.lang.Class which represents the class of the receiver.
    int
    hashCode()
    Answers an integer hash code for the receiver.
    final void
    notify()
    Causes one thread which is waiting on the receiver to be made ready to run.
    final void
    notifyAll()
    Causes all threads which are waiting on the receiver to be made ready to run.
    String
    toString()
    Answers a string containing a concise, human-readable description of the receiver.
    final void
    wait()
    Causes the thread which sent this message to be made not ready to run pending some change in the receiver (as indicated by notify or notifyAll).
    final void
    wait(long time)
    Causes the thread which sent this message to be made not ready to run either pending some change in the receiver (as indicated by notify or notifyAll) or the expiration of the timeout.
    final void
    wait(long time, int frac)
    Causes the thread which sent this message to be made not ready to run either pending some change in the receiver (as indicated by notify or notifyAll) or the expiration of the timeout.

  • Constructor Details

    • 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:
      NullPointerException - if data is null
      IllegalArgumentException - if width or height is not positive
      IllegalArgumentException - if product of width and height overflows an int
      IllegalArgumentException - if the length of data is less than the product of width and height

  • Method Details

    • 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 - if data is less than the size of this Kernel

    • clone

      public Object clone()
      Clones this object.
      Overrides:
      clone in class Object
      Returns:
      a clone of this object.