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
|
/*
* Copyright 2001-2008 Sun Microsystems, Inc. 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. Sun designates this
* particular file as subject to the "Classpath" exception as provided
* by Sun 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 Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
* CA 95054 USA or visit www.sun.com if you need additional information or
* have any questions.
*
*/
package javax.media.j3d;
import java.nio.Buffer;
import java.nio.ByteBuffer;
import java.nio.ByteOrder;
import java.nio.CharBuffer;
import java.nio.DoubleBuffer;
import java.nio.FloatBuffer;
import java.nio.IntBuffer;
import java.nio.LongBuffer;
import java.nio.ShortBuffer;
/**
* Java 3D wrapper class for java.nio.Buffer objects.
* When used to wrap a non-null NIO buffer object, this class will
* create a read-only view of the wrapped NIO buffer, and will call
* <code>rewind</code> on the read-only view, so that elements 0
* through <code>buffer.limit()-1</code> will be available internally.
*
* @see GeometryArray#setCoordRefBuffer(J3DBuffer)
* @see GeometryArray#setColorRefBuffer(J3DBuffer)
* @see GeometryArray#setNormalRefBuffer(J3DBuffer)
* @see GeometryArray#setTexCoordRefBuffer(int,J3DBuffer)
* @see GeometryArray#setVertexAttrRefBuffer(int,J3DBuffer)
* @see GeometryArray#setInterleavedVertexBuffer(J3DBuffer)
* @see CompressedGeometry#CompressedGeometry(CompressedGeometryHeader,J3DBuffer)
*
* @since Java 3D 1.3
*/
public class J3DBuffer {
enum Type {
NULL,
UNKNOWN,
BYTE,
CHAR,
SHORT,
INT,
LONG,
FLOAT,
DOUBLE,
}
private Buffer originalBuffer = null;
private Buffer readonlyBuffer = null;
Type bufferType = Type.NULL;
/**
* Constructs a J3DBuffer object and initializes it with
* a null NIO buffer object. The NIO buffer object
* must be set to a non-null value before using this J3DBuffer
* object in a Java 3D node component.
*
* @exception UnsupportedOperationException if the JVM does not
* support native access to direct NIO buffers
*/
public J3DBuffer() {
this(null);
}
/**
* Constructs a J3DBuffer object and initializes it with
* the specified NIO buffer object.
*
* @param buffer the NIO buffer wrapped by this J3DBuffer
*
* @exception UnsupportedOperationException if the JVM does not
* support native access to direct NIO buffers
*
* @exception IllegalArgumentException if the specified buffer is
* not a direct buffer, or if the byte order of the specified
* buffer does not match the native byte order of the underlying
* platform.
*/
public J3DBuffer(Buffer buffer) {
setBuffer(buffer);
}
/**
* Sets the NIO buffer object in this J3DBuffer to
* the specified object.
*
* @param buffer the NIO buffer wrapped by this J3DBuffer
*
* @exception IllegalArgumentException if the specified buffer is
* not a direct buffer, or if the byte order of the specified
* buffer does not match the native byte order of the underlying
* platform.
*/
public void setBuffer(Buffer buffer) {
Type bType = Type.NULL;
boolean direct = false;
ByteOrder order = ByteOrder.BIG_ENDIAN;
if (buffer == null) {
bType = Type.NULL;
}
else if (buffer instanceof ByteBuffer) {
bType = Type.BYTE;
direct = ((ByteBuffer)buffer).isDirect();
order = ((ByteBuffer)buffer).order();
}
else if (buffer instanceof CharBuffer) {
bType = Type.CHAR;
direct = ((CharBuffer)buffer).isDirect();
order = ((CharBuffer)buffer).order();
}
else if (buffer instanceof ShortBuffer) {
bType = Type.SHORT;
direct = ((ShortBuffer)buffer).isDirect();
order = ((ShortBuffer)buffer).order();
}
else if (buffer instanceof IntBuffer) {
bType = Type.INT;
direct = ((IntBuffer)buffer).isDirect();
order = ((IntBuffer)buffer).order();
}
else if (buffer instanceof LongBuffer) {
bType = Type.LONG;
direct = ((LongBuffer)buffer).isDirect();
order = ((LongBuffer)buffer).order();
}
else if (buffer instanceof FloatBuffer) {
bType = Type.FLOAT;
direct = ((FloatBuffer)buffer).isDirect();
order = ((FloatBuffer)buffer).order();
}
else if (buffer instanceof DoubleBuffer) {
bType = Type.DOUBLE;
direct = ((DoubleBuffer)buffer).isDirect();
order = ((DoubleBuffer)buffer).order();
}
else {
bType = Type.UNKNOWN;
}
// Verify that the buffer is direct and has the correct byte order
if (buffer != null) {
if (!direct) {
throw new IllegalArgumentException(J3dI18N.getString("J3DBuffer1"));
}
if (order != ByteOrder.nativeOrder()) {
throw new IllegalArgumentException(J3dI18N.getString("J3DBuffer2"));
}
}
bufferType = bType;
originalBuffer = buffer;
// Make a read-only view of the buffer if the type is one
// of the internally supported types: byte, float, or double
switch (bufferType) {
case BYTE:
ByteBuffer byteBuffer = ((ByteBuffer)buffer).asReadOnlyBuffer();
byteBuffer.rewind();
readonlyBuffer = byteBuffer;
break;
case FLOAT:
FloatBuffer floatBuffer = ((FloatBuffer)buffer).asReadOnlyBuffer();
floatBuffer.rewind();
readonlyBuffer = floatBuffer;
break;
case DOUBLE:
DoubleBuffer doubleBuffer = ((DoubleBuffer)buffer).asReadOnlyBuffer();
doubleBuffer.rewind();
readonlyBuffer = doubleBuffer;
break;
default:
readonlyBuffer = null;
}
}
/**
* Retrieves the NIO buffer object from this J3DBuffer.
*
* @return the current NIO buffer wrapped by this J3DBuffer
*/
public Buffer getBuffer() {
return originalBuffer;
}
/**
* Gets the readonly view of the nio buffer we wrapped with J3DBuffer
* @return
*/
Buffer getROBuffer() {
return readonlyBuffer;
}
}
|
