1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136
/* * @(#)Kernel.java 1.23 05/11/17 * * Copyright 2006 Sun Microsystems, Inc. All rights reserved. * SUN PROPRIETARY/CONFIDENTIAL. Use is subject to license terms. */ package java.awt.image; /** * The <code>Kernel</code> 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 ConvolveOp * @version 10 Feb 1997 */ public class Kernel implements Cloneable { private int width; private int height; private int xOrigin; private int yOrigin; private float data[]; private static native void initIDs(); static { ColorModel.loadLibraries(); initIDs(); } /** * Constructs a <code>Kernel</code> object from an array of floats. * The first <code>width</code>*<code>height</code> elements of * the <code>data</code> array are copied. * If the length of the <code>data</code> array is less * than width*height, an <code>IllegalArgumentException</code> is thrown. * The X origin is (width-1)/2 and the Y origin is (height-1)/2. * @param width width of the kernel * @param height height of the kernel * @param data kernel data in row major order * @throws IllegalArgumentException if the length of <code>data</code> * is less than the product of <code>width</code> and * <code>height</code> */ public Kernel(int width, int height, float data[]) { this.width = width; this.height = height; this.xOrigin = (width-1)>>1; this.yOrigin = (height-1)>>1; int len = width*height; if (data.length < len) { throw new IllegalArgumentException("Data array too small "+ "(is "+data.length+ " and should be "+len); } this.data = new float[len]; System.arraycopy(data, 0, this.data, 0, len); } /** * Returns the X origin of this <code>Kernel</code>. * @return the X origin. */ final public int getXOrigin(){ return xOrigin; } /** * Returns the Y origin of this <code>Kernel</code>. * @return the Y origin. */ final public int getYOrigin() { return yOrigin; } /** * Returns the width of this <code>Kernel</code>. * @return the width of this <code>Kernel</code>. */ final public int getWidth() { return width; } /** * Returns the height of this <code>Kernel</code>. * @return the height of this <code>Kernel</code>. */ final public int getHeight() { return height; } /** * Returns the kernel data in row major order. * The <code>data</code> array is returned. If <code>data</code> * is <code>null</code>, a new array is allocated. * @param data if non-null, contains the returned kernel data * @return the <code>data</code> array containing the kernel data * in row major order or, if <code>data</code> is * <code>null</code>, a newly allocated array containing * the kernel data in row major order * @throws IllegalArgumentException if <code>data</code> is less * than the size of this <code>Kernel</code> */ final public float[] getKernelData(float[] data) { if (data == null) { data = new float[this.data.length]; } else if (data.length < this.data.length) { throw new IllegalArgumentException("Data array too small "+ "(should be "+this.data.length+ " but is "+ data.length+" )"); } System.arraycopy(this.data, 0, data, 0, this.data.length); return data; } /** * Clones this object. * @return a clone of this object. */ public Object clone() { try { return super.clone(); } catch (CloneNotSupportedException e) { // this shouldn't happen, since we are Cloneable throw new InternalError(); } } }