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
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
|
/*
* $RCSfile$
*
* Copyright (c) 2004 Sun Microsystems, Inc. All rights reserved.
*
* Use is subject to license terms.
*
* $Revision$
* $Date$
* $State$
*/
package javax.vecmath;
import java.lang.Math;
/**
* A four byte tuple. Note that Java defines a byte as a signed integer
* in the range [-128, 127]. However, colors are more typically
* represented by values in the range [0, 255]. Java 3D recognizes this
* and, in those cases where Tuple4b is used to represent color, treats
* the bytes as if the range were [0, 255]---in other words, as if the
* bytes were unsigned.
* Values greater than 127 can be assigned to a byte variable using a
* type cast. For example:
* <ul>byteVariable = (byte) intValue; // intValue can be > 127</ul>
* If intValue is greater than 127, then byteVariable will be negative. The
* correct value will be extracted when it is used (by masking off the upper
* bits).
*/
public abstract class Tuple4b implements java.io.Serializable, Cloneable {
static final long serialVersionUID = -8226727741811898211L;
/**
* The first value.
*/
public byte x;
/**
* The second value.
*/
public byte y;
/**
* The third value.
*/
public byte z;
/**
* The fourth value.
*/
public byte w;
/**
* Constructs and initializes a Tuple4b from the specified four values.
* @param b1 the first value
* @param b2 the second value
* @param b3 the third value
* @param b4 the fourth value
*/
public Tuple4b(byte b1, byte b2, byte b3, byte b4)
{
this.x = b1;
this.y = b2;
this.z = b3;
this.w = b4;
}
/**
* Constructs and initializes a Tuple4b from the array of length 4.
* @param t the array of length 4 containing b1 b2 b3 b4 in order
*/
public Tuple4b(byte[] t)
{
this.x = t[0];
this.y = t[1];
this.z = t[2];
this.w = t[3];
}
/**
* Constructs and initializes a Tuple4b from the specified Tuple4b.
* @param t1 the Tuple4b containing the initialization x y z w data
*/
public Tuple4b(Tuple4b t1)
{
this.x = t1.x;
this.y = t1.y;
this.z = t1.z;
this.w = t1.w;
}
/**
* Constructs and initializes a Tuple4b to (0,0,0,0).
*/
public Tuple4b()
{
this.x = (byte) 0;
this.y = (byte) 0;
this.z = (byte) 0;
this.w = (byte) 0;
}
/**
* Returns a string that contains the values of this Tuple4b.
* @return the String representation
*/
public String toString()
{
return("(" + ((int)this.x & 0xff) +
", " + ((int)this.y & 0xff) +
", " + ((int)this.z & 0xff) +
", " + ((int)this.w & 0xff) + ")");
}
/**
* Places the value of the x,y,z,w components of this Tuple4b
* into the array of length 4.
* @param b array of length 4 into which the values are placed
*/
public final void get(byte[] b)
{
b[0] = this.x;
b[1] = this.y;
b[2] = this.z;
b[3] = this.w;
}
/**
* Places the value of the x,y,z,w components of this
* Tuple4b into the tuple t1.
* @param t1 tuple into which the values are placed
*/
public final void get(Tuple4b t1)
{
t1.x = this.x;
t1.y = this.y;
t1.z = this.z;
t1.w = this.w;
}
/**
* Sets the value of the data members of this tuple to the value
* of the argument tuple t1.
* @param t1 the source tuple
*/
public final void set(Tuple4b t1)
{
this.x = t1.x;
this.y = t1.y;
this.z = t1.z;
this.w = t1.w;
}
/**
* Sets the value of the data members of this tuple to the value
* of the array b of length 4.
* @param b the source array of length 4
*/
public final void set(byte[] b)
{
this.x = b[0];
this.y = b[1];
this.z = b[2];
this.w = b[3];
}
/**
* Returns true if all of the data members of tuple t1 are equal to
* the corresponding data members in this tuple.
* @param t1 the tuple with which the comparison is made
*/
public boolean equals(Tuple4b t1)
{
try {
return(this.x == t1.x && this.y == t1.y &&
this.z == t1.z && this.w == t1.w);
}
catch (NullPointerException e2) {return false;}
}
/**
* Returns true if the Object t1 is of type Tuple4b and all of the
* data members of t1 are equal to the corresponding data members in
* this Tuple4b.
* @param t1 the object with which the comparison is made
*/
public boolean equals(Object t1)
{
try {
Tuple4b t2 = (Tuple4b) t1;
return(this.x == t2.x && this.y == t2.y &&
this.z == t2.z && this.w == t2.w);
}
catch (NullPointerException e2) {return false;}
catch (ClassCastException e1) {return false;}
}
/**
* Returns a hash code value based on the data values in this
* object. Two different Tuple4b objects with identical data values
* (i.e., Tuple4b.equals returns true) will return the same hash
* code value. Two objects with different data members may return the
* same hash value, although this is not likely.
* @return the integer hash code value
*/
public int hashCode() {
return ((((int)x & 0xff) << 0) |
(((int)y & 0xff) << 8) |
(((int)z & 0xff) << 16) |
(((int)w & 0xff) << 24));
}
/**
* Creates a new object of the same class as this object.
*
* @return a clone of this instance.
* @exception OutOfMemoryError if there is not enough memory.
* @see java.lang.Cloneable
* @since Java 3D 1.3
*/
public Object clone() {
// Since there are no arrays we can just use Object.clone()
try {
return super.clone();
} catch (CloneNotSupportedException e) {
// this shouldn't happen, since we are Cloneable
throw new InternalError();
}
}
}
|
