forked from openjdk/jdk
-
Notifications
You must be signed in to change notification settings - Fork 0
Expand file tree
/
Copy pathKernel.java
More file actions
153 lines (140 loc) · 5.25 KB
/
Copy pathKernel.java
File metadata and controls
153 lines (140 loc) · 5.25 KB
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
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
/*
* Copyright (c) 1997, 2018, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
* under the terms of the GNU General Public License version 2 only, as
* published by the Free Software Foundation. Oracle designates this
* particular file as subject to the "Classpath" exception as provided
* by Oracle in the LICENSE file that accompanied this code.
*
* This code is distributed in the hope that it will be useful, but WITHOUT
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
* FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
* version 2 for more details (a copy is included in the LICENSE file that
* accompanied this code).
*
* You should have received a copy of the GNU General Public License version
* 2 along with this work; if not, write to the Free Software Foundation,
* Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
*
* Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
* or visit www.oracle.com if you need additional information or have any
* questions.
*/
package java.awt.image;
/**
* The {@code 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 ConvolveOp
*/
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} object from an array of floats.
* The first {@code width}*{@code height} elements of
* the {@code data} array are copied.
* If the length of the {@code data} array is less
* than width*height, an {@code IllegalArgumentException} 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}
* is less than the product of {@code width} and
* {@code height}
*/
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}.
* @return the X origin.
*/
public final int getXOrigin(){
return xOrigin;
}
/**
* Returns the Y origin of this {@code Kernel}.
* @return the Y origin.
*/
public final int getYOrigin() {
return yOrigin;
}
/**
* Returns the width of this {@code Kernel}.
* @return the width of this {@code Kernel}.
*/
public final int getWidth() {
return width;
}
/**
* Returns the height of this {@code Kernel}.
* @return the height of this {@code Kernel}.
*/
public final int getHeight() {
return height;
}
/**
* Returns the kernel data in row major order.
* The {@code data} array is returned. If {@code data}
* is {@code null}, a new array is allocated.
* @param data if non-null, contains the returned kernel data
* @return the {@code data} array containing the kernel data
* in row major order or, if {@code data} is
* {@code null}, a newly allocated array containing
* the kernel data in row major order
* @throws IllegalArgumentException if {@code data} is less
* than the size of this {@code Kernel}
*/
public final 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(e);
}
}
}